关于 create-fix-pr
create-fix-pr 是用于从问题调查到提交修复 PR 的技能,面向处理代码问题的 Agent。它要求先以证据确定根因,再以最小代码改动创建 PR,并遵循仓库约定。
主要功能
- 01先调查并定位根因
- 02检查是否已有相关 PR
- 03判断是否适合提交 PR
- 04按仓库规范修改并提交
- 05限制改动范围与内容
适用场景
- 01根据日志和代码证据修复缺陷
- 02避免为已有问题重复开 PR
- 03遇到配置类问题时说明解决方案
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ launchdarkly/ ai-tooling --skill create-fix-pr安装后在 Claude Code 中输入/create-fix-pr确认已加载。
附带文件pr-conventions.md
详细介绍
创建修复 PR
概述
你正在调查一个问题,并提交一个能够解决该问题的拉取请求。这项工作基于 investigate 技能——请先认真完成调查,不要在没有证据的情况下直接着手修复。
所有 GitHub 操作都使用 gh CLI(通过你的 gh 登录获取身份验证),其他操作使用标准的 Bash / Edit / Read / Grep。
工作流
- 调查。 使用
investigate技能找出根本原因。提供能锁定问题的确切跟踪 ID、日志行、错误组和代码位置。 - 确认没有已打开的 PR。 提交任何内容前,先在 GitHub 上搜索是否已有解决同一问题的开放 PR——
gh pr list --search "<keywords>" --state open。如果已存在,请引导用户查看该 PR,不要创建重复的 PR。 - 判断 PR 是否合适。 如果修复需要更改配置、切换标志,或修改你无法访问的代码,请描述解决方案,而不是提交 PR。
- 获取代码仓库。 如果本地还没有代码仓库,就克隆它——
gh repo clone <owner>/<repo>。 - 检查代码仓库规范。 阅读代码仓库根目录下的
agents.md或CLAUDE.md——这些文件说明了修复必须遵循的代码仓库专属规则。 - 进行修改。 差异应尽可能小。不要重构周边代码,不要添加功能,也不要顺手修复注意到的无关错误。一个 PR,只修一个问题。
- 提交前设置 Git 身份信息——参见
pr-conventions.md。 - 提交、推送并创建 PR。 分支命名和 PR 正文规则请参见
pr-conventions.md。
什么是好的修复
- 修改的行数尽可能少
- 除非当前行为本身就是错误,否则应保留现有的生产环境行为
- 不依赖无法通过证据验证的假设
- 如果存在
code-review技能检查,应能通过检查
什么不属于好的修复
- 与报告的问题无关的大规模重构
- “顺便”添加臆测性的空值检查或错误处理
- 修改测试以掩盖根本问题
- 为修复表面症状而升级依赖版本
受限工具
如果未安装 gh,或 gh auth status 显示未通过身份验证,请向用户说明错误并停止——不要尝试其他身份验证方式。
PR 中绝不能包含
- GitHub 访问令牌或任何其他机密或凭据。
- 调查期间添加的调试日志或打印语句。
其他事项均遵循代码仓库自己的提交和 PR 规范。
评论
支持 Markdown