# GitHub Issue Review Skill Trace

## 2026-05-06

### 阶段：能力落地准备（ISSUE-SKILL-RP-001）

- 读取 `AGENTS.md`、`.ai/environment/tools.ai.yaml`、`ai-plan/public/README.md` 与现有
  `.agents/skills/gframework-pr-review/` 实现，确认新 skill 最稳妥的方案是复用现有 PR review 的
  GitHub API、WSL worktree Git 解析、文本 section 输出与脚本级测试骨架
- 确认当前任务属于 `new` + `complex`：
  - `new`：当前没有与 issue review skill 对应的公开恢复主题
  - `complex`：同时涉及 skill 设计、GitHub API 脚本、CLI 契约、测试和 `ai-plan` 恢复入口
- 根据实现前确认的产品决策固定默认行为：
  - 未显式传 issue 号时，只在“仓库当前恰好一个 open issue”时自动选中
  - skill 默认只做“抓取 + 分诊 + boot 衔接”，不在脚本层直接改代码
- 已创建新 topic 目录并将当前分支 `feat/github-issue-review-skill` 映射到该 topic

### 当前执行目标

1. 新增 `gframework-issue-review` skill 文档与默认 prompt
2. 新增 `fetch_current_issue_review.py` 及其最小回归测试
3. 用真实 open issue 抓取验证默认流程，并记录最小验证命令

### 下一步

1. 直接用 `$gframework-issue-review` + `$gframework-boot` 开始 issue `#327` 的后续处理
2. 若后续仓库同时出现多个 open issue，统一改用显式 `--issue <number>` 入口

### 阶段：实现与验证完成（ISSUE-SKILL-RP-001）

- 已落盘新 skill 文件：
  - `.agents/skills/gframework-issue-review/SKILL.md`
  - `.agents/skills/gframework-issue-review/agents/openai.yaml`
  - `.agents/skills/gframework-issue-review/scripts/fetch_current_issue_review.py`
  - `.agents/skills/gframework-issue-review/scripts/test_fetch_current_issue_review.py`
- 真实抓取验证时首次发现：当前 WSL 会话会解析到 `git.exe`，但无法执行
  - 已在新脚本中修正为：只要仓库根目录存在 Linux `git`，就优先绑定显式 `--git-dir` / `--work-tree`
- 完成验证：
  - `python3 .agents/skills/gframework-issue-review/scripts/test_fetch_current_issue_review.py`
  - `python3 .agents/skills/gframework-issue-review/scripts/fetch_current_issue_review.py --section summary --section warnings`
  - `python3 .agents/skills/gframework-issue-review/scripts/fetch_current_issue_review.py --format json --json-output /tmp/gframework-open-issue-review.json`
  - `dotnet build GFramework.sln -c Release`
- 真实 issue 验证结论：
  - 当前 open issue 自动解析为 `#327`
  - `resolution_mode=auto-single-open-issue`
  - `comment_count=0`
  - `next_action=clarify-issue-before-code`
  - `affected_active_topics=cqrs-rewrite`