skill-system-health-check

Skill体系自洽性审查 Skill(由用户主动触发,不被其他组件调用)。主动检查整个Skill/Agent/Rule体系的内部一致性:触发词冲突、孤立组件、版本漂移、SKILL-INDEX与实际文件不一致、alwaysApply Rule叠加矛盾等。对应产品侧的 project-closeout。注意:与 skill-system-destroyer(子智能体,只读审查新组件冲突)不同——本 Skill 审查整个体系的历史一致性。触发词:「检查Skill体系」「Skill体系有没有问题」「Skill体系自检」「Skill体系自洽性」「Skill健康检查」。

Skill 体系自洽性审查(skill-system-health-check)

对应关系:

  • project-closeout → 项目文档一致性检查
  • skill-system-health-check → Skill/Agent/Rule 体系一致性检查

强绑定 Rule:R2 NO_FABRICATION / R3 READ_FIRST / R6 ARTIFACT_FIRST


知识导航表(执行前必须理解的概念根)

层级文档需要理解的概念
D0 认知根(必读)_内部总控/认知结构/L1_系统性文档/系统架构思维维度/自进化智能体系统形式规范_v1.0.md层3:C1完全可观测性(所有对象必须在R中注册);C2关系显式化(依赖必须声明);C3类型感知变更
D3 规范参考_内部总控/认知结构/L1_系统性文档/系统架构思维维度/Skill体系设计原则_v1.0.md§4 文档体系与知识层次(区分B/K/S对象的存放位置)
D4 运行时数据.cursor/skills/skill-index/SKILL-INDEX.md + .cursor/rules/role-menu.mdcR注册表(B-objects)+ 路由入口(检查一致性的两个核心文件)

核心概念速查: ① C1违反 = SKILL-INDEX中有的对象,文件系统中不存在(或反之)→ 孤立组件 ② C2违反 = Skill引用了某Rule但未声明,该Rule变化时Skill不会收到通知 → 版本漂移 ③ 健康检查的输出是R的一致性报告,发现P0问题时必须立即路由修复,不可先放着


激活后立即执行

Step 1  读取 Skill 体系全量索引(R3 READ_FIRST)
        用 explore 子智能体并行读取:
        - .cursor/skills/skill-index/SKILL-INDEX.md(必读)
        - .cursor/rules/role-menu.mdc(必读)
        - .cursor/rules/ 目录下所有 .mdc 文件的 description 字段
        - .cursor/skills/ 目录结构(验证 SKILL-INDEX 与实际文件是否对齐)
        - .cursor/agents/ 目录结构(验证子智能体注册是否完整)

