关于 gentle-ai-chained-pr
面向编码 Agent 的技能，用于在变更超过规定规模或用户要求拆分评审时规划链式 PR。它规定策略选择、PR 边界、依赖说明和验证步骤。
主要功能
- 01400 行 PR 阈值与决策条件
- 02堆叠式与功能分支链策略
- 03PR 背景信息与依赖图
- 04独立验证与干净差异检查
适用场景
- 01将大型变更拆分为易评审的 PR
- 02规划功能分支链中的 PR 依赖
- 03检查 PR 边界与验证计划
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/gentle-ai-chained-pr确认已加载。
附带文件references/chaining-details.md
详细介绍
激活约定
如果计划中的 PR 可能超过 400 行变更、SDD 预测 400-line budget risk: High 或 Chained PRs recommended: Yes，或者用户要求链式/堆叠 PR、评审切片或控制评审负担，则加载此技能。
硬性规则
- 除非维护者明确接受
size:exception，否则将超过 400 行变更的 PR 拆分。 - 确保每个 PR 的评审时间约为 ≤60 分钟。
- 每个 PR 只包含一个可交付工作单元；测试和文档应与其验证的工作单元放在一起。
- 在每个链式 PR 中说明起始点、结束点、前置依赖、后续工作和范围外事项。
- 每个子 PR 都必须包含依赖关系图，并用
📍标记当前 PR。 - 在 Feature Branch Chain 中，创建一个草稿/禁止合并的跟踪 PR；子 PR #1 以跟踪分支为目标，后续子 PR 以直接父分支为目标。
- 将被污染的差异视为基分支问题：重新指定目标分支或变基，直到差异中只包含当前工作单元。
- 用户选择策略后，不得混用链式策略。
决策关卡
| 条件 | 操作 |
|---|---|
| PR ≤400 行变更且范围聚焦。 | 保留为单个 PR。 |
| PR >400 行，且每个切片都能独立合并。 | 使用 Stacked PRs，目标分支为 main。 |
| PR >400 行，且功能必须先集成再合并到 main。 | 使用带跟踪 PR 的 Feature Branch Chain。 |
| 生成文件/供应商文件/迁移差异无法妥善拆分。 | 向维护者申请 size:exception。 |
SDD 提供了 delivery_strategy。 | 在应用更改/创建 PR 之前遵循该策略。 |
执行步骤
- 估算变更行数并识别独立工作单元。
- 超出预算且尚无已缓存策略时，询问应采用哪种链式策略。
- 仅使用所选策略创建分支/PR。
- 在每个 PR 中添加 Chain Context，但不要替换仓库的 PR 模板。
- 独立验证每个 PR：CI/测试/文档/手动检查、回滚范围和差异是否干净。
- 在所有子 PR 完成评审并集成之前，保持跟踪 PR 为草稿/禁止合并状态。
输出约定
返回所选策略、PR 顺序、当前 PR 的范围边界、依赖关系图、评审预算（additions + deletions）、验证计划，以及任何 size:exception 的理由。
参考资料
- references/chaining-details.md — 策略图、PR 正文部分、分支命令和评审者指南。
评论
支持 Markdown