关于 ds-pr
ds-pr 是用于创建或更新 GitHub Pull Request 的技能,面向需要清晰交接变更的开发者。它规范标题和说明内容,并要求检查差异、敏感信息及 PR 状态。
主要功能
- 01检查分支是否已有 PR 并更新
- 02对照基准分支核实变更范围
- 03参照近期已合并 PR 的标题格式
- 04按问题、修复和验证编写说明
- 05扫描敏感信息并创建可审查的 PR
适用场景
- 01为当前分支创建便于快速审阅的 PR
- 02更新已有 PR 以匹配当前变更
- 03提交前检查 PR 文本及附件中的敏感信息
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ aicodeking/ deepseek-stack --skill ds-pr安装后在 Claude Code 中输入/ds-pr确认已加载。
详细介绍
创建一个真实的 PR,标题和描述应简洁明了,让忙碌的审查者十秒内读完。
步骤
- 检查此分支是否已有 PR(
gh pr list --head <branch>)。如果有,就更新它。 - 将此分支与其基准分支(通常是
origin/main)进行比较。确认差异符合目标,且不包含无关内容。 - 阅读近期合并的几个 PR 的标题,并沿用它们的格式。
- 标题要说明用户能看到哪些变化,以及这些变化为何重要,而不是说明哪个函数发生了移动。例如,“通过压缩减少 70% 的 websocket 帧数”胜过“协商 permessage-deflate”。
- 按以下顺序撰写描述:
- 用一两句平实的话说明问题,内容取自用户的请求。
- 用一两句话说明解决方案。
- 如果有依据,用一行说明如何验证。
- 结束语:
Created with <model> in <harness>.使用 harness 报告的模型名称。如果未报告模型名称,只写 harness。
- 检查标题、正文和所有附件中是否包含密钥、令牌、私有路径和个人数据,并将其移除。
- 创建可供审查的 PR,而非草稿,以便审查机器人运行。
- 输出 GitHub 返回的 PR URL。
停止条件
- GitHub 返回了 PR URL。如果用户要求持续关注,则交由
ds-watch-pr处理。 gh pr create失败两次。如果错误是 GraphQL 速率限制,则通过 REST 重试一次:gh api repos/<owner>/<repo>/pulls -f title=... -f head=... -f base=... -F [email protected]。如果仍然失败,则报告错误。
规则
- 描述中不要逐个文件列出变更。
- 除非请求需要,否则不要发布后续评论。需要时使用
ds-pr-comments。 - 绝不可猜测模型名称。
评论
支持 Markdown