用途:撰写或更新 GitHub PR 正文,让评审者无需阅读 spec、提交历史或其他文档即可理解变更。
主要能力:正文自包含,说明做了什么、为什么、关键决策;无状态,始终反映相对 origin/main 的当前范围,更新时重写受影响部分而非追加修订记录。模板含 Summary、Motivation、Approach、Architectural decisions、Changes、Screenshots/recordings、How to verify、Test plan、Related issues、Future considerations 等,按变更类型裁剪深度。
使用方式:先收集上下文。提供 PR 编号时运行 gh pr diff <number> 与 gh pr view <number>;提供 SPEC.md 路径时读取并与实现交叉核对,代码为准;输入 new 时运行 git diff main...HEAD --stat;无输入则从当前分支推断。随后填写模板。应用前先 gh auth status 验证 gh CLI,不可用则输出正文供手动应用。新建 PR:git push -u origin <branch> 后 gh pr create --draft --title "<concise title>" --body "$(cat <<'EOF' ... EOF)";更新:gh pr edit <number> --body "$(cat <<'EOF' ... EOF)"。被 /ship、/review 等技能调用时,接受其上下文并返回或直接应用正文。
适用场景:新功能、增强、缺陷修复、配置/基础设施/重构等 PR 的正文撰写与更新。
限制:依赖 gh CLI 与 GitHub 环境;无 SPEC.md 时仅从代码与提交历史推导;不负责决定何时更新正文,由调用方决定;资料未提供具体收费、平台支持范围等信息。