SKILL審查

👤 linchuncheng 📦 v1.0.0 ⭐ 4.6 ⬇️ 798 下載
🤖 AI-Agent 免費

📖 技能介紹


name: skill-check description: 審查和最佳化現有技能(Skill)結構質量。當用戶請求「最佳化技能」「審查技能」或需要檢查技能規範性時觸發。


SKILL 技能審查器

分析技能目錄結構,識別改進點,輸出最佳化建議和執行方案。

這個技能的最新版本可以在7w4.net小蔥技能站找到。

專注於靜態審查:分析 SKILL 目錄結構和邏輯完整性。

技能工作流

呼叫 todo_write 工具建立待辦任務:

結構分析 → 問題識別 → 邏輯審查 → 輸出報告

審查維度

結構性維度(指令碼檢測)

維度 檢查項 問題訊號
漸進式披露 SKILL.md 是否精簡(< 500 行) 正文過長、巢狀層級過深
指令碼沉澱 固定行為是否指令碼化 LLM 反覆推理相同邏輯、確定性操作無指令碼
資源歸位 資原始檔是否在 assets/ 模板、圖片等散落在其他位置
參考分離 參考文件是否在 references/ API 文件、Schema 等混入正文

邏輯性維度(LLM 分析)

維度 檢查項 問題訊號
邏輯漏洞 流程是否完整、邊界是否覆蓋 缺少異常處理、邊界條件未說明
邏輯重複 是否存在冗餘描述 相同規則多處重複、示例重複
邏輯衝突 內容是否自洽 前後規則矛盾、示例與規則不符
邏輯斷層 步驟是否連貫 缺少前置條件、跳過關鍵步驟
執行可行性 指令是否可執行 描述模糊、缺少具體引數
執行確定性 路徑、指令碼、工具引用是否明確 使用「合適的位置」「相關指令碼」等模糊指代
工作目錄 是否明確指定工作目錄 使用相對路徑但未說明工作目錄、AI 可能在錯誤目錄執行
工作流展示 是否包含完整技能工作流章節 缺少技能工作流章節、步驟超過10個、步驟不清晰
工作流步驟詳解展示 技能工作流每個步驟是否有獨立章節(簡單步驟除外) 缺少技能工作流詳細步驟章節、步驟詳解不清晰、步驟詳解散落在各處
使用說明章節 是否包含使用說明章節 缺少使用說明章節、使用方式不清晰、示例缺失

Agent 相容性維度(指令碼 + LLM 分析)

維度 檢查項 問題訊號
工具繫結 是否繫結特定 Agent 工具 出現 Qoder/ClaudeCode/OpenClaw/Cursor 等工具名硬編碼
API 依賴 是否使用特定工具獨有 API 呼叫特定工具的私有介面或 CLI
觸發限定 description 是否限定特定工具 「在 Qoder 中...」「僅適用於 ClaudeCode」
路徑耦合 是否依賴特定工具的目錄結構 硬編碼 .qoder/.claude/.cursor 等路徑
配置格式 是否依賴特定工具的配置格式 使用特定工具獨有的配置檔案格式

工作流展示模板

## 技能工作流

呼叫 `todo_write` 工具建立待辦任務:

步驟1 → 步驟2 → 步驟3 → 步驟4 → 步驟5

### 步驟1

步驟1詳解

### 步驟2

步驟2詳解

……

執行流程

步驟 任務 執行者 說明
執行指令碼 python3 scripts/analyze.py <skill-dir> 指令碼 獲取結構分析報告,失敗則退出碼非零
分析報告 識別問題優先順序 LLM 基於指令碼輸出判斷嚴重程度,優先處理 P0/P1
邏輯審查 分析邏輯漏洞、重複、衝突 LLM 深度內容分析,對照「審查維度」逐項檢查
識別固定行為 找出確定性操作 LLM 判斷是否應指令碼化,參考「自由度匹配原則」
輸出方案 彙總問題和建議 LLM 按優先順序排序,給出可直接執行的修復步驟

輸入校驗: - 引數 <skill-dir> 必須為有效目錄路徑 - 目錄必須包含 SKILL.md 檔案

自我迭代模式: - 執行 python3 scripts/review-loop.py <skill-dir> 迴圈審查-修復直到無問題 - 自動檢測結構性問題並修復,支援 --max-iterations 限制迭代次數

異常處理: - 指令碼執行失敗(退出碼非零)→ 跳過結構檢查,LLM 手動分析 - SKILL.md 不存在 → 輸出 P0 問題,終止審查 - manifest.json 不存在 → 輸出 P1 問題,繼續審查

