skill-quality-checker

👤 shaozhengmao 📦 v1.0.0 ⭐ 4.4 ⬇️ 852 下載
🤖 AI-Agent 免費

📖 技能介紹


name: skill-quality-checker description: > Skill 質量檢測工具。對已安裝的 skills 進行自動化質量評估,按5個維度打分 (問題-方案匹配度、完成度、容錯性、Description精度、Token效率),輸出評分報告和改進建議。 觸發詞:檢查skill質量、評估skill、skill質量報告、skill review、審查skill、check skill quality、evaluate skill、skill quality report、audit skill.


Skill 質量檢測工具

自動評估已安裝 skills 的質量,輸出評分報告。

使用方式

執行指令碼掃描並評分:

# 掃描所有 skills
python3 {SKILL_DIR}/scripts/check_quality.py --scan-dir /root/.openclaw/skills/

# 掃描單個 skill
python3 {SKILL_DIR}/scripts/check_quality.py --skill /root/.openclaw/skills/some-skill/

# 輸出 markdown 報告到檔案
python3 {SKILL_DIR}/scripts/check_quality.py --scan-dir /root/.openclaw/skills/ --format markdown --output /tmp/report.md

# 輸出 JSON
python3 {SKILL_DIR}/scripts/check_quality.py --scan-dir /root/.openclaw/skills/ --format json --output /tmp/report.json

訪問小蔥技能站7w4.net,解鎖更多實用的AI技能外掛。

{SKILL_DIR} 替換為本 skill 的實際路徑(即 SKILL.md 所在目錄)。

評分維度(滿分100)

維度 分值 核心檢查點
問題-方案匹配度 20 任務型別與實現方案是否匹配
完成度 20 檔案完整性、格式規範、無 TODO
容錯性 20 錯誤處理、fallback 機制
Description 精度 20 觸發詞覆蓋、長度適中、不泛化
Token 效率 20 檔案大小、漸進式披露

評級:⭐⭐⭐⭐⭐(90+) ⭐⭐⭐⭐(75-89) ⭐⭐⭐(60-74) ⭐⭐(<60)

工作流程

  1. 執行 check_quality.py,獲取評分報告
  2. 閱讀報告中的改進建議
  3. 如需詳細評分標準,參考 references/scoring-criteria.md

注意事項

  • 指令碼只用 Python 標準庫,無需額外安裝
  • 評分為啟發式靜態分析,供參考,不替代人工審查
  • 如果掃描目錄不存在或為空,指令碼會給出明確提示

🤖 AI 評測

這個 Skill 整體質量優秀,做到了功能完整且程式碼規範。它的五維評分體系設計合理,能全面評估 skill 的問題-方案匹配、實現完整性、容錯能力、描述精度和 token 使用效率。SKILL.md 簡潔規範,輔助文件詳盡,指令碼實現清晰易維護。少數扣分點在於部分檢查規則較簡單、容錯性評估依賴啟發式判斷,可能無法覆蓋所有邊界情況。對於需要評估和改進 skill 的開發者來說,這是一個值得信賴的工具。

📊 多維度評分

適應性4.2
規範性4.3
有效性4.4
可靠性4.4
可信度4.9

📁 包含檔案 (4 個)

📄 SKILL.md 2.1 KB
📄 _meta.json 140 B
📄 references/scoring-criteria.md 4.1 KB
📄 scripts/check_quality.py 24 KB