hekouwang-claude-skill-doctor-skill
AI Skill 质量体检与重构工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：hekouwang-claude-skill-doctor-skill。 它的用途是：AI Skill 质量体检与重构工具 完整的 Skill 内容见：https://321skill.com/skills/hekouwang-claude-skill-doctor-skill-x-4/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
「检查我的skill规范吗？」AI会读取你提供的SKILL.md文件，从六个维度逐一评分，例如指出description触发词不全、篇幅过长未拆分、存在硬编码路径等问题，并给出优先级排序的修复建议，同时可提供重构后的代码示例。
介绍
在开发和使用 Claude/Agent Skill 的过程中，很多开发者会遇到 Skill 文件臃肿、结构混乱、触发不精准、可移植性差等问题。这个 Skill 体检器专门针对这类痛点设计，能够自动扫描你的 SKILL.md 文件，从 description 触发质量、篇幅控制、渐进披露（references/ 拆分）、脚本外置、可移植性（无硬编码绝对路径）和安全（无硬编码密钥）六个维度进行审查，并生成带有优先级的评分卡和修复建议，甚至可以代为重构代码。
使用非常简单：你只需要在对话中说出触发词，例如「检查我的 skill」「SKILL.md 体检」「这个 skill 规范吗」「claude-skill-doctor」「audit skill」「lint SKILL.md」「我的 skill 太长了」「skill 拆分」「看看我的 skill 合不合规」「skill 对齐官方规范」等，AI 就会自动读取你的 Skill 文件并执行完整审计。任何关于评估、审查或优化 Agent Skill 质量或结构的请求都会触发。
这个工具最适合智能体开发者和文档工程师，尤其是那些正在构建或维护多个 Claude/Agent Skill 的团队。无论你是想对齐官方最佳实践，还是希望将巨石 Skill 拆分为按需加载的指令包，它都能提供结构化的指引。同时也适合作为 Skill 开发流程中的自动化检查环节，在提交前做一次体检。
使用建议：首次使用前，请确保你的 Skill 文件（SKILL.md）已经存在于当前对话上下文中或可被 AI 读取。如果 Skill 中包含敏感信息，建议先移除密钥再提交审计。注意，该工具只检查 Skill 本身的结构和规范，不评估 Skill 的业务逻辑正确性。对于极简且只有几行指令的 Skill，可能不需要使用本工具。
核心特点
其他 Skill 通常只关注功能实现，而本工具专门审计 Skill 的规范性和可维护性，提供可量化的六维评分卡、按优先级排序的修复建议，并支持一键重构，是唯一一个将「Skill 元规范」作为核心能力的工具。
注意事项
不适合需要即时运行复杂任务而非审查 Skill 质量的场景，也不评估 Skill 内部业务逻辑的正确性。
常见问题
这个工具能检查我的自定义 Skill 吗？
可以，只要你的 Skill 以 SKILL.md 文件形式存在并可供 AI 读取，就可以触发审计。
评分卡里的维度有哪些？
六个维度：description 触发质量、SKILL.md 篇幅、渐进披露（references/ 拆分）、脚本外置、可移植性（无硬编码绝对路径）、安全（无硬编码密钥）。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/hekouwang-claude-skill-doctor-skill-x-4/raw/index.md 读取 hekouwang-claude-skill-doctor-skill 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/hekouwang-claude-skill-doctor-skill-x-4/raw/index.md（查看排版版本）