用途:把本地 Skill 集合当作受治理的软件供应链来管理,处理跨运行时、跨作用域的归属、投影、暴露、生命周期与修复治理问题。仅当用户明确要求跨运行时或跨作用域的治理、投影、暴露、生命周期或修复时启用;运行时自身配置与库存问题应直接检查对应项目或运行时。
模式:审计(只读)、计划(无变更)、修复(需明确范围与回滚)、验证(只读)、外部动作(需逐项授权)。请求混用模式时先审计后修复,不得从“检查/诊断”推断出修复授权。
主要能力:发现重复或分叉的投影、无 SKILL.md 的疑似 Skill 目录、名称与目录不一致、物理运行时副本缺少精确源固定、已退役或被隔离 Skill 仍处于活动状态、活动引用指向退役入口、高置信度疑似密钥字面量(不打印其值)、缺失的逐 Skill 治理决策、全局目录预算与 profile 绑定;并检查 Loom 健康、投影漂移与待同步远端。
用法要点:审计时从本 Skill 目录运行 python3 scripts/ecosystem_doctor.py --governance ./skill-ecosystem-governance.json,可加 --json;仅当 Loom 明确不在范围时使用 --skip-loom;严格发布门禁使用 --fail-on-warn。对已部署策略,先干跑 python3 scripts/ecosystem_reconcile.py --registry ~/.loom-registry --policy ~/.loom-registry/SKILL_GOVERNANCE_POLICY.json,仅在明确授权的修复运行中加 --apply;插件配置改动前会生成带时间戳备份,之后需重跑干跑并要求计划为空。如策略声明渐进式披露拆分,用 python3 scripts/ecosystem_split.py --registry ~/.loom-registry --policy ~/.loom-registry/SKILL_GOVERNANCE_POLICY.json 检查,审阅后再考虑 --apply。
限制:属 Skill 成熟度的工作流,不是无人值守自动化,不应定时或静默应用修复;破坏性变更、凭据操作、改写历史、远端发布等须先升级授权。证据只能证明局部事实(如摘要冲突证明内容不同,不证明哪份正确),不得过度推断。不得打印密钥、覆盖未知用户内容、强制推送、改写历史,或声称已完成无直接证据的凭据轮换。缺失事实(如具体价格、平台支持范围)暂未提供。