# 掌握 GitHub 集成此技能提供了使用 gh CLI、GitHub REST 和 GraphQL API 以及 GitHub Actions 与 GitHub 集成的全面指导。对于自动化问题管理、PR 工作流程、使用 GitHub 项目进行冲刺规划以及构建强大的基于 GitHub 的开发管道至关重要。 ## 何时使用此技能 * 自动问题创建、更新和转换 * 建立公关管理工作流程 * 解析 GitHub URL 并提取元数据 * 将 GitHub 集成到开发自动化中 * 使用 GitHub 项目进行 Sprint 规划 * 创建 GitHub Actions 工作流程 * 以编程方式查询 GitHub 数据 ** ** ## GitHub CLI (gh) 掌握 “gh” CLI 是 GitHub 自动化的主要工具。它为所有 GitHub 操作提供直观的命令。 ### 安装和身份验证 # 安装 gh CLI (macOS) 酿造安装gh # 验证 gh 验证登录 # 验证身份验证 gh 身份验证状态 ### 问题操作 **列出过滤器的问题**： # 列出未解决的问题 gh 问题列表 # 按标签列出 gh 问题列表 --label bug --label 高优先级 # 分配给您的列表 gh 问题列表--受让人@me # 列出特定状态 gh 问题列表 -- 状态已关闭 **查看问题详细信息**： # 查看第 123 期 gh 问题视图 123 # 查看评论 gh 问题视图 123 --comments # 以 JSON 形式查看以进行编程访问 gh 问题视图 123 --json 编号、标题、正文、标签、受让人 **创建问题**： # 互动创作 gh 问题创建 # 带标志 gh issues create --title "Bug: 登录失败" --body "此处描述" --label bug # 来自模板 gh 问题创建 --template bug_report.md **编辑问题**： # 添加标签 gh 问题编辑 123 --add-label“进行中” # 分配 gh 问题编辑 123 --add-受让人用户名 # 设置里程碑 gh 问题编辑 123 --里程碑“Sprint 24” # 更新标题 gh issues edit 123 --title “更新的标题” **关闭问题**： # 以评论结束 gh 问题关闭 123 --comment “已在 PR #456 中修复” ### 拉取请求操作 **创建公关**： # 互动创作 gh 公关创建 # 有详细信息 gh pr create --title "feat: 添加身份验证" --body "实现详细信息" --base main # 公关草案 gh pr 创建--草稿 # 根据提交自动填充 gh pr 创建--填充 **列出并查看 PR** ： # 列出开放的 PR gh 公关列表 # 按作者列出 gh 公关列表 --作者@me # 查看公关详情 gh 公关视图 456 # 查看公关差异 gh 公关差异 456 # 查看 PR 检查 gh 公关检查 456 **审查 PR** ： # 批准公关 gh 公关审查 456 --批准 # 请求更改 gh pr review 456 --request-changes --body“请修复测试” # 公关评论 gh 公关评论 456 --body“LGTM！” **合并 PR** : # 与南瓜合并 gh pr 合并 456 --squash # 与变基合并 gh pr 合并 456 --rebase # 检查通过后自动合并 gh pr 合并 456 --auto --squash ### GitHub 项目集成 **列出项目**： # 列出组织项目 gh 项目列表 --所有者组织名称 # 列出用户项目 gh 项目列表 --owner @me **将项目添加到项目**： # 将问题添加到项目中 gh 项目项-添加 PROJECT_ID --所有者组织名称 --url https://github.com/org/repo/issues/123 # 将 PR 添加到项目中 gh 项目项-添加 PROJECT_ID --所有者组织名称 --url https://github.com/org/repo/pull/456 ### 高级 CLI 模式 **常用操作的别名**： # 在 ~/.config/gh/config.yml 中创建别名 gh 别名设置 issues-ready '问题列表 --label sprint-ready --json 编号，标题' gh 别名设置 prs-mine 'pr list --author @me --json number,title,updatedAt' # 使用别名 gh 问题就绪 **输出格式**： # 用于脚本编写的 JSON 输出 gh 问题列表 --json 编号、标题、标签 # 模板格式设置 gh pr list --json number,title --template '{{range .}}{{.number}}: {{.title}}{{"\n"}}{{end}}' 有关结合 gh 命令的完整 shell 脚本示例，请参阅“examples/gh-cli-scripts.md”。 ** ** ## GitHub API 模式 ### REST API 基础知识 **身份验证**： // 使用 Octokit 从'@octokit/rest'导入{Octokit}； const octokit = 新 Octokit({ 身份验证：process.env.GITHUB_TOKEN }); **速率限制**： // 检查速率限制状态 const { 数据：rateLimit } =等待 octokit.rateLimit.get(); console.log(`剩余：${rateLimit.rate.remaining}/${rateLimit.rate.limit}`); console.log(`重置于：${new Date(rateLimit.rate.reset * 1000)}`); ### 常见 REST API 操作 **问题操作**： // 获取问题 const { 数据：问题 } = 等待 octokit.issues.get({ 所有者：'组织名称'， repo: 'repo-name', 问题编号：123 }); // 创建问题 const { 数据：newIssue } = 等待 octokit.issues.create({ 所有者：'组织名称'， repo: 'repo-name', title: '错误：登录失败', body: '问题描述', 标签：['错误'，'高优先级']，受让人：['用户名'] }); // 更新问题等待 octokit.issues.update({ 所有者：'组织名称'， repo: 'repo-name', 问题编号：123，状态：“关闭”，标签：['错误'，'已修复'] }); // 添加评论等待 octokit.issues.createComment({ 所有者：'组织名称'， repo: 'repo-name', 问题编号：123， body: '这已在 PR #456 中修复' }); **公关运作**： // 获取公关 const { data: pr } = wait octokit.pulls.get({ 所有者：'组织名称'， repo: 'repo-name', 拉数：456 }); // 列出 PR 评论 const { 数据：评论 } =等待 octokit.pulls.listReviews({ 所有者：'组织名称'， repo: 'repo-name', 拉数：456 }); // 合并PR 等待 octokit.pulls.merge({ 所有者：'组织名称'， repo: 'repo-name', 拉数：456， merge_method: '挤压', commit_title: '壮举：添加身份验证', commit_message: '关闭 #123' }); **存储库操作**： // 列出存储库 const { data: repos } = wait octokit.repos.listForOrg({ 组织：'组织名称'，类型：'全部'，排序：“已更新” }); // 获取存储库详细信息 const { data: repo } = wait octokit.repos.get({ 所有者：'组织名称'，回购：'回购名称' }); // 创建网络钩子等待 octokit.repos.createWebhook({ 所有者：'组织名称'， repo: 'repo-name', 配置：{ url: 'https://example.com/webhook', 内容类型：'json' }, 事件：['问题'，'pull_request'] }); ### GraphQL API **何时使用 GraphQL** ： * 获取嵌套数据（问题+评论+反应） * 减少API调用（一次请求获取多个资源） * 自定义字段选择（仅获取您需要的内容） * 跨存储库的复杂查询 **基本 GraphQL 查询**：从“@octokit/graphql”导入{graphql}； const graphqlWithAuth = graphql.defaults({ 标题：{ 授权：`令牌${process.env.GITHUB_TOKEN}` } }); // 获取带有评论的问题 const 结果 = 等待 graphqlWithAuth(` 查询($owner: String!, $repo: String!, $number: Int!) { 存储库（所有者：$owner，名称：$repo）{ 问题（编号：$编号）{ 标题身体状态标签（第一个：10）{ 节点{ 姓名 } } 评论（第一：50）{ 节点{ 作者{ 登录 } 身体创建于 } } } } } `，{ 所有者：'组织名称'， repo: 'repo-name', 数量：123 }); **使用 GraphQL 分页**： // 获取所有分页问题常量问题= []；让 hasNextPage = true; 让光标=空； while (有下一页) { const 结果 = 等待 graphqlWithAuth(` 查询（$owner：字符串！，$repo：字符串！，$cursor：字符串）{ 存储库（所有者：$owner，名称：$repo）{ 问题（第一个：100，之后：$cursor，状态：OPEN）{ 页面信息{ 有下一页结束光标 } 节点{ 数量标题状态 } } } } `，{ 所有者：'组织名称'， repo: 'repo-name', 光标 }); issues.push(...result.repository.issues.nodes); hasNextPage = result.repository.issues.pageInfo.hasNextPage; 光标 = result.repository.issues.pageInfo.endCursor; } ### API 最佳实践 **错误处理**： // ✅ 好：处理速率限制和错误异步函数 safeApiCall(apiCall: () => Promise): Promise { 尝试{ 返回等待 apiCall(); } catch（错误：任何）{ if (error.status === 403 && error.message.includes('速率限制')) { const resetTime = new Date(error.response.headers['x-ratelimit-reset'] * 1000); throw new Error(`超出速率限制。在 ${resetTime} 重置`); } if (error.status === 404) { throw new Error('找不到资源'); } 抛出错误； } } // 用法 const 问题 = 等待 safeApiCall(() => octokit.issues.get({ 所有者, 存储库, issues_number: 123 }) ）； **缓存**： // ✅ 好：缓存存储库元数据 const repoCache = new Map(); 异步函数 getRepoWithCache(owner: string, repo: string) { const key = `${owner}/${repo}`; if (repoCache.has(key)) { 返回 repoCache.get(key); } const { data } = wait octokit.repos.get({ 所有者, repo }); repoCache.set（键，数据）；返回数据； } 有关完整的 API 使用示例，请参阅“references/github-api-patterns.md”。 ** ** ## 问题和 PR 检测 ### URL 模式检测 **问题 URL 模式**： // GitHub 问题 URL 模式常量 GITHUB_ISSUE_PATTERNS = [ /https?:\/\/github\.com\/([^\/]+)\/([^\/]+)\/问题\/(\d+)/, /https?:\/\/github\.com\/([^\/]+)\/([^\/]+)\/拉\/(\d+)/, ]; 函数检测GitHubIssue（文本：字符串）：{所有者：字符串；回购协议：字符串；数字：数字 } |空{ for (GITHUB_ISSUE_PATTERNS 的 const 模式) { const match = text.match(pattern); 如果（匹配）{ 返回{ 所有者：匹配[1]，回购：匹配[2]，数字：parseInt(match[3], 10) }; } } 返回空值； } // 用法 const issues = detectorGitHubIssue('修复 https://github.com/org/repo/issues/123'); // => { 所有者: 'org', 仓库: 'repo', 编号: 123 } **问题编号参考**： // 检测文本中的问题引用 const ISSUE_REF_PATTERN = /#(\d+)/g; 函数 extractIssueNumbers(text: string): number[] { const matches = text.matchAll(ISSUE_REF_PATTERN); return Array.from(matches, m => parseInt(m[1], 10)); } // 用法 const Numbers = extractIssueNumbers('修复 #123 并关闭 #456'); // => [123, 456] ### 自动链接策略 // ✅ 好：获取问题详细信息以进行自动链接异步函数丰富WithIssueData（文本：字符串，所有者：字符串，回购：字符串）{ const 数字 = extractIssueNumbers(text); const issues = 等待 Promise.all( Numbers.map(num => octokit.issues.get({ 所有者, repo, issues_number: num })) ）；让丰富=文本； issues.forEach(({ 数据 }, 索引) => { const num = 数字[索引]; 丰富=丰富.替换（ `#${num}`, `[#${num}](https://github.com/${owner}/${repo}/issues/${num}) (${data.title})` ）； }); 回报丰富； } ### 元数据提取 // 提取全面的问题元数据接口问题元数据{ 网址：字符串；所有者：字符串；回购协议：字符串；数量：数量；类型：'问题' | '公关'；标题？：字符串；状态？：字符串；标签？：字符串[]； } 异步函数 extractIssueMetadata(url: string): Promise { const 检测到 = detectorGitHubIssue(url); 如果（！检测到）返回null； const { 所有者、仓库、编号 } = 检测到； const 类型 = url.includes('/pull/') ？ 'pr' : '问题'; 尝试{ const { 数据 } = 类型 === 'pr' ？等待 octokit.pulls.get({ 所有者, repo, pull_number: number }) :等待 octokit.issues.get({ 所有者, repo, issues_number: number }); 返回{ 网址，业主, 回购协议，数量，类型，标题：数据.标题，状态：数据.状态，标签： data.labels?.map((l: any) => l.name) || [] }; } 捕获（错误）{ // 如果获取失败则返回部分元数据 return { url, 所有者, 仓库, 数量, 类型 }; } } 有关完整的问题检测模式，请参阅“examples/issue-detection-patterns.md”。 ** ** ## GitHub 操作集成 ### 工作流程触发器 **常见触发模式**： # 推送到主程序时触发于：推：分支：[主要] # PR 事件触发于：拉请求：类型：[打开、同步、重新打开] # 触发问题事件于：问题：类型：[打开，贴标签] # 多个触发器于：推：分支：[主要] 拉请求：分支：[主要] workflow_dispatch: # 手动触发 ### 在操作中使用 gh CLI 名称：自动标记 PR 于：拉请求：类型：[已打开] 职位：标签：运行：ubuntu-latest 步骤： - 名称：根据更改的文件标记 PR 环境： GH_TOKEN：${{secrets.GITHUB_TOKEN}} 运行： | # 获取更改的文件 FILES=$(gh pr 查看 ${{ github.event.pull_request.number }} --json 文件 --jq '.files[].path') # 根据文件模式添加标签如果回显“$FILES” | grep -q "\.ts$";然后 gh pr 编辑 ${{ github.event.pull_request.number }} --add-label "typescript" 菲如果回显“$FILES” | grep -q "\.test\.ts$";然后 gh pr 编辑 ${{ github.event.pull_request.number }} --add-label“测试” 菲 ### 常见工作流程模式 **自动分配审阅者**：名称：自动分配审阅者于：拉请求：类型：[已打开] 职位：分配：运行：ubuntu-latest 步骤： - 名称：分配团队成员环境： GH_TOKEN：${{secrets.GITHUB_TOKEN}} 运行： | gh pr 编辑 ${{ github.event.pull_request.number }} \ --add-reviewer 团队负责人 \ --add-reviewer 高级开发人员 **将 PR 链接到问题**：名称：链接 PR 到问题于：拉请求：类型：[已打开] 职位：链接：运行：ubuntu-latest 步骤： - 名称：从 PR 标题中提取问题编号 id: 提取运行： | TITLE="${{ github.event.pull_request.title }}" ISSUE_NUM=$(echo "$TITLE" | grep -oP '#\K\d+' | head -1) echo "issue_number=$ISSUE_NUM" >> $GITHUB_OUTPUT - 名称：对链接问题的评论如果：steps.extract.outputs.issue_number != '' 环境： GH_TOKEN：${{secrets.GITHUB_TOKEN}} 运行： | gh 问题评论 ${{ steps.extract.outputs.issue_number }} \ --body "PR #${{ github.event.pull_request.number }} 已创建来解决此问题" 有关完整的 GitHub Actions 集成示例，请参阅“references/github-actions-integration.md”。 ** ** ## 使用 GitHub 项目进行 Sprint 规划 ### 项目板设置 **创建项目板**： # 使用 gh CLI（需要 gh 项目扩展） gh 项目创建 --owner 组织名称 --title "Sprint 24" --format board # 或者通过 Web UI https://github.com/orgs/org-name/projects **配置板栏**： * 积压订单 * 冲刺准备就绪 * 进行中 * 审查中 * 完成 ### 冲刺工作流程 **开始冲刺**： 1. 为冲刺创建里程碑 gh api repos/org-name/repo-name/milestones -f title="Sprint 24" -f due_on="2024-01-15T00:00:00Z" 2. 将问题标记为冲刺就绪 gh 问题编辑 123 --add-label“sprint-ready” 3. 为选定的问题分配里程碑 gh 问题编辑 123 --里程碑“Sprint 24” **跟踪进度**： # 查看冲刺问题 gh 问题列表 --milestone "Sprint 24" --json 编号、标题、状态、受让人 # 按受让人查看 gh 问题列表 --milestone "Sprint 24" --受让人用户名 **冲刺指标**： // 计算冲刺速度接口 SprintMetrics { 总计：数量；已完成：数量；进行中：数量；速度：数字； } 异步函数 getSprintMetrics(milestone: string): Promise { const { 数据：问题 } = 等待 octokit.issues.listForRepo({ 所有者：'组织名称'， repo: 'repo-name', 里程碑，状态：“全部” }); const Completed = issues.filter(i => i.state === '已关闭').length; 常量 in_progress = issues.filter(i => i.state === '打开' && i.labels.some(l => l.name === '进行中') ).长度；返回{ 总计：问题.长度，已完成，进行中，速度：（已完成/问题.长度）* 100 }; } ** ** ## 标签和里程碑管理 ### 标签策略 **标准标签组**：常量 STANDARD_LABELS = [ { name: 'bug', color: 'd73a4a', description: '有些东西不工作' }, { name: 'feature', color: 'a2eeef', description: '新功能或请求' }, { name: 'enhancement', color: '84b6eb', description: '现有功能的改进' }, { name: '文档', color: '0075ca', description: '文档更新' }, { name: '高优先级', color: 'ff0000', description: '紧急问题' }, { name: 'sprint-ready', color: '00ff00', description: '准备好冲刺计划' }, { name: '进行中', color: 'fbca04', description: '当前正在处理' }, { name: 'needs-review', color: 'c2e0c6', description: '等待代码审查' } ]; // 创建标签 for (STANDARD_LABELS 的常量标签) { 等待 octokit.issues.createLabel({ 所有者：'组织名称'， repo: 'repo-name', ...标签 }); } ### 里程碑模式 **创建具有截止日期的里程碑**： const { 数据：里程碑 } = 等待 octokit.issues.createMilestone({ 所有者：'组织名称'， repo: 'repo-name', 标题：“冲刺24”，描述：“2024 年第一季度 Sprint 24”， due_on: '2024-01-15T00:00:00Z', 状态：“打开” }); **批量分配给里程碑**： const 问题编号 = [123, 124, 125, 126]; 等待 Promise.all( issuesNumbers.map(数字 => octokit.issues.update({ 所有者：'组织名称'， repo: 'repo-name', 问题编号：编号，里程碑：里程碑.编号 }) ））； ** ** ## 多位专家公关评论当多个专家协作开发某个功能时，创建全面的公关评论来记录每个专家的贡献。 ### 多专家检测 **检查移交目录**：从'fs'导入{existsSync，readdirSync}；从“路径”导入{加入}；接口多专家上下文{ isMultiSpecialist: 布尔值；专家？：字符串[]； handoffDir？：字符串； handoffFiles?: 字符串[]; } 函数 detectorMultiSpecialistWork(featureName: string): MultiSpecialistContext { const handoffDir = join(process.cwd(), '.agency', 'handoff', featureName); if (!existsSync(handoffDir)) { 返回 { isMultiSpecialist: false }; } const 文件 = readdirSync(handoffDir); const summaryFiles = files.filter(f => f.endsWith('-summary.md')); // 从摘要文件中提取专家姓名 const 专家 = summaryFiles.map(f => { // 删除 '-summary.md' 并转换为标题大小写 const name = f.replace('-summary.md', '').replace(/-/g, ' '); return name.split(' ').map(w => w.charAt(0).toUpperCase() + w.slice(1) ).join(' '); }); 返回{ isMultiSpecialist：正确，专家，交接目录， handoffFiles: 摘要文件 }; } // 用法 const context = detectorMultiSpecialistWork('用户身份验证'); if (context.isMultiSpecialist) { console.log(`检测到多专家工作：${context.specialists?.join(', ')}`); } ### 单专家公关评论模板 **单一专家的标准公关评论**： ## 实施总结 **专家**：前端开发人员 ### 所做的更改 - 实现了用户身份验证 UI - 添加了登录和注册表单 - 创建受保护的路线组件 - 与后端身份验证 API 集成 ### 文件已更改 **总计**：8 个文件（+245，-12） **关键文件**： -`src/components/auth/LoginForm.tsx`（+89，-0） -`src/components/auth/RegisterForm.tsx`（+76，-0） -`src/hooks/useAuth.ts`（+45，-8） - `src/pages/ProfilePage.tsx` (+35, -4) ### 测试结果 ✅ 所有测试均通过（18/18） **测试覆盖率**： - 单元测试：12 次通过 - 集成测试：6 次通过 - E2E测试：手动验证 ### 验证 - [x] 代码构建没有错误 - [x] 所有测试均通过 - [x] 应用了 Linting 和格式 - [x] 没有控制台错误或警告 - [x] 在开发环境中测试 **准备审查** 🚀 **单一专家评论的 TypeScript 示例**：接口文件更改{ 路径：字符串；补充：数量；删除：数量； } 接口测试结果{ 总计：数量；通过：数量；失败：数量；类别？：{ 名称：字符串；计数：数量 }[]; } 函数生成SingleSpecialistComment（专家：字符串，摘要：字符串，更改：文件更改[]，测试：测试结果 ): 字符串 { consttotalFiles=changes.length； consttotalAdditions=changes.reduce((sum,c)=>sum+c.additions,0); const TotalDeletions =changes.reduce((sum, c) => sum + c.deletions, 0); const keyFiles = 更改 .sort((a, b) => (b.添加 + b.删除) - (a.添加 + a.删除)) .切片(0, 5) .map(c => `- \`${c.path}\` (+${c.additions}, -${c.deletions})`) .join('\n'); const testStatus =tests.passing ===tests.total ？ '✅' : '⚠️'; return `## 实现总结 **专家**：${专家} ### 所做的更改 ${摘要} ### 文件已更改 **总计**：${totalFiles} 个文件（+${totalAdditions}、-${totalDeletions}） **关键文件**： ${密钥文件} ### 测试结果 ${testStatus} 测试：${tests.passing}/${tests.total} 通过 ${tests.categories?.map(c => `- ${c.name}: ${c.count} 通过`).join('\n') || ''} ### 验证 - [x] 代码构建没有错误 - [x] 所有测试均通过 - [x] 应用了 Linting 和格式 - [x] 没有控制台错误或警告 - [x] 在开发环境中测试 **准备审查** 🚀`； } ### 多专家公关评论模板 **综合多专家评论**： ## 🚀 多专家实施此 PR 代表了多个专家针对 **用户身份验证** 功能的协作工作。 **参与专家**：后端架构师、前端开发人员 --- <详情>

