incremental-implementation

漸進式實作技能概覽

incremental-implementation 技能能幫你把程式碼拆成一小段一小段、可正常運作的切片來交付，而不是想一次把大型變更做完。對於 incremental-implementation 的 Code Editing 工作流程來說，當任務跨越多個檔案、需要測試，或風險高到不適合一次大改時，這個技能特別適合。

當你想在不犧牲正確性的前提下，穩穩推進功能時，它很有用。它要完成的核心工作很簡單：把工作拆成一連串「實作 → 測試 → 驗證」的步驟，讓每個切片都保持可審查、可測試，而且一旦出問題也比較容易回復。

最適合的情境與重要原因

這個技能很適合功能開發、重構，以及那些第一版很容易超出你能一次自信驗證範圍的變更。相較之下，對於單一檔案的小改動，它就沒那麼必要，因為切片化帶來的額外流程反而比價值還多。

它有什麼不同

不同於一般只會說「迭代式工作」的提示，incremental-implementation 提供的是具體的執行模式：先做最小且完整的變更，驗證後再往下走。這種紀律能降低隱性耦合，把回歸問題侷限在局部，也能幫助 agent 在回饋回來之前避免過度設計。

使用者最在意什麼

讀者通常最在意的是：這個技能是否真的能降低風險、需要多少規劃、會不會拖慢速度。答案是：它應該能透過避免重工來加速高難度任務，但前提是你願意先定出切片邊界，並且對每一步都做驗證。

如何使用 incremental-implementation 技能

安裝技能並找到來源

使用以下指令安裝 incremental-implementation install 套件：

npx skills add addyosmani/agent-skills --skill incremental-implementation

接著先閱讀 SKILL.md。在這個 repo 裡，它就是主要依據；沒有額外的 rules/、references/ 或輔助腳本要你再去追。若你想要最快上手，先從「何時使用」和「增量循環」那幾節看起。

把模糊任務拆成切片

最佳的 incremental-implementation usage 會從一個本來就已經拆成成果項目的任務開始，而不是一個龐大的一句話需求。好的輸入像這樣：

• 「把使用者個人檔案編輯拆成三個切片：表單渲染、儲存 API、驗證／錯誤狀態。」
• 「逐步重構 parser：保留既有行為，先加測試，再搬移邏輯。」
• 「實作 dashboard 篩選器，先做出可用 UI，再做持久化，最後處理邊界情況。」

不好的輸入像是：「讓 app 支援 profiles。」這會逼技能去猜切片邊界，而這正是實作品質最容易下降的地方。

跟著循環走，不要一次想完整個功能

一個好的 incremental-implementation guide 會是：先實作最小的完整切片，執行相關測試或建置，驗證行為，然後再進下一個切片。如果某個切片無法測試，就把它切小；如果無法驗證，那它大概還是太大了。

Code Editing 的實務工作流程

對於 incremental-implementation for Code Editing，要請 agent 在每一步之後保留可運作狀態，避免大範圍重寫。可用的提示語型如下：

Use incremental-implementation. Break this task into 3-5 slices. For each slice, change only the necessary files, explain the test or verification step, and stop if the slice would leave the app broken.

這樣的提示有幫助，因為它限制範圍、強迫加入檢查點，也讓 agent 在動太多程式碼之前先把取捨攤開來。

incremental-implementation 技能 FAQ

incremental-implementation 只適合大功能嗎？

不是。只要一次做完的修改會增加風險，它就有用。當你需要測試、有跨檔依賴，或預期第一輪嘗試會暴露未知問題時，incremental-implementation skill 特別有幫助。

我需要把整個工作流程都改掉嗎？

不用。你可以維持原本的工具鏈，只要調整執行順序：先切片、再驗證、然後繼續。這個技能重點是實作紀律，不是新的 framework 或工具組。

什麼情況下不該用？

如果只是單一函式或單一檔案，而且已經很直接明確的修補，就可以跳過。任務很小、理解也很清楚時，增量規劃反而會帶來不必要的繁文縟節。

初學者也適合嗎？

適合，只要你能用基本層級描述功能，並接受分步前進。對有經驗的開發者也一樣有幫助，因為它能避免「差不多完成」的程式碼在沒有驗證的情況下越堆越多。

如何改進 incremental-implementation 技能

給出更好的切片邊界

最大的品質提升來自於你清楚告訴 agent 每個切片要在哪裡結束。可以加上像這樣的限制：「每一步後都要保持 app 可建置」、「在 UI 跑通之前不要動 schema」、「先加測試，再碰 API layer」。這些邊界會讓 incremental-implementation usage 更可靠。

先提供正確的上下文

先把入口點、現有檔案和所有硬性限制一次交代清楚：framework 版本、測試指令、migration 限制、或哪些檔案不能動。如果 agent 必須在過程中自己發現這些條件，它可能會選出形式上是增量、實際上卻很難合併的切片。

注意最常見的失敗模式

最常見的失敗模式，是某個切片太大，沒辦法乾淨地驗證。如果第一版輸出看起來太廣，請它改成更小的下一步、更緊的測試計畫，或更窄的檔案範圍。通常先縮小範圍，再動手改碼，效果會比改完才回頭修好得多。

每個切片之後都要迭代

把第一輪當成計畫，而不是最終答案。每做完一個切片，就回報哪些通過、哪些壞掉、哪些地方還有風險。這個回饋迴圈，正是 incremental-implementation 技能最有價值的地方：它能把一次性的需求，變成一連串受控的程式碼修改。