77 lines
3.5 KiB
Markdown
77 lines
3.5 KiB
Markdown
---
|
||
name: skill-stocktake
|
||
description: "用於稽核 Claude 技能與指令品質的功能。支援「快速掃描」(僅針對有變動的技能) 與「全面盤點」(Full Stocktake) 模式，採用子 Agent 循序進行批次評估。"
|
||
---
|
||
|
||
# 技能盤點技能 (Skill Stocktake Skill)
|
||
|
||
斜線指令 (`/skill-stocktake`) 用於掃描並稽核所有 Claude 技能與指令。透過品質檢查清單與 AI 綜合判斷，提供修復、更新或汰換建議。支援兩種模式：針對近期變動進行的「快速掃描」，以及全量審視的「全面盤點」。
|
||
|
||
## 掃描範圍
|
||
|
||
此指令針對**調用目錄的相對路徑**進行掃描：
|
||
|
||
| 路徑位置 | 說明 |
|
||
|------|-------------|
|
||
| `~/.claude/skills/` | 全域技能 (適用於所有專案) |
|
||
| `{cwd}/.claude/skills/` | 專案級技能 (若目錄存在則包含) |
|
||
|
||
**在執行第一階段 (Phase 1) 時，指令會明確列出偵測到的路徑及其掃描狀態。**
|
||
|
||
### 針對特定專案進行盤點
|
||
|
||
若要包含專案級技能，請在該專案的根目錄下執行：
|
||
|
||
```bash
|
||
cd ~/path/to/my-project
|
||
/skill-stocktake
|
||
```
|
||
|
||
## 執行模式
|
||
|
||
| 模式名稱 | 觸發條件 | 預期耗時 |
|
||
|------|---------|---------|
|
||
| **快速掃描 (Quick Scan)** | 存在 `results.json` 快取 | 5–10 分鐘 |
|
||
| **全面盤點 (Full Stocktake)** | 缺失 `results.json` 或強行執行 `/skill-stocktake full` | 20–30 分鐘 |
|
||
|
||
## 執行流程
|
||
|
||
### 第一階段 — 資源盤點 (Inventory)
|
||
調用腳本列舉所有技能檔案、擷取 Frontmatter 資訊並收集檔案最後修改時間 (mtime)。
|
||
|
||
### 第二階段 — 品質評估 (Quality Evaluation)
|
||
啟動 Task 子 Agent 針對盤點清單進行深度審查。評估維度包含：
|
||
- **可執行性**：是否具備可立即操作的程式碼範例或指令。
|
||
- **範圍適切性**：名稱、觸發條件與內容是否對齊；不應過於寬泛或過於瑣碎。
|
||
- **唯一性**：內容是否無法被 `MEMORY.md` 或其他現有技能取代。
|
||
- **時效性**：所引用的技術版本、API 或參數在當前環境下是否依然有效。
|
||
|
||
#### 判定標準 (Verdicts)
|
||
| 判定結果 | 具體定義 |
|
||
|---------|---------|
|
||
| **保留 (Keep)** | 功能實用且符合當前技術現狀。 |
|
||
| **優化 (Improve)** | 值得保留，但需要具體的內容改進。 |
|
||
| **更新 (Update)** | 引用技術已過時（需透過網頁搜尋驗證新版本）。 |
|
||
| **汰換 (Retire)** | 品質低劣、內容陳舊或維護成本過高。 |
|
||
| **合併至 [X]** | 與其他技能有重大重疊，標註合併目標。 |
|
||
|
||
### 第三階段 — 摘要表產出 (Summary)
|
||
整理所有技能的盤點結果，包含判定理由與建議動作。
|
||
|
||
### 第四階段 — 執行鞏固 (Consolidation)
|
||
1. **汰換/合併**：在用戶確認前，提示詳細的判定理由與替代方案。
|
||
2. **優化建議**：提供具體的修改方案（如：刪除重複段落、精簡篇幅）。
|
||
3. **知識壓縮**：檢查 `MEMORY.md` 長度，若過長則建議進行壓縮。
|
||
|
||
## 結果記錄檔案語法
|
||
|
||
快取路徑：`~/.claude/skills/skill-stocktake/results.json`
|
||
|
||
此檔案完整記錄每次盤點的時間、模式、進度以及各項技能的判定明細，確保盤點工作可續傳且具備可追溯性。
|
||
|
||
## 重要準則
|
||
|
||
- **盲測原則**：所有技能不論來源為何，皆適用同一套檢查清單進行評估。
|
||
- **顯式確認**：任何涉及刪除或封存檔案的操作，均必須獲得用戶的明確授權。
|
||
- **理由充分性**：判定理由必須具備決策參考價值，嚴禁僅填寫「無變動」等單薄字眼。
|