用途:抓取 GitHub 历史(PR、issue、评审评论),把机构性知识提炼到 agent_artefacts/repo_context/REPO_CONTEXT.md,帮助 worker agents 在修改代码前了解仓库约定、常见错误与已知技术债。由 context agents 定期运行。
主要能力与流程:
- 准备:创建 agent_artefacts/repo_context/ 目录;若已有 REPO_CONTEXT.md 则读取并更新而非替换。
- 识别新增内容:依据文档头部记录的最近更新日期与 PR 范围判断。首次运行抓取最近 50 个已合并 PR 加全部 open issue;增量运行抓取头部最高 PR 号之后合并的 PR,以及自上次更新以来有变动的 issue。使用 gh CLI 列出候选,例如:gh pr list --state merged --limit 50 --json number,title,labels,additions,deletions,reviewDecision,mergedAt;gh issue list --state open --limit 100 --json number,title,labels,createdAt,updatedAt。
- 分诊:跳过依赖升级、仅改 changelog、无评审评论的机器人 PR、改动少于 5 行且无评论的 PR;优先有评审评论、涉及共享工具或 CONTRIBUTING.md、BEST_PRACTICES.md、AGENTS.md 的 PR。每次最多 50 个 PR。
- 提取:用 gh pr view、gh api 获取正文、评审评论与 issue 评论;评论中引用其他 PR/issue 时递归追踪,最多 3 跳,避免循环。
- 提炼:按设计决策、评审纠正、既定约定、已知技术债、常见 agent 错误分类,每条须引用来源编号、可执行、超出既有文档、对未来贡献者有用且具普遍性。
- 合并:整合进现有结构而非追加,去重,更新头部元数据,文档保持 500-1000 行。
- 去重与整合:跨章节检查重复,每条洞察只保留在最具体的一处。
限制:首次运行范围、增量范围、每次最多 50 个 PR、最多 100 个 issue、链接追踪 3 跳、目标文档 500-1000 行。输出为 agent_artefacts/repo_context/REPO_CONTEXT.md。运行后需核对文档结构、引用、可执行性、无跨章节重复、行数与头部元数据更新。