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

2.6 KiB
Raw Blame History

GitHub Issue Review Skill Trace

2026-05-06

阶段能力落地准备ISSUE-SKILL-RP-001

  • 读取 AGENTS.md.ai/environment/tools.ai.yamlai-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