用途:跟踪 Claude Code 生态系统中全部 27 类可扩展组件的健康状态,横跨 6 个层级,并借助 changelog 变化判断审计是否过期。层级包括核心配置、插件组件、环境与 CLI、认证与访问、会话与运行时、集成。
主要能力:解析 changelog 识别新功能与变更;跟踪各组件审计覆盖率;为不可审计组件跟踪文档覆盖率(从 docs-management 查询);找出待更新项;编排审计以节省 token;应用新版本带来的更新。Schema v2.2 引入分层验证模型:feature 与 deprecation 等次要变更走基于关键词的定向验证(约 100–500 token);behavior_change 与 security 等重大变更必须走完整审计(约 3,000–8,000 token);bugfix 无需验证;距上次完整审计超过 90 天触发周期性审查。状态按保守优先级计算,有疑问即升级要求。
使用方式:状态模式(默认或 --status)显示当前健康度;--check 对比 changelog 与上次检查并更新跟踪文件;--audit [type] 只针对 Tier 2 自动化组件运行审计,优先级为从未审计、近期变更影响、停滞超过 90 天,每批最多 3 个;--doc-coverage 跟踪 Tier 3-6 文档覆盖。审计命令按组件映射,如 skills 用 /audit-skills、hooks 用 /audit-hooks、settings 用 /audit-settings,另有 /audit-docs-delegation 与 /audit-agent-consolidation 跨项合规审计。状态持久化在 .claude/ecosystem-health.yaml,只存审计元数据,不存组件细节。changelog 需经 docs-management 访问,指令:python plugins/claude-ecosystem/skills/docs-management/scripts/core/find_docs.py content raw-githubusercontent-com-anthropics-claude-code-refs-heads-main-CHANGELOG。
限制:所有组件细节必须运行时从 docs-management 查询,禁止硬编码 CLI 标志、环境变量、认证方式、权限模式、云厂商、IDE 集成等易变数据;关键词匹配必须上下文正确,证据必须含文件路径与行号,无证据即验证失败;单个匹配置信度为 medium,两个及以上为 high,低置信度须人工复核;重大变更不得使用定向验证;若 docs-management 返回空,应视作该组件可能已不存在。