Harness 审计命令¶

执行确定性的仓库 Harness 审计，并返回带优先级的记分卡。

用法¶

/harness-audit [scope] [--format text|json] [--root path]

• scope（可选）: repo（默认）、hooks、skills、commands、agents
• --format: 输出样式（text 为默认，自动化使用 json）
• --root: 审计特定路径，而不是当前工作目录

确定性引擎¶

始终执行：

node scripts/harness-audit.js <scope> --format <text|json> [--root <path>]

该脚本是评分和检查的可靠来源。请勿创建额外的维度或临时分数。

评分标准版本：2026-03-30。

脚本计算 7 个固定类别（每个 0-10 归一化）：

1. 工具覆盖
2. 上下文效率
3. 质量门禁
4. 记忆持久性
5. 评估覆盖
6. 安全护栏
7. 成本效率

分数由显式的文件/规则检查导出，并对同一提交可复现。 脚本默认审计当前工作目录，并自动检测目标是 ECC 仓库本身，还是使用 ECC 的消费者项目。

输出契约¶

返回内容：

1. overall_score / max_score（repo 时为 70，带范围审计时更小）
2. 类别分数和具体发现
3. 带精确文件路径的失败检查
4. 来自确定性输出的前 3 个操作（top_actions）
5. 接下来应应用的推荐 ECC 技能

检查清单¶

• 直接使用脚本输出。不要手动重新评分。
• 如果要求 --format json，直接返回脚本 JSON。
• 如果要求文本，则总结失败检查和前 3 个操作。
• 包含来自 checks[] 和 top_actions[] 的精确文件路径。

结果示例¶

Harness Audit (repo): 66/70
- Tool Coverage: 10/10 (10/10 pts)
- Context Efficiency: 9/10 (9/10 pts)
- Quality Gates: 10/10 (10/10 pts)

Top 3 Actions:
1) [Security Guardrails] hooks/hooks.jsonにプロンプト/ツールプリフライトセキュリティガードを追加。(hooks/hooks.json)
2) [Tool Coverage] commands/harness-audit.mdと.opencode/commands/harness-audit.mdを同期。(.opencode/commands/harness-audit.md)
3) [Eval Coverage] scripts/hooks/lib全体の自動テストカバレッジを増加。(tests/)

参数¶

$ARGUMENTS: - repo|hooks|skills|commands|agents（可选范围） - --format text|json（可选输出格式）