Claude Skill 体检器(SKILL.md Doctor)

Agent Skill 质量体检与重构工具

代码质量 智能体开发全栈开发后端开发 检查代码质量审查代码规范 claude通用 ★ 819 更新于 2026-08-01

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:Claude Skill 体检器(SKILL.md Doctor)。
它的用途是:Agent Skill 质量体检与重构工具
完整的 Skill 内容见:https://321skill.com/skills/claude-skill-体检器-skill-md-doctor/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

「检查我的 skill 是否规范」,它会要求你提供 SKILL.md 内容,然后输出评分卡,指出「description 触发质量不足」「篇幅过长,建议拆分到 references/ 目录」「脚本未外置」「存在硬编码绝对路径」等问题,并给出优先级排序的修复建议。如果你同意,它还可以直接帮你重构文件结构。

介绍

你写的 SKILL.md 是否变成了臃肿的“单文件巨石”?是否缺少合理的触发描述、渐进披露或安全性检查?这个 Skill 专门针对 Claude/Agent Skill 的 SKILL.md 文件进行全方位体检,从 description 触发质量、篇幅控制、references/ 拆分、脚本外置、可移植性、安全(无硬编码密钥)等六个维度打分,并给出按优先级排列的修复建议,甚至可代为重构。

使用非常简单:直接对 AI 说「检查我的 skill」「SKILL.md 体检」「这个 skill 规范吗」等唤醒词,AI 就会要求你提供 SKILL.md 内容(或粘贴文本),然后自动输出评分卡和详细改进方案。如果希望自动修复,可进一步授权 AI 进行代码级重构。

适合所有使用 Claude/Agent 的开发者,尤其是智能体开发者、全栈工程师和希望提升 Skill 质量的后端开发。无论你是刚入门还是已有经验,都能快速发现自己 SKILL.md 中的隐藏问题,并得到可落地的优化方向。

建议:本工具仅关注 SKILL.md 的结构与规范,不检查功能逻辑是否正确。使用前请确保你的 SKILL.md 内容完整;重构功能建议在版本控制下进行,以便回退。

核心特点

不同于通用的代码审查工具,它专门针对 Claude/Agent 的 SKILL.md 设计,检查维度紧扣“按需加载的指令包”最佳实践,并给出可自动执行的重构方案。

注意事项

需要用户提供完整的 SKILL.md 内容,无法处理非标准格式的技能包,也不评估功能逻辑的正确性。

常见问题

怎么触发这个体检?

直接说「检查我的 skill」「SKILL.md 体检」「这个 skill 规范吗」等关键词即可。

主要检查哪些方面?

description 触发质量、SKILL.md 篇幅、渐进披露(references/ 拆分)、脚本外置、可移植性(无硬编码路径)、安全(无硬编码密钥),并给出评分卡。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/claude-skill-体检器-skill-md-doctor/raw/index.md 读取 Claude Skill 体检器(SKILL.md Doctor) 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。