hekouwang-claude-skill-doctor-skill
Agent Skill 质量体检器，评分卡+修复建议
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：hekouwang-claude-skill-doctor-skill。 它的用途是：Agent Skill 质量体检器，评分卡+修复建议 完整的 Skill 内容见：https://321skill.com/skills/hekouwang-claude-skill-doctor-skill-x/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“检查我的 skill / SKILL.md 体检 / 这个 skill 规范吗”，AI 会自动读取你的 SKILL.md 文件，从 description 触发质量、篇幅、拆分情况、脚本外置、硬编码路径、密钥安全等六个维度生成评分卡，并按优先级列出修复建议，你还可以要求它直接代为重构，例如将过长的指令拆分为多个 references/ 子模块。
介绍
这个 Skill 专门用于审查 Claude/Agent Skill 的文件结构和最佳实践。它能自动检查你的 SKILL.md 描述是否触发精准、篇幅是否过长、是否按模块拆分为 references/ 目录、脚本是否外置、路径是否硬编码、密钥是否明文暴露，并给出六个维度的评分卡。
使用时，只需对 AI 说“检查我的 skill”、“SKILL.md 体检”、“这个 skill 规范吗”等任意触发词，AI 就会读取你的 Skill 文件，逐一分析并输出带优先级的修复建议，你还可以要求它直接代为重构。
适合所有开发和维护 Agent Skill 的用户，尤其是智能体开发者、全栈工程师和希望规范 team 技能库的项目经理。对刚接触 Claude 官方技能规范的新手尤为友好。
注意：本 Skill 聚焦于指令包的结构和元信息质量，不负责检查业务逻辑正确性、外部 API 可用性或运行时性能。建议在 CI 流程中作为门禁使用，每次修改 Skill 后运行一次。
核心特点
其他代码质量工具只检查通用代码规范，而本 Skill 专门针对 Claude/Agent Skill 的“按需加载指令包”最佳实践，提供评分卡和可执行的重构方案。
注意事项
不适合检查非 Agent Skill 的普通代码项目，或需要深度安全漏洞扫描的场景。
常见问题
这个 skill 能检查哪些方面？
检查 description 触发质量、SKILL.md 篇幅、渐进披露（references/ 拆分）、脚本外置、可移植性（无硬编码绝对路径）、安全（无硬编码密钥），并给出评分卡和修复建议。
我的 SKILL.md 文件太长，怎么拆分？
AI 会分析内容结构，建议按功能模块拆分为多个 references/ 子文件，并生成新的目录结构和引用，你可以直接要求它代为重构。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/hekouwang-claude-skill-doctor-skill-x/raw/index.md 读取 hekouwang-claude-skill-doctor-skill 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/hekouwang-claude-skill-doctor-skill-x/raw/index.md（查看排版版本）