適用於 Openclaw 的 Skill Validator

一款專業的稽核工具,旨在根據 Anthropic 和 Openclaw Skills 官方規範來測試、評分及優化 AI agent 技能。

youngfreefjs
v0.1.0
Apr 2, 2026
1
753
0

安裝與下載

1. ClawHub CLI

從來源直接安裝技能的最快方式。

npx clawhub@latest install skill-test-skill

2. 手動安裝

將技能資料夾複製到以下位置之一

全域模式
~/.openclaw/skills/
工作區
<project>/skills/

優先級:工作區 > 本地 > 內建

3. 提示詞安裝

將此提示詞複製到 OpenClaw 即可自動安裝。

請幫我使用 Clawhub 安裝 skill-test-skill。如果尚未安裝 Clawhub,請先安裝(npm i -g clawhub)。

想要直接下載?

取得包含原生技能檔案的ZIP壓縮檔。

什麼是 Skill Validator?

Skill Validator 是一款開發者導向的實用工具,確保您的自定義 AI 能力符合生產環境所需的嚴格標準。透過分析目錄結構、YAML frontmatter 和內文內容,它協助開發者建構高品質的 Openclaw Skills,使其觸發更精準、執行更可靠。

該技能提供了一種自動化方式,可在六個關鍵維度(包括漸進式揭露設計與觸發優化)上對技能品質進行評分。它將複雜的規範轉化為可執行的回饋,確保從 SKILL.md 文件到配套腳本的每一個組件都針對 agentic 工作流進行了優化。

Skill Validator 應用場景

  • 稽核新的技能儲存庫以確保符合 Openclaw Skills 標準。
  • 在使用者對話期間除錯為何 agent 技能無法正確觸發。
  • 獲取內部開發基準的標準化品質評分 (0-100)。
  • 在將 SKILL.md 文件發佈到註冊表之前產生詳細的改進報告。

Skill Validator 運作原理

  1. 使用者向 agent 提供本地路徑、GitHub URL 或原始的 SKILL.md 描述。
  2. 驗證器遞迴列出並讀取技能目錄中的所有文件,包括腳本、引用和資源。
  3. 它解析 YAML frontmatter 以驗證 Openclaw Skills 的名稱、描述和元資料要求。
  4. 系統評估內文內容的指令迫切性、工作流清晰度及架構設計。
  5. 產生一份包含總分、等級狀態和優先級改進建議的綜合 Markdown 報告。

Skill Validator 設定指南

要在本地環境中使用 Skill Validator,請確保您的 AI agent 可以存取您的技能目錄。您可以透過直接提供路徑來啟動檢查。

# 透過 prompt 觸發驗證的範例
Check my skill at ./skills/my-new-tool/

# 或驗證遠端儲存庫
Score this skill: https://github.com/user/repo/tree/main/skills/test-skill

如果驗證器已整合到您的 Openclaw Skills 工作區中,則無需安裝額外的二進位檔案。

Skill Validator 資料結構與分類體系

驗證器使用多維評分標準來組織其發現並評估 Openclaw Skills 架構。

維度 最高分 重點領域
目錄結構 10 正確的文件放置和命名規範
Frontmatter 30 YAML 驗證、描述長度和欄位合規性
內文內容 25 指令品質、祈使格式和工作流清晰度
漸進式揭露 15 高效的 context window 管理和資源拆分
可選目錄 10 腳本和參考文件的品質及文檔記錄
觸發優化 10 觸發關鍵字的有效性和推送力度

分數分為從優秀 (90-100) 到嚴重問題 (0-39) 等不同等級。

Skill Validator 進階特性

  • 自動語言偵測(英語和中文),用於根據使用者輸入產生在地化的稽核報告。
  • 對腳本檔案進行深度分析,以確保 Openclaw Skills 內的錯誤處理和文檔記錄穩健。
  • 漸進式揭露稽核,透過建議對大型資料集使用參考檔案來防止 context window 膨脹。
  • 高精度觸發分析,透過優化的描述欄位提高 AI agent 呼叫技能的可靠性。

SKILL.md


加載中

Openclaw 相關技能

METADATA

Github Stars: 0
forks: 0

精選*