Claude Code Skills 總覽
AppFuse 提供 19 個 Claude Code Skill,涵蓋從產品規劃到工程實作的完整流程。本頁面是所有 Skill 的快速參考索引。
變更紀錄
2026-03-03:/init-project 已刪除,由 /scaffold-project v2 + /add-module 取代。
總覽
| Skill | 指令 | 用途 | 模式 |
|---|---|---|---|
| Roadmap 撰寫 | /roadmap | 協助撰寫產品路線圖 | 對話式(澄清循環) |
| 領域模型撰寫 | /domain-model | 建立或修訂領域模型 | 對話式(澄清循環) |
| 功能清單管理 | /feature-list | 建立或修訂功能清單 | 自適應(一次性/對話式) |
| Epic 撰寫 | /epic | 協助撰寫 Epic 文檔 | 對話式(澄清循環) |
| User Story 撰寫 | /us | 協助撰寫 User Story | 對話式(澄清循環) |
| SBE 場景生成 | /sbe | 從 US 產生 SBE 場景草稿 | 一次性生成 |
| 需求品質檢核 | /checklist | US 需求品質 7 維度檢核 | 一次性生成(唯讀) |
| 一致性分析 | /analyze | 跨文件一致性分析(5 通道) | 一次性生成(唯讀) |
| E2E 測試生成 | /e2e | 從 SBE 產生 Playwright E2E 測試 | 一次性生成 |
| 手動測試指南 | /test-plan | 從 US+SBE 產生手動測試指南 | 一次性生成 |
| Sprint 規劃 | /sprint | 盤點 US 庫存規劃 Sprint Backlog | 混合式(2-3 輪) |
| API 規格生成 | /api-spec | 從 US/SBE 正向設計或從 Controller 反向萃取 API 規格 | 一次性生成 |
| TS 診斷修復 | /fix-diagnostics-ts | 修復 TypeScript 編譯警告 | 一次性修復 |
| Java 診斷修復 | /fix-diagnostics-java | 修復 Java 編譯警告 | 一次性修復 |
| 前端框架升級 | /upgrade-appfuse-web | 升級 @appfuse/appfuse-web | 一次性執行 |
| 後端框架升級 | /upgrade-appfuse-server | 升級 appfuse-server | 一次性執行 |
| 框架發布 | /publish | 發布 @appfuse/appfuse-web 到私有 registry | 一次性執行 |
| 專案腳手架 | /scaffold-project | 建立新專案骨架(目錄結構、project.json) | 一次性執行 |
| 新增模組 | /add-module | 從參考實作複製模組並套用識別 | 多次執行 |
分類
規格撰寫(6 個)
產品規格從上游到下游的撰寫工具鏈。越上游越依賴人的判斷,越下游越適合 AI 自動化。
| Skill | 說明 |
|---|---|
/roadmap | 透過蘇格拉底式澄清循環,協助從構想到完整 Roadmap,涵蓋戰略主題、用戶角色、核心 Epic。完成時附帶產出 Feature List |
/domain-model | 透過蘇格拉底式澄清循環,協助建立概念層級的領域模型,定義業務實體、關聯關係與統一語言。始終 Level 2 對話式 |
/feature-list | 功能清單管理工具,自適應模式:有 Roadmap 時一次性生成,無 Roadmap 時對話式協助建立,既有 Feature List 時對話式修訂 |
/epic | 從 Roadmap 脈絡出發,透過澄清循環協助撰寫 Epic,含業務目標、功能範疇、US 列表 |
/us | 透過澄清循環從想法到完整 US,包含驗收標準、業務規則、技術規格 |
/sbe | 從 US 文檔自動產生 SBE 場景草稿,供 Three Amigos 審查 |
詳細說明(閉環模型、分類法、借鑑 Spec Kit 等)請見 AI 協助規格撰寫指南。
品質分析(2 個)
兩個唯讀分析工具,絕不修改原始檔案,報告中的建議行動連結到具體 Skill 指令。
| Skill | 說明 |
|---|---|
/checklist | 基於 7 大品質維度(Completeness、Clarity、Consistency、Measurability、Coverage、Edge Case、Non-Functional)對單一 US 進行品質檢核 |
/analyze | 透過 5 通道分析(結構完整性、覆蓋率、一致性、術語一致性、規格品質)檢查 Roadmap → Epic → US → SBE 文檔鏈的對齊度 |
測試與規劃(3 個)
從規格產生測試與排程,銜接規格撰寫與工程實作。
| Skill | 說明 |
|---|---|
/e2e | 從 SBE 場景產生 Playwright E2E 測試碼,遵循既有測試慣例與 helper 函數 |
/test-plan | 從 US 驗收標準與 SBE 場景產生手動測試指南,聚焦 UX 細節、響應式、無障礙、安全性 |
/sprint | 盤點可用 US 庫存(優先級、SP、SBE 就緒度),透過互動式對話協助選取 Sprint 範圍並產生 Sprint 文檔 |
工程實作(8 個)
涵蓋 API 規格、程式碼品質、框架升級發布、專案建立。
| Skill | 說明 |
|---|---|
/api-spec | 從 US/SBE 正向設計或從 Spring Controller 反向萃取 API 規格,產生 Bruno (.bru) 格式 |
/fix-diagnostics-ts | 修復 TypeScript 未使用 import/變數、ESLint、SonarQube 問題,不改變程式邏輯 |
/fix-diagnostics-java | 修復 Java 未使用 import/變數、SonarQube、Null Safety 警告,不改變程式邏輯 |
/upgrade-appfuse-web | 升級所有使用 @appfuse/appfuse-web 的模組,自動比對 peer dependencies 變更 |
/upgrade-appfuse-server | 升級所有使用 appfuse-server 的模組,修改 build.gradle.kts 版本號 |
/publish | 發布 @appfuse/appfuse-web 到私有 npm registry,含版本建議、Commit、Tag 管理 |
/scaffold-project | 建立新專案骨架(目錄結構、共用配置、project.json),不複製模組 |
/add-module | 從 AppFuse 參考實作複製模組到現有專案,套用識別(npm scope、Gradle group、Java package),支援延遲收集 |
工作流程鏈
規格撰寫流程
/roadmap → 產出 Roadmap + Feature List
↓
/domain-model → 對話式建立領域模型(實體、關聯、術語)
↓
/feature-list → 獨立建立或修訂 Feature List(自適應模式)
↓
/epic → 產出 Epic 文檔
↓
/us → 產出 US 文檔
↓
/checklist → 品質檢核(唯讀)
↓
/sbe → 產出 SBE 場景
├→ /e2e → 產出 E2E 自動化測試(Playwright)
├→ /test-plan → 產出手動測試指南
└→ /sprint → 規劃 Sprint Backlog + 更新 Feature List 狀態
↓
/api-spec → 產出 API 規格(正向設計或反向萃取)
↕ 任何階段皆可執行
/analyze → 跨文件一致性分析(唯讀)
客戶委託替代路徑:無 Roadmap 的專案可從
/feature-list(對話式)開始,取代/roadmap作為最上游文檔。
專案建立流程
/scaffold-project → 建立專案骨架(一次)
↓
/add-module → 增量新增模組(多次,依階段)
├→ 提案:web-mockup, docs
├→ 成案:server, web
└→ 部署:web-host, docs-host
框架升級與發布流程
(框架變更後)
/publish → 發布到私有 registry
↓
/upgrade-appfuse-web → 升級依賴此框架的模組
/upgrade-appfuse-server → 升級依賴後端框架的模組
程式碼品質維護
/fix-diagnostics-ts → 修復 TypeScript 編譯警告
/fix-diagnostics-java → 修復 Java 編譯警告
相關資源
- AI 協助規格撰寫指南 — 規格類 Skill 的詳細說明(閉環模型、分類法、借鑑來源)
- ADR-001: AI 協助規格撰寫策略 — 採用蘇格拉底式閉環模式的決策與權衡
最後更新: 2026-03-02