1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | incremental-implementation |
| 所属仓库 | addyosmani/agent-skills（子技能，合集仓库） |
| 作者/维护者 | Addy Osmani（Google 工程师，Web 性能与前端工具领域知名开发者） |
| 来源链接 | https://github.com/addyosmani/agent-skills/tree/main/skills/incremental-implementation |
| 许可证 | MIT（GitHub API 确认，来自仓库整体） |
| GitHub Stars / Forks | 仓库整体 81,189 ★ / 8,755 forks（GitHub API，2026-08-01）；合集仓库星数不代表本子技能自身热度 |
| 最新版本 | 仓库整体 Release 0.6.5（2026-07-26，GitHub Releases API） |
| 安装方式 | npx skills add addyosmani/agent-skills --skill incremental-implementation |
2. 功能介绍与亮点
针对“AI agent 写代码容易一口气改完整个功能、出错时分不清是哪一步”这个常见问题，把执行节奏固化为可直接照抄的纪律：
- 实施-测试-验证-提交循环：每个“薄纵切片”必须让系统回到可运行、可测试的状态才能进入下一步，不允许在多个未验证的改动上继续叠加
- 三种切片策略：纵向切片（优先，端到端打通一条完整路径）、契约优先切片（前后端并行开发时先定接口再各自实现）、风险优先切片（先验证最不确定的部分，尽早暴露风险）
- 范围纪律（Rule 0.5）：只改任务要求的部分，不顺手重构无关代码、不清理看不懂的注释、不因为“看着有用”就多加功能；发现范围外的问题只记录不动手，交给用户决定
- 可回滚设计：新增文件/函数优先于修改已有代码；数据库迁移要求配套回滚脚本；避免在同一提交里既删除又替换
- “与 Agent 协作”示例：给出可直接套用的指令模板，教你怎么明确告诉 agent “这一步只做 A，不要动 B”
- 配套增量检查清单与“常见赶工借口对照表”（如“最后一起测”“这样更快“等借口逐条给出反例），以及交叉引用同仓库
git-workflow-and-versioning（原子提交规范）和references/definition-of-done.md（项目级完成定义），三者边界划分清晰
内容为纯 Markdown 指导，不含可执行脚本。
3. 适用场景
所属分类：工程效率与代码质量
适合独立开发者与小团队工程师在让 AI agent 实现涉及多个文件的功能或重构时使用，防止 agent 一次性生成大段未验证代码导致返工排查困难；也适合团队制定“AI 辅助编码规范”时，作为可直接引用的执行纪律模板嵌入 CLAUDE.md 或类似的项目指令文件。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 官方 /plugin marketplace add 安装路径 |
| Codex | ✅ 支持 | 仓库 .codex-plugin/plugin.json 原生插件清单，聊天中用 @incremental-implementation 触发 |
| OpenClaw | ✅ 支持 | README 推荐的 npx skills add 安装器（vercel-labs/skills）Supported Agents 表格列出 OpenClaw |
| Hermes Agent | ✅ 支持 | 同一安装器 Supported Agents 表格列出 Hermes Agent |
5. 推荐理由
AI coding agent 最常见的翻车方式就是“一口气写完整个功能，测试时才发现某处早就错了，却分不清是哪一步”。本技能把“小步提交”这句老生常谈拆成可执行规则——单次增量超 100 行未测试即触发红旗、未完成功能用 feature flag 隔离、不许顺手做范围外重构——并给出可直接套用于向 agent 下指令的模板，填补“知道该小步走但不知道怎么落地成具体指令”的空白。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 该子目录有一次经核实的独立外部开发者（Sreedhar Busanelli，AI 平台架构工程师）提交并合并的实质性内容修复（“防止重复运行验证命令”的指导，已体现在正文 Red Flags 与常见借口对照表中），非批量式仓库级扫尾提交；另有独立第三方技术博主（Rachel Cantor）在个人博客中专门评述本技能并记录了它如何改变了自己的实际工作方式；仓库整体 81,189 ★ 属整个合集，不代表本子技能自身热度 |
| 可用性 | 9 | 纯 Markdown，复制即用零配置；内容完整（切片策略、实施规则、Agent 协作示例、检查清单、常见借口对照表一应俱全）；交叉引用的 references/definition-of-done.md 核实真实存在、无死链；子目录最近一次实质更新 2026-07-22，维护活跃；无付费依赖 |
| 安全性 | 9 | 纯文本方法论指导，不含可执行脚本，不联网外发，不要求任何 API Key/凭据 |
综合评分：8.3
安全检查清单：①无 shell 执行 ②无网络外发（纯文档指导） ③不要求 API Key/凭据 ④未见可疑指令或混淆内容 ⑤作者（Addy Osmani，Google 工程师）信誉良好 ⑥License 明确（MIT） ⑦最近维护 2026-07-22，活跃。
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 差异 |
|---|---|---|
| vertical-slice（codewithmukesh/dotnet-claude-kit，614★，MIT） | .NET 专属技能，教 agent 按 Vertical Slice Architecture 组织代码目录（feature folder / endpoint / handler 模式） | 只解决“代码该怎么按功能纵向分文件夹”这一种语言/框架绑定的组织问题；本技能是与技术栈无关的执行节奏方法论（怎么分批实施/测试/提交），不涉及目录结构 |
| planning（citypaul/.dotfiles，个人配置仓库） | PR 级切片规划技能，决定“一个大需求该拆成哪几个可独立合并的 PR”，需搭配同仓库另外多个技能（story-splitting、stack-pull-requests 等）协同使用 | 作用在编码开始之前的规划阶段，产出的是 plans/*.md 文件；本技能作用在编码进行中，是单次会话内“写一点、测一点、提交一点”的执行循环，可独立安装、无需配套技能 |
8. 用户评价
独立技术博主 Rachel Cantor 在个人博客 rachel.fyi 撰文评述本技能，提到“commit 即 checkpoint”这一认知转变——此前只在功能完成时才提交，受本技能影响后改为每个稳定切片完成就提交，建立可回滚的检查点，并把这套方法用到了搭建视觉回归测试、做界面布局重构等实际工作中。
9. 其他补充
仓库为该技能配备了自动化评测夹具（evals/cases/incremental-implementation.json 及对应 evals/fixtures/ 测试场景），可用于验证 agent 是否正确遵循增量实施纪律，是比“是否有人维护”更强的工程严谨度信号。
10. 安装使用方式
- 推荐方式：
npx skills add addyosmani/agent-skills --skill incremental-implementation - Claude Code 插件市场：
/plugin marketplace add addyosmani/agent-skills后/plugin install agent-skills@addy-agent-skills - Codex：
codex plugin marketplace add addyosmani/agent-skills，聊天中用@incremental-implementation触发 - 手动安装：复制
skills/incremental-implementation/目录 - 安装后无需重启；涉及“实现一个跨多文件的功能”“这段改动有点大”“要不要一次性写完”等意图时自动触发
11. 注意事项
- 单独安装不含仓库内其他子技能；正文引用的“项目级完成定义”位于
references/definition-of-done.md，若只手动复制本子目录而不带该文件会导致引用失效（官方安装器/插件市场无此问题） - 本技能只提供方法论与检查清单，不会替用户运行测试/构建命令，仍需项目自身配置好可执行的测试与构建脚本