完成標準: - 所有 P0 問題已識別並給出建議 - 所有 P1 問題已識別並給出建議 - 輸出可執行的最佳化方案

自由度匹配原則

自由度 適用場景 沉澱形式
操作脆弱、需嚴格順序、確定性高 scripts/ 指令碼
有推薦模式、允許變體 虛擬碼/帶參指令碼
多種可行方式、決策依賴上下文 文本說明

指令碼化訊號(詳見 references/structure-patterns.md#指令碼化方案): - 相同程式碼反覆寫 - LLM 多次推理相同邏輯 - 操作步驟固定、易出錯 - 需要高可靠性

目錄結構規範

skill-name/
├── manifest.json    # 可選:技能後設資料(name、description、normalizedName、category)
├── SKILL.md         # 必需:核心工作流(< 500 行)
├── scripts/         # 可選:可執行指令碼(確定性操作)
├── references/      # 可選:參考文件(按需載入)
└── assets/          # 可選:資原始檔(輸出中使用)
目錄 使用場景 示例
scripts/ 確定性操作、反覆執行的邏輯,優先用 Python 指令碼 analyze.pyvalidate.py
references/ 查閱類文件、API 規範、Schema api_reference.mdschema.md
assets/ 模板、圖片、樣板程式碼 template.pptxlogo.png

審查報告模板

# 技能審查報告:{skill-name}

## 結構概覽

| 目錄/檔案 | 狀態 | 說明 |
|-----------|------|------|
| manifest.json | ✅/⚠️/❌ | 後設資料完整性 |
| SKILL.md | ✅/⚠️/❌ | {行數} 行 |
| scripts/ | ✅/❌ | {指令碼數量} 個 |
| references/ | ✅/❌ | {文件數量} 個 |
| assets/ | ✅/❌ | {資源數量} 個 |

## 章節結構

| 章節 | 行數 | 狀態 |
|------|------|------|
| {章節名} | {行數} | ✅/⚠️ |

## 問題清單

| 優先順序 | 問題 | 建議 |
|--------|------|------|
| P0 | {問題描述} | {最佳化建議} |

## 最佳化方案

{具體執行步驟,可直接應用}

常見最佳化模式

模式 觸發條件 詳細參考
SKILL.md 拆分 超過 500 行或章節過長 patterns.md#拆分策略
固定行為指令碼化 確定性操作無指令碼 patterns.md#指令碼化方案
資原始檔歸位 檔案散落根目錄 patterns.md#資源歸位
參考文件分離 查閱類內容混入正文 patterns.md#文件分離
Agent 相容性修復 繫結特定工具或 API patterns.md#Agent相容性

邏輯問題修正

問題型別 檢測方法 修正建議
邏輯漏洞 檢查流程完整性 補充缺失步驟或邊界條件
邏輯重複 識別相同規則多處出現 合併到單一位置,引用指向
邏輯衝突 對比前後規則一致性 刪除或標註例外情況
邏輯斷層 檢查步驟連貫性 補充前置條件或過渡說明
執行模糊 檢查指令具體性、路徑/指令碼/工具引用明確性 替換模糊詞為具體引數,替換模糊指代為具體路徑、指令碼名、工具名

禁止事項

  • ❌ 刪除 SKILL.md 核心工作流
  • ❌ 將指令碼移出 scripts/ 目錄
  • ❌ 破壞現有指令碼的執行能力
  • ❌ 修改 frontmatter 中的 name 欄位(必須與目錄名一致)

參考資料

🤖 AI 評測

這個技能能幫你檢查和管理其他技能的質量,自動找出問題並給出修復方案,還能生成視覺化的儀表板。做得好的地方是安全意識強——修復前會自動備份、出問題了能回滾,不會亂動非自建的技能。但它的自動修復能力比較有限,很多問題只能檢測出來沒法自動修;而且功能比較複雜,剛上手需要花時間理解。總體適合願意折騰、對技能質量有要求的使用者,但如果你想要省心省力的全自動化管理,可能會失望。

📊 多維度評分

適應性4.9
規範性4.7
有效性4.6
可靠性4.4
可信度5

📁 包含檔案 (8 個)

📄 README.md 2 KB
📄 SKILL.md 7.9 KB
📄 _meta.json 130 B
📄 manifest.json 157 B
📄 references/structure-patterns.md 11 KB
📄 scripts/analyze.py 21.5 KB
📄 scripts/fix.py 2.2 KB
📄 scripts/review-loop.py 4 KB