github-issue-solution-loop

GitHub Issue Solution Loop

持续 review GitHub issue，从问题理解到方案一致，再等待作者或维护者提交关联 PR 并 review PR。核心原则：只讨论方案和 review，不写代码、不建分支、不开 PR。

---

身份与工具约束

• GitHub 操作必须使用本地 gh 命令。
• 如果本机没有 gh，先安装 gh，再继续。
• GitHub 身份必须来自本地环境变量 GITHUB_BOT_TOKEN。
• 不使用本机已有的个人 gh auth 登录态。
• 不使用其他账号或 token。
• 不打印、不 echo、不暴露 token。
• 在 Codex 客户端中需要持续观察时，优先使用 heartbeat automation 做真正后台轮询，不只依赖一个前台 sleep loop。
• 禁止写代码、改文件、建分支、commit、push、开 PR 或更新 PR 内容。
• 方案达成一致后，只要求 issue 作者或维护者提交/更新 PR，然后等待并 review。
• review 关联 PR 时不执行测试命令；默认 PR 提交流程或 CI 已经跑过必要测试，只从代码和 diff 判断测试覆盖是否足够。
• 推荐命令形式：

GH_TOKEN="$GITHUB_BOT_TOKEN" gh issue view <issue>
GH_TOKEN="$GITHUB_BOT_TOKEN" gh issue comment <issue> --body "<body>"
GH_TOKEN="$GITHUB_BOT_TOKEN" gh pr view <pr>

如果 GITHUB_BOT_TOKEN 不存在，停止并要求用户提供；不要降级使用个人账号。

---

Loop 参数

• 默认持续时间：用户未指定时运行 2 小时。
• 默认范围：用户指定的 issue。
• 如果用户要求扫描多个 issue，每轮都重新查询目标范围，不能因为上轮数量固定就提前停止。
• 优先创建或更新挂在当前 Codex session 上的 heartbeat automation；每次唤醒执行一轮 issue/PR 扫描，然后交回给 automation 调度下一轮。
• 根据当前 active issue 或关联 PR 更新当前 Codex session 标题；如果运行环境没有 session 标题控制能力，则跳过，不影响 loop。
• 如果某轮发布了 issue comment 或执行了 PR review/comment，立刻开始下一轮扫描。
• 如果某轮没有任何动作，等待 5 分钟 后再扫描。
• 到达持续时间后停止，并总结：
  • issue 当前状态
  • 方案是否已达成一致
  • 已处理的相关 PR
  • 已 approve 的 PR
  • 仍阻断的问题
  • 跳过或未执行动作的原因

---

每轮必须检查

对 issue 收集：

• issue number、title、body、author、labels、assignees、state、updatedAt
• 最新 issue comments
• bot 上一次 issue comment/action
• linked PR、closing references、timeline events
• 是否有新评论、维护者信号、作者回复、label 变化或其它更新

对相关 PR 收集：

• PR head SHA、commit 列表、评论、review comments、reviews
• bot 针对当前 head SHA 的上次 review 状态
• 上次 review 之后是否有新提交、评论、回复或 review

常用命令示例：

GH_TOKEN="$GITHUB_BOT_TOKEN" gh api user --jq .login
GH_TOKEN="$GITHUB_BOT_TOKEN" gh issue view <issue> --json number,title,body,author,comments,labels,assignees,state,updatedAt
GH_TOKEN="$GITHUB_BOT_TOKEN" gh api repos/<owner>/<repo>/issues/<issue>/timeline

当 gh issue view 信息不足时，用 gh api 查询 timeline 或 linked PR。

---

Codex 后台轮询