incremental-implementation:一次完成一小段,別把整個功能塞進同一個 diff
用薄而完整的垂直切片實作、測試與提交,讓每一步都維持可運作狀態。
學完會知道
- 理解 incremental-implementation 在開發流程裡負責的工作
- 判斷什麼情況適合使用 incremental-implementation
- 完成通用 Skills CLI、Codex 或 Claude Code 安裝
開始前先準備
- 可使用支援 Agent Skills 的 coding agent
- 準備一個能實際驗證的小型開發任務
這個 Skill 在做什麼
用薄而完整的垂直切片實作、測試與提交,讓每一步都維持可運作狀態。
為什麼有用
大批程式碼一起落地時,很難知道是哪一步弄壞了系統。這個 Skill 要求每個切片先跑通,再擴到下一段;提交也會變成真正可回復的節點。
適合什麼場景
- 實作跨前端、API 與資料層的新功能。
- 重整範圍大,但希望每一步都能安全合併。
- 代理準備在測試前一次修改超過約 100 行。
和站內相近內容的差別
Matt Pocock 的 idea-to-ship 由 implement 編排 TDD、review 與提交。incremental-implementation 專注在切片大小和每一步都保持可運作,不依賴其他特定命令。
如何安裝
想先查看可選清單,可以執行:
npx skills add addyosmani/agent-skills --list
只安裝這一個 Skill:
npx skills add addyosmani/agent-skills --skill incremental-implementation
安裝完整 24 個 Skills:
npx skills add addyosmani/agent-skills
這個 Skill 會引用 references/definition-of-done.md。單獨安裝仍能執行主要流程,但 Skills CLI 不會帶入上游根目錄的共用 references。需要完整檢查表時,請安裝整套,或手動把這些檔案放到 Skill 能依原相對路徑讀取的位置。
手動安裝時,先 clone 上游 repo,再把整個 Skill 資料夾放進代理使用的 skills 目錄:
git clone https://github.com/addyosmani/agent-skills.git
來源資料夾是 skills/incremental-implementation/。如果上面列出共用 references,還要保留上游的相對路徑。
Codex
Codex CLI 0.122 以上可安裝整套原生外掛:
codex plugin marketplace add addyosmani/agent-skills
codex plugin add agent-skills@agent-skills
安裝後重新開啟 session。手動指定時輸入 @incremental-implementation;也可以直接描述任務,讓 Codex 依 Skill 的 description 自動選用。
Claude Code
Claude Code 可從 marketplace 安裝:
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills
此外掛也提供 /spec、/plan、/build、/test、/review、/code-simplify 與 /ship 等流程指令。這些指令會編排對應 Skills,不代表每個指令都只使用本頁這一個 Skill。
自動啟用還是手動指定
自動優先。多檔案實作一開始就適合套用,不必每次提醒代理少做一點。若只改一行文字,則不需要啟用完整流程。
在 Codex 手動呼叫的寫法:
@incremental-implementation
請依這個 Skill 的原始流程處理目前任務,完成後列出驗證證據。