用途:校验 OrchestKit 中 hook、skill、agent 的数量在所有权威来源之间是否一致,输出对比表并以精确文件引用标记漂移。
主要能力:计数来源规则要求以文件系统为准,派生来源必须与之一致;漂移检测规则要求生成对比表并标注 file:field 引用。全局、agent 范围、skill 范围的 hook 数量须合计为总数,共 2 条规则、2 个类别。
使用方式:从仓库根目录运行完整校验:bash src/skills/validate-counts/scripts/validate-counts.sh;仅取 src/ 原始计数:bash src/skills/validate-counts/scripts/count-all.sh。流程为运行脚本、读取 CLAUDE.md(从 Project Overview 与 Version 段提取计数)、读取 manifests/ork.json(检查 skill/agent/hook 数组长度)、构建对比表、标记不一致的 file + field;无问题则输出 All counts consistent.。可按需用 Read("${CLAUDE_SKILL_DIR}/references/<file>") 加载 count-locations.md,了解各计数位置及漂移原因。
适用场景:发布前计数核对(release-checklist 将其作为发布门禁第 5 步)、doctor 整体健康检查、以及技能结构审计(audit-skills)中的计数环节。
限制与常见错误:应从 src/ 而非 plugins/ 计数,中断构建后 plugins/ 可能为空;v7 只有 manifests/ork.json,不应与已删除的别名 manifest 比较;不要遗漏 hook 的全局、agent 范围、skill 范围拆分合计。具体版本、平台与收费信息暂未提供。