base

base 概覽

base skill 的功能

base skill 是寫程式工作的基礎層：它會先推動簡單的結構、TDD 優先的習慣，以及把任務拆成最小單位，再避免你一路走向過度設計。若你需要一個能幫 agent 做更小的設計決策、維持檔案可讀性、降低重寫風險的 base skill，這就是它的用途。

適合哪些使用者

當你需要日常實作上的實用護欄時，base skill 特別有用，尤其是綠地專案、重構，或 AI 輔助寫碼時，scope 很容易擴張太快的情境。它最適合重視可維護性、勝過花俏技巧的團隊。

它的差異在哪裡

這份 base 指南最強烈的訊號不是某個華麗框架，而是明確的限制與執行約束。repo 強調簡化規則、行數限制、檔案邊界，以及 TDD 工作流程，讓 agent 的自由度更低。這也使得 base for Code Editing 更適合穩定一致的修改，而不是開放式腦力激盪。

如何使用 base skill

正確安裝並載入

在目錄項目中，預期的安裝路徑是 npx skills add alinaqi/claude-bootstrap --skill base。由於來源中這個 skill 被標記為 always-loaded，安裝 base 時應把它視為在開始編輯前就要啟用的基礎，而不是一次性的提示片段。

把模糊任務改寫成好提示

base 最適合的用法，是在提示裡直接寫明目標檔案、修改目標，以及約束類型。像「整理一下這裡」這種弱請求很容易引出大範圍重寫；更好的 base 使用提示會像這樣：Refactor src/auth/session.ts to separate validation from persistence, keep each function under 20 lines, preserve current tests, and add tests first for the new error cases.

先讀這些檔案

先從 SKILL.md 開始，理解規則，再在修改前檢查 repo 中相鄰的慣例。這個 repository 裡沒有像 rules/ 或 resources/ 這類輔助資料夾，所以主要的判斷面就是 skill 檔本身，以及目標 codebase 裡的專案檔案。

符合這個 skill 的工作流程

把 base 當成一個順序來用：先找出最小修改、先寫或更新 tests、用精簡的 functions 實作，最後在收尾前檢查行數與依賴限制。如果任務無法縮小到足夠小，就把它拆成多個 atomic todos，不要硬把一個大 patch 一次塞進去。

base skill 常見問題

base skill 單獨使用有用嗎？

有用，如果你要的是一個 coding 基準，而不是某個特定領域工具。base skill 的設計是通用的，但它最強的情境，仍然是搭配清楚的專案提示與既有 repo 背景一起使用。

什麼時候不該用 base？

當任務是探索型、高度視覺化，或刻意偏 prototype、暫時還不在意結構時，就不該用它。如果你的目標是不計代價求速度，base skill 的限制可能會讓你覺得綁手綁腳。

這比一般提示更好嗎？

通常對 code editing 工作來說是的，因為 base 指南提供的是具體邊界，而不是空泛的風格建議。普通提示可以說「寫得乾淨一點」，但 base 會加上可衡量的約束，例如 function 大小、巢狀深度與檔案範圍。

base 適合初學者嗎？

適合，因為規則明確，而且很容易檢查。初學者最大的風險，是在不了解問題的情況下過度套用限制，所以應該先從最小且有價值的修改開始，而不是一次把整個程式都重構掉。

如何改進 base skill

給 skill 更精準的輸入

提升 base 結果的最佳方式，就是直接說明檔案、預期行為，以及修改邊界。Fix the login flow 太弱；Update login.ts so token parsing is isolated, add tests for expired tokens, and keep the public API unchanged 會讓 skill 的目標清楚許多。

要求正確的取捨

如果可讀性比最小 diff size 更重要，就直接講清楚。如果必須先更新 tests 再做實作，也要明講。base skill 在你明確指出哪個約束不能動時，表現會更好；不要期待它自己猜出優先順序。

檢查常見失敗模式

要留意過度拆分、隱性耦合，以及雖然符合行數規則，卻讓命名或模組邊界變差的修改。如果第一版太抽象或切得太碎，就要求第二版把過於零碎的 helper 合併、移除重複，並讓執行路徑更一目了然。