用途
engineering-small-prs 用于在规划、拆分、缩小或排期大型功能、重构、迁移及拉取请求时，把工作组织成更易审阅的小型 PR 或 CL。其核心理念是：小 PR 更容易彻底审阅、合并更安全、回滚更容易，且方向变化时浪费的工作更少。这里的“小”指概念上聚焦、自包含，而不仅仅是行数少。
主要能力
- 定义“好的小 PR”：做一个自包含的改动；包含验证该改动的测试；合并后系统仍可工作；在 PR、描述、现有代码或先前已审阅 PR 中给审阅者足够上下文；不过小到无法理解行为；将大范围重构与行为变更分离（除非清理非常局部）。审阅者可以仅因 PR 太大而合理拒绝。
- 拆分工作流：用一句话命名最终结果；列出独立的行为变更、重构、schema/配置变更、测试和文档；识别必须先落地的依赖；选择拆分策略；构建每个 PR 都保持构建通过的合并序列；添加上下文说明；对风险大或不可避免的大改动，在发送 PR 前取得审阅者同意。
- 拆分策略：先补预备测试；先重构（移动、重命名、提取或简化而不改变行为）；纵向切片（端到端交付一个小型用户可见或 API 可见行为）；水平切片（仅在同一个 PR 中有真实首次使用，或已有明确关联的依赖 PR 正在审阅时，才添加共享接口、协议定义或适配器）；按文件或负责人分组；配置分离；生成或机械改动分离；删除可单独进行。
- 迁移安全：对 schema、数据、API 或基础设施迁移，建议采用 expand/contract 序列——扩展（添加向后兼容支持而不移除旧行为）、双路径（仅在需要时读写两条路径，并观测差异）、回填（迁移现有数据，带进度跟踪、重试与验证）、切换（验证两条路径安全后切换流量或调用方）、收缩（在清理 PR 中移除旧 schema、代码路径、开关和兼容层）。每个迁移 PR 应说明部署顺序、回滚行为、验证信号，以及在下个 PR 落地前不能发生什么。
- 输出模板：包含 Goal、Proposed PR Sequence 表格（#、PR、Purpose、Depends On、Tests、Reviewer Notes）、Migration Safety、Build Safety、Large-Change Risk 等部分。
- 经验法则：宁可 PR 比想象中更小；小逻辑改动散布到多个文件时应视为更大；若审阅者需要大量未来上下文才能理解，可能缺少更早的准备 PR 或更好的描述；无法拆分时，用更强测试、更清晰描述、明确风险和事先审阅者同意来弥补。
- 常见错误：把大范围格式化改动与功能逻辑混在一起；引入新抽象却没有真实使用；创建中间 PR 破坏构建的堆叠序列；在“重构”PR 中隐藏风险行为变更；在可用安全堆叠工作流时等待一个 PR 合并后才开始下一个。
使用方式
该技能以提示/工作流形式提供：先为最终目标命名，再列出各项独立改动与依赖，选择拆分策略并排出合并序列，最后按输出模板填写 PR 序列表、迁移安全、构建安全和大改动风险。资料未提供具体安装命令或代码调用方式，暂未提供。
适用场景
适用于规划大型功能、拆分重构、数据库 schema 或数据迁移、API 迁移、基础设施迁移，以及任何需要把大改动整理成一系列可审阅、可回滚、构建保持通过的 PR/CL 的工程工作。
限制
资料未说明该技能的收费、价格、支持平台或运行环境，暂未提供。其内容改编自 Google Engineering Practices Documentation 中的“Small CLs”，采用 CC-BY 3.0 许可；同一作者也在 agentara/skills（MIT）发布。