hekouwang-claude-skill-doctor-skill
AI Agent Skill 代码规范与结构体检器
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：hekouwang-claude-skill-doctor-skill。 它的用途是：AI Agent Skill 代码规范与结构体检器 完整的 Skill 内容见：https://321skill.com/skills/hekouwang-claude-skill-doctor-skill/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘请帮我检查一下这个 Skill 的 SKILL.md 文件是否规范。’ 它会分析你的 Skill 结构，评估其是否符合‘按需加载的指令包’最佳实践，并生成一份包含具体问题点和重构建议的评分报告。
介绍
这个 Skill 专门用于评估和优化 Claude/Agent Skill 的结构质量。它解决了开发者难以判断自己编写的 Skill 是否符合最佳实践、是否存在潜在可维护性与安全性问题（如单文件巨石、硬编码密钥）的痛点。
使用时，只需向搭载此 Skill 的 AI 提出 Skill 审查请求，例如“检查我的 SKILL.md 文件”或“评估这个 Skill 是否规范”，AI 便会根据预设的多维度标准（如触发描述质量、文件结构、渐进披露、脚本外置、可移植性、安全性）进行分析，并生成一份详细的评分卡和按优先级排序的修复建议。
它非常适合智能体开发者、全栈开发者和项目经理，尤其是那些希望遵循官方规范、提升 Skill 可维护性和团队协作效率的用户。
使用建议：在 Skill 开发中期或完成初稿后使用，以获得最有效的重构建议。注意，它主要分析结构规范，不深入评估业务逻辑的正确性。
核心特点
与通用代码审查工具不同，它专门针对 Claude/Agent Skill 的特定结构（如 SKILL.md, references/）和最佳实践进行深度检查，并能提供具体的重构方案，而非仅给出通用建议。
注意事项
不适合评估 Skill 的业务逻辑有效性或 AI 响应的内容质量。
常见问题
claude-skill-doctor 能做什么？
它能检查你的 Agent Skill 文件结构是否符合规范，识别单文件巨石、硬编码路径/密钥等问题，并提供重构建议。
如何使用这个 Skill 体检我的项目？
对集成了此 Skill 的 AI 说“检查我的 skill”或“SKILL.md 体检”，并附上你的 Skill 代码或文件即可。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/hekouwang-claude-skill-doctor-skill/raw/index.md 读取 hekouwang-claude-skill-doctor-skill 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/hekouwang-claude-skill-doctor-skill/raw/index.md（查看排版版本）