PR工作流Skill pr-workflow

此技能用于创建和管理Pull Request(拉取请求)的完整工作流程,包括分支设置、文档检查、提交分析和PR创建,适用于代码审查和版本控制。关键词:Pull Request, Git, GitHub, 代码审查, DevOps, 工作流。

DevOps 0 次安装 0 次浏览 更新于 3/16/2026

name: pr-workflow description: 当用户要求“创建 PR”、“制作拉取请求”、“为此分支打开 PR”、“以 PR 提交更改”、“推送并创建 PR”,或运行 /create-pr 或 /pr-creator 命令时,应使用此技能。

Pull Request 工作流

遵循项目标准的创建拉取请求的完整工作流。

流程

  1. 验证暂存更改 使用 git diff --cached --name-only

  2. 分支设置

    • 如果在 main/master 分支上,首先创建特性分支:feature/简短描述fix/简短描述
    • 如果需要,使用 github-dev:commit-creator 子代理处理暂存更改
  3. 文档检查

    • 基于与目标分支的更改更新 README.md 或文档
    • 对于配置/API 更改,使用 mcp__tavily__tavily_search 验证信息并包含来源
  4. 分析所有提交

    • 使用 git diff <base-branch>...HEAD 审查完整更改集
    • PR 消息必须描述所有提交,而不仅仅是最新提交
    • 从审查者角度关注更改内容
  5. 创建 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 查找
  6. 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
\`\`\`