claude-markdown-health-check

Claude Code 生态健康检查工具,自动扫描并审计项目配置。

安装使用

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

帮我安装这个 AI Skill:claude-markdown-health-check。
它的用途是:Claude Code 生态健康检查工具,自动扫描并审计项目配置。
完整的 Skill 内容见:https://321skill.com/skills/claude-markdown-health-check/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

“请运行 `/claude-markdown-health-check` 检查当前项目的 Claude 配置。” 它会扫描你的 `.claude` 目录,生成一份包含分数评级和详细问题清单的报告,例如指出某个技能的描述过长、某个钩子从未触发、或存在权限不匹配等问题,并等待你确认修复哪些项。

介绍

这个 Skill 是一个专为 Claude Code 设计的生态系统审计工具。它解决了开发者在管理大量技能、钩子、代理和设置时,配置容易过时、出错或产生性能隐患的问题。

使用方式非常简单,只需在 Claude Code 中运行一个斜杠命令(如 /claude-markdown-health-check),它便会自动扫描用户目录(~/.claude)和项目目录(./.claude)下的所有配置,生成一份扁平化、按优先级排序的健康报告。

它非常适合在 Claude Code 生态中进行深度开发的团队或个人开发者,尤其是那些维护着复杂技能集、自定义钩子和多代理工作流的用户。它能帮助确保配置的合规性、一致性和最佳性能。

与同类配置检查工具相比,它的核心优势在于与 Claude Code 官方规范实时同步。其检查阈值每周从官方文档获取并缓存,确保审计标准永不偏离产品的最新要求,而非基于静态的、可能过时的规则。

核心特点

其检查阈值每周自动从 Claude Code 官方文档同步并缓存,确保审计标准与产品规范实时对齐,避免了因产品更新而导致的规则漂移。同时,它采用“先报告,后操作”的交互模式,生成详细报告后等待用户明确指令,不会自动修改任何文件,保障了用户的操作自主权。

注意事项

该工具主要面向 Claude Code 的深度配置管理,对于仅使用基础功能或非 Claude Code 生态的用户不适用。

常见问题

这个工具会修改我的文件吗?

不会。它采用“先报告,后操作”模式,只生成审计报告,需用户明确回复指令才会进行修复。

它检查哪些内容?

检查技能、命令、钩子、代理、设置、插件和自动记忆的配置健康度,包括死链、触发词问题、令牌膨胀、权限漂移等数十项。

给 AI 助手的安装指引

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

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