GFramework/ai-plan/public/github-issue-review-skill/traces/github-issue-review-skill-trace.md
gewuyou ab9829044f feat(skills): 新增 GitHub issue 分诊 skill
- 新增 gframework-issue-review skill,支持抓取 issue 元数据、评论、timeline 与分诊摘要。

- 补充 JSON 输出、唯一 open issue 自动解析与 WSL Linux git 绑定兼容处理。

- 更新 ai-plan 恢复入口并增加脚本级测试与验证记录。
2026-05-06 15:40:48 +08:00

49 lines
2.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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`