Step 2  执行六维自洽性检查

        【维度1:触发词冲突检查】
        对照 role-menu.mdc 和每个 Skill 的 description:
        → 有没有两个 Skill 的触发词高度重叠(语义相似度 > 70%)?
        → 用户说某句话,会同时匹配两个 Skill 吗?
        → 有没有 Skill 的触发词已被更精确的新 Skill 覆盖但旧 Skill 未更新?

        【维度2:孤立组件检查】
        → 有没有在 SKILL-INDEX 里注册但在 role-menu.mdc 里没有的 Skill?
        → 有没有被其他 Skill/Agent 调用但未在 SKILL-INDEX 注册的组件?
        → 有没有在 role-menu.mdc 的「配套文件」表格里引用但不存在的文件路径?

        【维度3:版本漂移检查】
        → SKILL-INDEX 里记录的版本号,与实际 SKILL.md 底部变更记录中的最新版本是否一致?
        → 有没有 Skill 被修改了但 SKILL-INDEX 版本号没有更新?

        【维度4:alwaysApply Rule 叠加矛盾检查】
        → 读取所有 alwaysApply: true 的 Rule 文件
        → 检查:有没有两条规则在同一场景下指向相反的行为?
        → 检查:knowledge-integrity-rules.mdc 的 R1-R15 与其他 Rule 是否有冲突?

        【维度5:子智能体 I/O 契约检查】
        → 所有 .cursor/agents/*.md 的 description 是否都说明了:谁调用它、输入是什么、输出是什么?
        → 有没有子智能体被 Skill 调用但该子智能体文件不存在?

        【维度6:PENDING-SKILLS 状态一致性】
        → PENDING-SKILLS.md 里标注为「已完成」的 Skill,在 SKILL-INDEX 里是否存在?
        → PENDING-SKILLS 里的 P0 项是否长期未处理(超过 2 周)?

Step 3  输出「Skill 体系健康报告」(R6:必须写文件)
        写入:.cursor/skills/skill-index/skill-health-report-YYYYMMDD.md

Step 4  路由后续动作
        P0 问题(触发词严重冲突 / 文件路径错误 / alwaysApply 矛盾):
        → 立即输出警告标注:「🔴 P0 问题需要立即修复——此问题会导致 Skill 体系无法正常工作」
        → 自动引导用户修复:「建议说「这里有个规范问题,帮我修复」,触发 project-convention-resolver(E类:Skill/Rule文件),由其统一记录+路由执行 skill-rule-修改规范+验证闭环」
        → 告知用户:「P0 问题未修复时,不建议继续使用相关 Skill」

        P1 问题(版本漂移 / 孤立组件 / 描述不清晰):
        → 加入 PENDING-SKILLS 或在本次立即修复(用户选择)

        P2 问题(优化项):
        → 告知用户,建议下次 skill-evolution-planner 运行时一并考虑

报告格式

# Skill 体系健康报告

**检查日期**:YYYY-MM-DD
**覆盖范围**:N 个 Skill / M 个 Agent / K 个 Rule

## 维度检查结果

| 维度 | 状态 | 发现 |
|---|---|---|
| 触发词冲突 | ✅/⚠️/❌ | [摘要] |
| 孤立组件 | ✅/⚠️/❌ | [摘要] |
| 版本漂移 | ✅/⚠️/❌ | [摘要] |
| Rule 叠加矛盾 | ✅/⚠️/❌ | [摘要] |
| Agent I/O 契约 | ✅/⚠️/❌ | [摘要] |
| PENDING-SKILLS 状态 | ✅/⚠️/❌ | [摘要] |

## P0 问题(必须修复)
| # | 问题描述 | 涉及组件 | 建议动作 |
|---|---|---|---|

## P1 问题(建议修复)
[同上格式]

## P2 优化项
[同上格式]

## 结论
[PASS / NEEDS-ATTENTION]

常见失败模式

失败模式1:维度2检查时遍历文件过多,AI 只读了部分目录就开始分析 → 预防:Step 1 明确「必须读完 SKILL-INDEX 和 role-menu.mdc 全文,才能进入 Step 2」

失败模式2:触发词冲突判断过于严格,把「类似但不同」的 Skill 标为冲突 → 预防:触发词重叠需同时满足「语义相似度 > 70%」AND「用户会在同一场景使用」,两个条件才算冲突


变更记录

v1.1 → v1.2 — 2026-03-22 — P0路由改为 project-convention-resolver(GAP-SK017-1 修复)

根因:scenario-sandbox-builder Phase 2 验证(SK-017沙盘)发现:Step 4 P0路由直接引导用户触发 skill-rule-修改规范,绕过了 project-convention-resolver 的统一「记录+路由+验证+闭环」层。导致P0修复缺少追踪台记录和闭环验证。

修改内容

  • 修改:Step 4 P0路由「自动引导修复」文字 → 从「触发 skill-rule-修改规范」改为「触发 project-convention-resolver(E类:Skill/Rule文件),由其统一记录+路由+验证+闭环」
  • 备份路径:history/SKILL_v1.1_20260322_before_sk017.md

验证方法:发现P0问题时,引导词应提及 project-convention-resolver 而非直接提 skill-rule-修改规范 验证状态:🔵 待验证


v1.1 — 2026-03-19 — P0 问题路由加强(SK-002 Gap 修复)

根因:SK-002 沙盘发现:skill-system-health-check 发现 P0 问题后只「建议」修复,没有强制触发机制,P0 问题可能长期存在而未被处理。

修改内容

  • 修改:Step 4 P0 路由 → 从「建议通过...修复」改为「立即警告 + 强制引导修复 + 告知不建议继续使用」

验证状态:🔵 待验证


v1.0 — 2026-03-19 — 初始创建

根因:Skill 体系缺少等价于 project-closeout 的自洽性检查机制,无法主动发现触发词冲突、版本漂移等问题。

验证状态:🔵 待验证(关卡A/B/C 已通过设计阶段模拟)