rwrife/skill-sniffer

skill-sniffer 是做什麼的？

一款適用於技能時代的 ESLint：一款偏執、離線的 CLI 工具，用於對您的 SKILL.md / agent-skill 檔案進行 lint 檢查、審計與評分，找出機密、提示注入誘餌、Token 膨脹、損壞路徑及過度寬泛的工具授權。

功能

• 機密掃描：檢測檔案中是否意外包含 API 金鑰、密碼或其他敏感字串。
• 提示注入防護：標記可能的提示注入誘餌，例如指令覆寫或間接提示操縱。
• Token 膨脹分析：識別不必要的冗長內容，降低 Token 消耗，提升模型處理效率。
• 路徑完整性檢查：驗證技能中引用的所有檔案路徑是否有效且無損壞。
• 工具授權審計：檢查授予 AI 代理的工具權限是否過於寬泛，潛在安全風險。
• 評分系統：為每個技能提供綜合健康評分，幫助開發者優先處理問題。

用法

在技能專案根目錄下執行：

npx rwrife/skill-sniffer

或安裝後使用：

npm install -g rwrife/skill-sniffer
skill-sniffer

選項

• --path <path>：指定要掃描的技能檔案路徑（預設為當前目錄下的 SKILL.md）。
• --output <format>：輸出格式（支援 json、table、summary）。
• --no-color：禁用輸出著色。
• --score-only：僅顯示分數，不輸出詳細報告。

範例

# 掃描當前目錄的 SKILL.md
npx rwrife/skill-sniffer

# 掃描指定檔案
npx rwrife/skill-sniffer --path ./agent-skill.md

# 以 JSON 格式輸出
npx rwrife/skill-sniffer --output json

整合

可整合至 CI/CD 管線（如 GitHub Actions、GitLab CI），確保每次提交皆自動檢查技能檔案品質。

支援平台

• Claude Code
• Coder
• Codex
• 其他支援 SKILL.md 或 agent-skill 格式的代理平台

授權

MIT