创建拉取请求

1. 📌 Skill 基础信息

Skill 名称：create-pr

来源：社区第三方（Guild-Agents）

运行宿主：只能在与 Guild-Agents/guild 集成的 AI Agent 工具中运行（具体 Agent 工具未明确公开）

核心定位：自动从当前功能分支创建结构化的 Pull Request，包含提交摘要、变更统计和测试结果，适用于功能开发完成后需要代码评审的场景。

2. 🧩 内部核心组成

该 Skill 采用多步骤工作流架构，包含以下核心组件：

工作流步骤：

• 分支验证：检查当前分支状态和未提交变更
• 上下文收集：获取提交记录、差异统计、测试和 lint 结果
• PR 描述生成：构建结构化 Markdown 描述
• PR 创建：使用 gh CLI 创建 Pull Request
• 后处理：显示 PR 链接和建议后续操作

命令/工具表：

命令/工具	功能简述
/create-pr	触发完整的 PR 创建流程
git status	检查未提交的变更
git log	获取当前分支的提交记录
git diff --stat	生成文件变更统计
npm test	运行项目测试
npm run lint	运行代码检查
gh pr create	使用 GitHub CLI 创建 PR

3. 🛠 安装与启用方式

安装命令：

skills install --user Guild-Agents/guild

前置依赖：

• Git 版本控制系统
• GitHub CLI (gh) 工具
• Node.js 项目环境（用于运行测试和 lint）
• 有效的 GitHub 仓库访问权限

4. 📋 标准工作流

1. 用户输入：开发者输入 /create-pr 命令
2. 分支验证：系统检查当前不在 main/develop 分支，确认无未提交变更，获取相对于 main 的提交列表
3. 上下文收集：收集差异统计、运行测试和 lint 检查，为 PR 描述准备数据
4. 描述生成：基于提交信息、变更统计和测试结果自动生成结构化 PR 描述
5. PR 创建：推送分支到远程仓库，使用 gh CLI 创建包含生成描述的 Pull Request
6. 结果展示：显示 PR URL 并提供后续操作建议

5. ⚠️ 关键限制、缺陷、注意事项

平台限制：

• 仅支持 GitHub 平台（依赖 gh CLI）
• 需要项目使用 Git 版本控制

Token 消耗：主要消耗在测试运行和代码分析阶段，具体取决于项目规模

适用项目：

• Node.js 项目（测试和 lint 命令假设 npm 环境）
• 使用常规 Git 工作流的项目
• 中小型代码库

不适用场景：

• 非 GitHub 平台项目
• 无测试/lint 配置的项目
• 大型单体仓库（可能测试时间过长）

已知坑点：

• 如果分支包含 wip: 提交，建议先进行压缩合并
• 测试或 lint 失败时仍允许继续创建 PR（可能产生不完整PR）
• 不自动合并 PR，需要手动操作

生产环境适用性：适用于开发环境，生产环境需谨慎评估测试覆盖率和代码质量要求

6. ✅ 适用场景 & ❌ 不适合场景

✅ 适用场景：

• 功能开发完成后需要快速创建代码评审
• 希望自动化 PR 描述生成流程的团队
• 使用标准 Git 工作流和 Node.js 技术栈的项目
• 需要保持 PR 描述格式一致性的项目

❌ 不适合场景：

• 非 GitHub 代码托管平台（GitLab、Bitbucket 等）
• 非 Node.js 项目或无测试框架的项目
• 需要高度定制化 PR 模板的场景
• 对 PR 创建流程有特殊安全审查要求的组织

skills install --user Guild-Agents/guild