name: pr-workflow description: 当用户要求“创建 PR”、“制作拉取请求”、“为此分支打开 PR”、“以 PR 提交更改”、“推送并创建 PR”,或运行 /create-pr 或 /pr-creator 命令时,应使用此技能。
Pull Request 工作流
遵循项目标准的创建拉取请求的完整工作流。
流程
-
验证暂存更改 使用
git diff --cached --name-only -
分支设置
- 如果在 main/master 分支上,首先创建特性分支:
feature/简短描述或fix/简短描述 - 如果需要,使用
github-dev:commit-creator子代理处理暂存更改
- 如果在 main/master 分支上,首先创建特性分支:
-
文档检查
- 基于与目标分支的更改更新 README.md 或文档
- 对于配置/API 更改,使用
mcp__tavily__tavily_search验证信息并包含来源
-
分析所有提交
- 使用
git diff <base-branch>...HEAD审查完整更改集 - PR 消息必须描述所有提交,而不仅仅是最新提交
- 从审查者角度关注更改内容
- 使用
-
创建 PR
- 使用
/pr-creator代理或gh pr create带参数:-t(标题):以大写字母开头,使用动词,NO “fix:” 或 “feat:” 前缀-b(正文):简要摘要 + 带内联 Markdown 链接的要点-a @me(自我分配)-r <reviewer>:通过gh pr list --repo <owner>/<repo> --author @me --limit 5查找
- 使用
-
PR 正文指南
- 摘要:几个词或一句话描述更改
- 更改:带内联链接的要点,如
[src/auth.py:42](src/auth.py#L42) - 示例:对于重大更改,包含前后代码示例
- 无测试计划:在 PR 中永远不要提及测试程序
示例
带内联源链接:
Update Claude Haiku to version 4.5
- Model ID: claude-3-haiku-20240307 → claude-haiku-4-5-20251001 ([source](https://docs.anthropic.com/en/docs/about-claude/models/overview))
- Pricing: $0.80/$4.00 → $1.00/$5.00 per MTok ([source](https://docs.anthropic.com/en/docs/about-claude/pricing))
- Max output: 4,096 → 64,000 tokens ([source](https://docs.anthropic.com/en/docs/about-claude/models/overview))
带代码更改:
Refactor authentication to use async context manager
- Replace synchronous auth flow with async/await pattern in [src/auth.py:15-42](src/auth.py#L15-L42)
- Add context manager support for automatic cleanup
Before:
\`\`\`python
def authenticate(token):
session = create_session(token)
return session
\`\`\`
After:
\`\`\`python
async def authenticate(token):
async with create_session(token) as session:
return session
\`\`\`