heal-skill

/heal-skill — 检查一个或多个技能包

heal-skill 是一种专用的规范检查工具。它会报告规范源技能和生成的 Codex 副本中的结构缺陷。使用 --fix 时，它只会通过相应生成器修复其负责的投影。它不会安排工作、操作 Git、验证软件候选项，也不会决定故障后采取何种措施。

输入

bash skills/heal-skill/scripts/heal.sh --check [skills/<slug> ...]
bash skills/heal-skill/scripts/heal.sh --check --strict [skills/<slug> ...]
bash skills/heal-skill/scripts/heal.sh --fix [skills/<slug> ...]

每个显式目标都必须是 skills/ 或 skills-codex/ 的真实直接子项。不接受缺失路径、路径遍历和符号链接写法。

流程

1. 解析所有请求的目标目录，并确保其路径未越界。
2. 解析每个 SKILL.md 的 frontmatter。
3. 检查路径与名称是否匹配、描述、API 版本、处置元数据以及链接的本地引用。
4. 每项发现只打印一次。
5. 仅在 --fix 模式下，重新生成由元数据管理的投影和作用域内的 Codex 副本，然后停止。

--check 只读。--strict 会在出现任何发现时返回退出码 1。修复失败时会将失败结果返回给调用方；该技能不会重试，也不会选择其他操作。

深度内容审计

可选的只读内容审计命令为：

bash skills/heal-skill/scripts/audit.sh [--strict] [--json <path>] skills/<slug>

它将结构检查结果与确定性的编写检查以及参考性质的质量评分结合起来。这不是核心 Validate 阶段，不会写入 verdict.v2，也没有交付权限。检查定义见 audit-checks.md；密度评分说明见 context-density-checks.md。

输出

结构检查发现会按以下格式打印：

[FINDING_CODE] skills/example: concrete explanation

深度审计 JSON 符合 audit-report.json 的规范。后续编辑或调用由调用方负责。

检查项

• 检查模式不会修改文件。
• 修复模式只会更改显式指定的源目标及其负责的投影。
• 第二次执行相同的修复会保持幂等。
• 生成的 Codex 一致性遵循 codex-parity.md。
• 无法修复的剩余发现会明确列出。

相关可执行规范

• heal-skill.feature
• skill-auditor.feature