后端架构师总结

### 工作已完成 - 实施 REST API 身份验证端点 - 添加了 JWT 令牌生成和验证 - 为用户表创建数据库迁移 - 集成 bcrypt 密码哈希 - 添加了基于角色的访问控制中间件 ### 文件已更改 **总计**：12 个文件（+567，-89） **主要变化**： - `src/api/auth/routes.ts` (+124, -0) - 身份验证路由 - `src/api/auth/controller.ts` (+98, -0) - 身份验证业务逻辑 - `src/middleware/auth.ts` (+76, -12) - JWT 验证中间件 - `src/models/User.ts` (+89, -34) - 带有授权字段的用户模型 - `migrations/002_add_auth_tables.sql` (+67, -0) - 数据库模式 ### 测试结果 ✅ 所有测试均通过（24/24） - 单元测试：16 项通过 - 集成测试：8 次通过 - API端点覆盖率：100% ### 交接笔记 [查看详细的交接摘要](.agency/handoff/user-authentication/backend-architect-summary.md) **整合点**： - JWT 令牌在“/api/auth/login”响应中返回 - 通过“Authorization: Bearer ”标头进行令牌验证 - auth 中间件后“req.user.role”中可用的用户角色 <详情>

前端开发人员摘要

### 工作已完成 - 内置登录和注册表单组件 - 实施客户端身份验证状态管理 - 创建受保护的路线组件 - 添加了令牌存储和刷新逻辑 - 与后端身份验证 API 集成 ### 文件已更改 **总计**：8 个文件（+245，-12） **主要变化**： - `src/components/auth/LoginForm.tsx` (+89, -0) - 登录 UI - `src/components/auth/RegisterForm.tsx` (+76, -0) - 注册 UI - `src/hooks/useAuth.ts` (+45, -8) - 身份验证状态挂钩 - `src/context/AuthContext.tsx` (+35, -4) - 全局身份验证上下文 ### 测试结果 ✅ 所有测试均通过（18/18） - 组件测试：10 次通过钩子测试：4次通过 - 集成测试：4 次通过 ### 交接笔记 [查看详细的交接摘要](.agency/handoff/user-authentication/frontend-developer-summary.md) **整合点**： - 使用“/api/auth/login”和“/api/auth/register”端点 - 将 JWT 存储在 localStorage 中并具有自动刷新功能 - 未经身份验证时，受保护的路由重定向到“/login” --- ### 整体状况 ✅ **所有专家都已完成并验证了他们的工作** **总更改**：20 个文件（+812，-101） **总测试**：42/42 通过 (100%) **集成验证**： - [x] 后端 API 功能齐全 - [x] 前端成功消费后端 - [x] 端到端身份验证流程工作 - [x] 令牌刷新机制可操作 - [x] 受保护的路由强制执行身份验证 - [x] 所有测试都通过两层 **准备审查** 🎉 **多专家评论的 TypeScript 示例**：接口专家工作{ 名称：字符串；摘要：字符串；文件：FileChange[]；测试：测试结果； handoffFile：字符串；积分点：字符串[]； } 异步函数generateMultiSpecialistComment( 特征名称：字符串，专家：SpecialistWork[] ): 承诺<字符串> { const TotalFiles = professionals.reduce((sum, s) => sum + s.files.length, 0); const TotalAdditions = 专家.reduce( (sum, s) => sum + s.files.reduce((s2, f) => s2 + f.additions, 0), 0 ）； const TotalDeletions = professionals.reduce( (sum, s) => sum + s.files.reduce((s2, f) => s2 + f.deletions, 0), 0 ）； const TotalTests = professionals.reduce((sum, s) => sum + s.tests.total, 0); const TotalPassing = professionals.reduce((sum, s) => sum + s.tests.passing, 0); const allTestsPassing =totalTests ===totalPassing; const statusIcon = 所有测试通过？ '✅' : '⚠️'; const professionalSections = professionals.map(s => { const fileCount = s.files.length; const 加法 = s.files.reduce((sum, f) => sum + f.additions, 0); const 删除 = s.files.reduce((sum, f) => sum + f.deletions, 0); const keyFiles = s.files .sort((a, b) => (b.添加 + b.删除) - (a.添加 + a.删除)) .切片(0, 5) .map(f => `- \`${f.path}\` (+${f.additions}, -${f.deletions}) - ${getFileDescription(f.path)}`) .join('\n'); const testStatus = s.tests.passing === s.tests.total ？ '✅' : '⚠️'; const testBreakdown = s.tests.categories ?.map(c => `- ${c.name}: ${c.count} 传递`) .join('\n') || ''; const 积分点 = s.积分点 .map(点 => `- ${point}`) .join('\n'); 返回`<详细信息>

