mcpField
C
create-fix-pr

create-fix-pr

github.com/launchdarkly开发28667 次安装1 天前更新
代码仓库

关于 create-fix-pr

create-fix-pr 是用于从问题调查到提交修复 PR 的技能,面向处理代码问题的 Agent。它要求先以证据确定根因,再以最小代码改动创建 PR,并遵循仓库约定。

主要功能

  1. 01先调查并定位根因
  2. 02检查是否已有相关 PR
  3. 03判断是否适合提交 PR
  4. 04按仓库规范修改并提交
  5. 05限制改动范围与内容

适用场景

  1. 01根据日志和代码证据修复缺陷
  2. 02避免为已有问题重复开 PR
  3. 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。

工作流

  1. 调查。 使用 investigate 技能找出根本原因。提供能锁定问题的确切跟踪 ID、日志行、错误组和代码位置。
  2. 确认没有已打开的 PR。 提交任何内容前,先在 GitHub 上搜索是否已有解决同一问题的开放 PR——gh pr list --search "<keywords>" --state open。如果已存在,请引导用户查看该 PR,不要创建重复的 PR。
  3. 判断 PR 是否合适。 如果修复需要更改配置、切换标志,或修改你无法访问的代码,请描述解决方案,而不是提交 PR。
  4. 获取代码仓库。 如果本地还没有代码仓库,就克隆它——gh repo clone <owner>/<repo>。
  5. 检查代码仓库规范。 阅读代码仓库根目录下的 agents.md 或 CLAUDE.md——这些文件说明了修复必须遵循的代码仓库专属规则。
  6. 进行修改。 差异应尽可能小。不要重构周边代码,不要添加功能,也不要顺手修复注意到的无关错误。一个 PR,只修一个问题。
  7. 提交前设置 Git 身份信息——参见 pr-conventions.md。
  8. 提交、推送并创建 PR。 分支命名和 PR 正文规则请参见 pr-conventions.md。

什么是好的修复

  • 修改的行数尽可能少
  • 除非当前行为本身就是错误,否则应保留现有的生产环境行为
  • 不依赖无法通过证据验证的假设
  • 如果存在 code-review 技能检查,应能通过检查

什么不属于好的修复

  • 与报告的问题无关的大规模重构
  • “顺便”添加臆测性的空值检查或错误处理
  • 修改测试以掩盖根本问题
  • 为修复表面症状而升级依赖版本

受限工具

如果未安装 gh,或 gh auth status 显示未通过身份验证,请向用户说明错误并停止——不要尝试其他身份验证方式。

PR 中绝不能包含

  • GitHub 访问令牌或任何其他机密或凭据。
  • 调查期间添加的调试日志或打印语句。

其他事项均遵循代码仓库自己的提交和 PR 规范。

评论

支持 Markdown