agent-auditor
一个用于审计Claude Code技能合规性与有效性的Python工具。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：agent-auditor。 它的用途是：一个用于审计Claude Code技能合规性与有效性的Python工具。 完整的 Skill 内容见：https://321skill.com/skills/agent-auditor/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我审计一下刚开发的‘数据可视化’技能。”，它会引导你运行 `skill-auditor ./claude/skills/data-visualization` 命令，快速给出技能是否“就绪”的结论，并列出所有合规性问题。如果遇到复杂错误，你可以加上 `--explain` 参数，让它调用Claude为你提供详细的修复建议。
介绍
Agent Auditor 是一个专门为 Claude Code 技能设计的审计工具，旨在解决开发者在创建和部署技能时面临的合规性与可靠性问题。它通过自动化检查，确保技能符合 Anthropic 的官方规范，并能被系统可靠地自动调用，从而避免技能因格式错误或设计缺陷而失效。
该工具提供三种使用模式：快速模式通过Python SDK进行确定性验证，即时免费；解释模式则调用AI对问题进行深入分析并提供修复建议；混合模式输出结构化的JSON数据，便于其他智能体或系统集成。用户只需提供技能目录路径即可运行审计。
它非常适合智能体开发者、全栈开发者和负责技能质量保障的运维工程师使用。这些角色在开发、测试或部署Claude Code技能时，需要确保其质量和合规性。
建议开发者在技能开发完成后、提交到仓库前或部署前运行此工具进行质量检查。对于复杂问题，可以使用解释模式获取AI的详细建议。注意，解释模式会产生少量API调用费用。
核心特点
与通用代码检查工具不同，它专门针对Claude Code技能的官方规范进行深度审计，并能验证技能的自动触发能力。其混合模式输出的结构化JSON，为智能体工作流集成提供了便利。
注意事项
该工具主要针对Claude Code技能，不适用于审计其他AI平台（如OpenAI GPTs）的技能或通用软件项目。
常见问题
Agent Auditor 能检查哪些具体问题？
它能检查技能结构合规性、YAML格式、文件完整性、描述质量以及自动调用潜力等，具体包括B1-B5的阻塞性问题和W1-W2的警告性问题。
使用解释模式(--explain)需要付费吗？
是的，解释模式会调用Claude AI进行分析，每次调用约产生0.004美元的成本，而快速模式和混合模式是完全免费的。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/agent-auditor/raw/index.md 读取 agent-auditor 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/agent-auditor/raw/index.md（查看排版版本）