${s.name} 摘要

### 工作已完成 ${s.summary} ### 文件已更改 **总计**：${fileCount} 个文件（+${添加}、-${删除}） **主要变化**： ${密钥文件} ### 测试结果 ${testStatus} 所有测试均通过 (${s.tests.passing}/${s.tests.total}) ${测试分解} ### 交接笔记 [查看详细的交接摘要](${s.handoffFile}) **整合点**： ${积分点} `； }).join('\n\n'); const professionalNames = professionals.map(s => s.name).join(', '); return `## 🚀 多专家实施此 PR 代表了多个专家针对 **${formatFeatureName(featureName)}** 功能的协作工作。 **参与专家**：${specialistNames} --- ${specialistSections} --- ### 整体状况 ${statusIcon} **所有专家都已完成并验证了他们的工作** **总更改**：${totalFiles} 个文件（+${totalAdditions}、-${totalDeletions}） **总测试数**：${totalPassing}/${totalTests} 通过 (${Math.round(totalPassing /totalTests * 100)}%) **集成验证**： ${generateIntegrationChecklist(专家)} **准备审查** 🎉`； } 函数 getFileDescription(filePath: string): string { if (filePath.includes('route')) return 'API 路由'; if (filePath.includes('controller')) return '业务逻辑'; if (filePath.includes('model')) return '数据模型'; if (filePath.includes('component')) return 'UI 组件'; if (filePath.includes('hook')) return 'React hook'; if (filePath.includes('test')) return '测试'; if (filePath.includes('migration')) return '数据库迁移'; return '核心实现'; } 函数格式FeatureName（名称：字符串）：字符串{ 返回名称 .split('-') .map(word => word.charAt(0).toUpperCase() + word.slice(1)) 。加入（' '）; } 函数generateIntegrationChecklist（专家：SpecialistWork []）：字符串{ 常量检查 = [ “所有专业工作均已完成并经过验证”， “记录和测试集成点”， “端到端功能已确认”， '所有测试都通过所有层'， “没有引入重大变更”， “文档已更新” ]; return checks.map(check => `- [x] ${check}`).join('\n'); } ### 完整的公关评论工作流程 **检测上下文并生成适当的评论**：异步函数generatePRComment( 特征名称：字符串， prNumber: 号码 ): 承诺<字符串> { const context = detectorMultiSpecialistWork(featureName); 如果（！context.isMultiSpecialist）{ // 单一专家工作流程 const 专家 = 等待 getCurrentSpecialist(); const 更改 = 等待 getFileChanges(prNumber); const 测试 = 等待 getTestResults(); const 摘要=等待generateWorkSummary（更改）；返回generateSingleSpecialistComment（专家，摘要，更改，测试）； } // 多专家工作流程 const 专家 = 等待 Promise.all( context.specialists!.map(async (name) => { const handoffFile = `.agency/handoff/${featureName}/${name.toLowerCase().replace(/\s+/g, '-')}-summary.md`; const 摘要 = 等待 parseHandoffSummary(handoffFile); 返回{ 名字，摘要：摘要.工作已完成，文件：summary.filesChanged，测试：summary.testResults，交接文件，集成点：summary.integrationPoints }; }) ）；返回generateMultiSpecialistComment(featureName, 专家); } 异步函数 postPRComment(prNumber: number, body: string): Promise { 等待 octokit.issues.createComment({ 所有者：'组织名称'， repo: 'repo-name', 问题编号：prNumber，身体 }); } // 用法 const comment =等待generatePRComment('用户身份验证', 456); 等待postPRComment（456，评论）； ### PR 评论的最佳实践 **多位专家评论**： * ✅ 使用可折叠的“

