jsmastery-pro/skills

解決的問題

為 AI 編碼代理提供一種結構化、基於檔案的工程工作流程，防止通常在聊天會話中發生的上下文遺失。透過將專案狀態（例如範圍、規格與上下文檔案）移入倉儲本身，使工作能跨會話持續進行，並在開發團隊與代理之間共享。

如何運作

此專案實作一系列「技能」（模組化指令），AI 代理可執行這些技能將功能從構想推進至生產環境。不依賴聊天歷史，每個技能皆從倉儲中的特定檔案讀取並寫入（例如 AGENTS.md 用於上下文，docs/specs/ 用於架構）。

工作流程遵循邏輯推進：

1. 規劃：/scope 定義產品構想，/audit 初始化專案上下文。
2. 設計：/architect 為關鍵決策建立建構規格。
3. 實作：/develop 根據規格建構功能，若缺少設計決策則阻斷流程。
4. 驗證：/check verify 執行應用程式，/test 編寫測試套件，/check review 執行跨模型程式碼審查。
5. 收尾：/document 產生 PR 與變更日誌，/sync 更新專案狀態。

適用對象

使用 AI 編碼代理（如 Claude Code、Cursor、Codex 或 Gemini CLI）並希望採用專業、有紀律的軟體工程流程，而非隨意提示的開發者。

主要亮點

• 基於檔案的狀態管理：狀態儲存在倉儲中而非聊天中，因此即使會話重啟，工作也能持續。
• 深度防禦式阻斷機制：若缺少規格，/develop 會自動回退至 /architect，防止在設計前進行實作。
• 工作流程的嚴謹程度可選：根據專案需求，提供原型、Alpha、Beta、GA 等不同嚴謹程度的建議層級。
• 跨模型審查：支援在 /check review 階段使用不同 AI 模型，以確保更高程式碼品質。
• 支援單體倉儲：可將工作流程限定在特定工作區，每個工作區擁有獨立的上下文與指令。