关于 pr-workflow
指导贡献者按项目规范完成 Pull Request 流程的技能,涵盖暂存更改检查到创建 PR。内容包括分支、文档、提交审查和 PR 描述规范。
主要功能
- 01检查暂存更改并设置分支
- 02判断文档更新需求
- 03分析完整提交集合
- 04使用 gh 或 Agent 创建 PR
- 05遵循精简的 PR 正文规范
适用场景
- 01提交更改前准备功能分支
- 02审查所有提交并编写 PR 描述
- 03按项目约定创建 PR
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ fcakyon/ claude-codex-settings --skill pr-workflow安装后在 Claude Code 中输入/pr-workflow确认已加载。
详细介绍
拉取请求工作流
按照项目标准创建拉取请求的完整工作流。
流程
-
验证暂存区中存在更改,使用
git diff --cached --name-only -
分支设置
- 如果当前位于 main/master 分支,先创建功能分支:
feature/简短描述或fix/简短描述 - 如有需要,使用
github-dev:commit-creator子 Agent 处理暂存区中的更改
- 如果当前位于 main/master 分支,先创建功能分支:
-
文档检查
- 根据与目标分支的差异,更新 README.md 或文档
- 对于配置/API 更改,使用
mcp__tavily__tavily_search验证信息并附上来源
-
分析所有提交
- 使用
git diff <base-branch>...HEAD检查完整的变更集 - PR 描述必须涵盖所有提交,而不只是最新提交
- 从审查者的角度聚焦于更改内容
- 使用
-
创建 PR
- 使用
/pr-creatorAgent 或gh pr create,并设置以下参数:-t(标题):以大写字母开头,使用动词,不要添加 “fix:” 或 “feat:” 前缀-b(正文):简短摘要 + 带行内 Markdown 链接的项目符号列表-a @me(自行分配)-r <reviewer>:仅在用户明确要求,或该作者近期的 PR 有审阅者时添加。 使用以下命令检查:gh pr list --repo <owner>/<repo> --author @me --limit 5 --json reviewRequests如果近期的 PR 没有审阅者,则完全省略-r。
- 使用
-
PR 正文指南
- 使用单个部分,尽量不加标题。保持非常简洁
- 少量项目符号 + 1 个 CLI/用法代码片段或简单的前后对比片段
- 不要写测试计划、已更改文件列表或带行号的链接
示例
CLI 代码片段:
Add compare command for side-by-side model comparison
- Run multiple models on same images with `--models` and `--phrases` flags
- Horizontal panel concatenation with model name headers
`ultrannotate compare --source ./images --models sam3.pt,yoloe-26x-seg.pt --phrases "person,car"`
前后对比:
Inline single-use variables in compare_models
- xyxy2xywhn handles empty arrays, guard unnecessary
- Use function reference for draw dispatch
Before: `boxes = result.get(...); ops.xyxy2xywhn(boxes, ...)`
After: `ops.xyxy2xywhn(result.get(...), ...)`
评论
支持 Markdown