”部分来保持主视图干净 * ✅ 列出标题中涉及的所有专家 * ✅ 链接到详细的交接摘要以进行深入研究 * ✅ 清楚地记录集成点 * ✅ 包括综合测试结果 * ✅ 显示总体状态和验证清单 **单一专家评论**： * ✅ 保持格式一致，方便扫描 * ✅ 突出显示关键文件和更改 * ✅ 包括测试结果和覆盖范围 * ✅ 添加验证清单 * ✅ 使用清晰的状态指示器（✅、⚠️、❌） **Markdown 格式**： * ✅ 使用正确的标题层次结构（##、###） * ✅ 使用反引号格式化代码 * ✅ 谨慎使用表情符号作为状态指示符 * ✅ 将行数控制在 120 个字符以下以提高可读性 * ✅ 在适当的时候使用表格来存储结构化数据 **自动化**： * ✅ 自动检测多专家与单专家背景 * ✅ 从 git diff 中提取文件统计信息 * ✅ 从测试运行器输出中解析测试结果 * ✅ 相关移交文件的链接 * ✅ 包含提交 SHA 以实现可追溯性 ** ** ## 快速参考 ### 基本 gh 命令 * `gh issues list --label ` \- 按标签过滤问题 * `gh issues view --json ` \- 以 JSON 形式获取问题 * `gh pr create --fill` \- 从提交创建 PR * `gh pr merge --squash --auto` \- 检查通过时自动合并 * `gh project item-add --url ` \- 添加到项目板 ### 关键 API 端点 * `GET /repos/{owner}/{repo}/issues` \- 列出问题 * `POST /repos/{owner}/{repo}/issues` \- 创建问题 * `PATCH /repos/{owner}/{repo}/issues/{number}` \- 更新问题 * `POST /repos/{owner}/{repo}/issues/{number}/comments` \- 添加评论 * `GET /repos/{owner}/{repo}/pulls` \- 列出 PR ### URL 模式 * 问题：`https://github.com/{owner}/{repo}/issues/{number}` * PR：`https://github.com/{owner}/{repo}/pull/{number}` * 参考文献：文本中的“#{number}” ### 最佳实践 * 始终处理速率限制（5000/小时经过验证） * 使用GraphQL满足嵌套数据需求 * 缓存存储库元数据以减少API调用 * 使用webhooks进行实时事件处理 * 实施指数退避重试 ** ** ## 相关技能 * **github-workflow-best-practices** ：更广泛的 GitHub 工作流模式和团队协作 * **agency-workflow-patterns** ：适用于任何提供商的通用工作流程自动化 * **jira-integration**：用于比较的替代提供商集成 * **testing-strategy** ：GitHub Actions 工作流程的集成测试

Github 集成

包含技能