名称: pr-summary 描述: 生成PR总结并写入.ai/pr_summary.md 允许的工具: 读取, Grep, Glob, 写入, Bash
创建PR总结
根据分支变更生成Pull Request总结。
指令
-
收集上下文
- 获取当前分支名称
- 找到与此分支对应的
.ai/工作流文件夹:- 对于问题分支(例如,
feature/59-no-verify):查找.ai/issue-59-* - 对于命名分支(例如,
feature/worktree-support):查找.ai/feature-worktree-support/或.ai/worktree-support/ - 使用
ls .ai/并根据分支名称模式匹配
- 对于问题分支(例如,
- 如果存在,读取这些文件(使用它们来理解功能目标和实现方法):
concept.md- 功能概念和设计理由analysis.md- 问题分析和需求plan.md- 带有具体变更的实现计划
- 从分支名称、提交或analysis.md获取关联的问题编号
-
分析变更
# 此分支上的所有提交 git log main...HEAD --oneline # 完整差异 git diff main...HEAD --stat # 更改的文件 git diff main...HEAD --name-only -
生成总结
读取
.github/PULL_REQUEST_TEMPLATE.md以获取格式规范和示例。使用
.ai/文件夹文件的上下文编写更好的总结:- concept.md: 理解设计目标和理由
- analysis.md: 参考原始问题需求
- plan.md: 验证所有计划变更是否已实施
将总结写入
.ai/<folder>/pr_summary.md。 -
创建PR命令
输出
gh pr create命令:gh pr create --title "<title>" --body "$(cat .ai/<folder>/pr_summary.md)" -
报告完成
- 显示pr_summary.md的路径
- 显示PR创建命令
- 如果尚未推送分支,提醒先推送分支
PR标题指南
- 使用祈使语气:“添加功能"而不是"已添加功能”
- 具体但简洁
- 不要在标题中包含问题编号(它将在PR正文中链接)