incremental-implementation skill 是什麼、怎麼安裝使用：讓 AI 一小片一小片地改代碼，每片都能跑

本文根據 addyosmani/agent-skills 倉庫裏該技能的 SKILL.md 與倉庫 README 整理，資料核對於 2026-10-11。所在倉庫 addyosmani/agent-skills 在 GitHub 約 10.4 萬 Star（同日數據）。技能內容會隨倉庫更新，以倉庫為準。

這個 Skill 做什麼

編程智能體的一個通病是「一口氣寫完」：一次改十幾個文件，最後發現跑不起來，也分不清是哪一步出的錯。incremental-implementation 規定了另一種節奏。description：以薄的、可驗證的切片增量交付改動；在實現任何涉及多個文件的功能或改動、從計劃裏領取下一個任務、用功能開關逐步放出改動、正準備一次寫大量代碼，或任務大到沒法一步落地時使用。

增量循環五步：實現最小的一塊完整功能 → 跑測試（沒有就先寫一個）→ 驗證這一片確實可用 → 提交 → 進入下一片，接着往前走而不是推倒重來。SKILL.md 給了一個經驗信號：在測試之前想寫超過一百行左右的代碼時，就該切片了。

三種切法：

• 縱向切片（首選）：每一片都打通一條從介面到數據的完整路徑，做完就能用；
• 契約先行：前後端要並行開發時，先定接口再各自實現；
• 風險先行：先做最沒把握的那一塊，失敗了也是在投入更多之前發現。

實施規則從 0 號開始編號：

• 規則 0，簡單優先——先寫最樸素、明顯正確的版本；三行相似的代碼好過一個過早的抽象。
• 規則 0.5，範圍紀律——只碰任務需要的地方；不順手「清理」旁邊的代碼，不整理沒在改的文件裏的導入，不刪自己沒看懂的註釋，不加規格里沒有的功能。發現值得改的地方就記下來，不動手。
• 規則 1，一次只做一件事。
• 規則 2，保持可編譯——每一片之後項目都能構建、已有測試都通過。
• 規則 3，沒做完的功能放在功能開關後面。
• 規則 4，安全的預設值。
• 規則 5，便於回滾。

之後是與智能體協作的要點、每片的檢查清單，以及這個庫每個技能都有的「常見的自我開脫」「危險信號」「驗證」三節。

怎麼安裝

倉庫 README 給出了單獨安裝某個技能的寫法：

bash
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 加 codex plugin add agent-skills@agent-skills。README 提示，插件安裝遇到 SSH 權限報錯時改用倉庫的 HTTPS 地址。

倉庫整體介紹和其他安裝方式，詳見本站《addyosmani/agent-skills 是什麼、怎麼安裝：Addy Osmani 的 25 個生產級工程 Skills（/spec、/plan、/build）》。

怎麼用

• 「按 incremental-implementation 的方式實現這份計劃，每完成一片就停下來讓我看」。
• 「這個重構涉及二十多個文件，先告訴我你打算怎麼切」。
• 整套安裝後，它通常由 /build 命令在實現階段帶出來。

適合誰 / 侷限

適合讓智能體做中等以上規模改動的人，尤其是被「改完一大堆卻跑不起來」折騰過的。侷限：切片越細，測試和提交的次數越多，速度會慢一些；項目沒有測試時，「驗證」只能靠構建和手工檢查，效果打折扣；單文件的小修改用不着它，SKILL.md 自己也這麼說。

注意事項

• 許可：MIT。
• 不帶腳本：純說明文字。
• 會頻繁提交：如果你對提交歷史有要求，事先說明提交資訊的規範，或讓它在獨立分支上工作，合併前再整理。