claude-ecosystem-health
检测Claude Code生态内组件间的配置漂移与引用断裂
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：claude-ecosystem-health。 它的用途是：检测Claude Code生态内组件间的配置漂移与引用断裂 完整的 Skill 内容见：https://321skill.com/skills/claude-ecosystem-health/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请运行生态系统健康检查。” 它会扫描你的Claude Code工作空间，执行全部七项诊断检查，并生成一份详细的报告，指出哪些硬编码路径失效、哪些技能引用已断裂、哪些MCP服务器配置缺失等关键问题，帮助你快速定位配置隐患。
介绍
claude-ecosystem-health是一个诊断型Skill，专门解决复杂Claude Code生态中组件间因变更导致的静默故障问题。Claude Code生态通常包含数十个技能、代理、MCP服务器和配置策略，它们通过名称、路径相互引用。当某个组件被重命名、归档或重新配置时，依赖它的其他组件就会断裂，但系统不会主动告警，导致问题难以排查。
该Skill通过运行七项预定义的检查来诊断整个生态系统。它扫描用户本地的Claude配置目录，验证硬编码的保险库路径是否存在、检查技能间的交叉引用是否有效、确认MCP服务器配置是否健康、核实CLI工具是否已安装，并检测配置策略违规、组件陈旧度以及无引用的孤立代码。整个过程默认是只读的，不会修改任何配置。
它非常适合管理大型或复杂Claude Code配置的开发者、团队技术负责人或DevOps工程师。当团队协作开发多个技能，或个人长期维护一个不断演进的AI辅助开发环境时，此工具能帮助维持生态的整洁与稳定。
与同类工具相比，它并非专注于单个技能的性能优化或代码生成，而是着眼于整个Claude Code工作空间内组件依赖关系的健康度。它像一个针对AI辅助开发环境的“静态分析器”或“依赖关系检查器”，填补了从组件变更到影响评估之间的工具空白。
核心特点
核心区别在于其定位是Claude Code生态的“全栈健康检查器”，而非单一功能增强工具。它通过七项针对性检查（如MCP服务器健康、配置策略漂移、孤儿检测等），系统性地发现跨技能、代理、配置文件的隐性依赖断裂问题，这是其他专注于特定任务（如代码生成、文档撰写）的Skill所不具备的。
注意事项
该Skill主要依赖本地文件系统扫描和配置解析，不适合用于检测运行时错误或网络服务的可用性问题。
常见问题
这个Skill会修改我的配置吗？
默认不会。它是只读的诊断工具，仅报告问题，不会自动修复。
我需要提前安装哪些依赖？
需要已安装Claude Code、jq工具（用于解析配置），并且技能/代理等文件位于~/.claude/目录结构中。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/claude-ecosystem-health/raw/index.md 读取 claude-ecosystem-health 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/claude-ecosystem-health/raw/index.md（查看排版版本）