mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-04-14 13:53:29 +08:00
docs(zh-CN): sync Chinese docs with latest upstream changes
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
# 工具链审计命令
|
||||
|
||||
审计当前代码库的智能体工具链设置并返回一份优先级评分卡。
|
||||
运行确定性仓库框架审计并返回优先级评分卡。
|
||||
|
||||
## 使用方式
|
||||
|
||||
@@ -9,9 +9,19 @@
|
||||
* `scope` (可选): `repo` (默认), `hooks`, `skills`, `commands`, `agents`
|
||||
* `--format`: 输出样式 (`text` 默认, `json` 用于自动化)
|
||||
|
||||
## 评估内容
|
||||
## 确定性引擎
|
||||
|
||||
将每个类别从 `0` 到 `10` 进行评分:
|
||||
始终运行:
|
||||
|
||||
```bash
|
||||
node scripts/harness-audit.js <scope> --format <text|json>
|
||||
```
|
||||
|
||||
此脚本是评分和检查的单一事实来源。不要发明额外的维度或临时添加评分点。
|
||||
|
||||
评分标准版本:`2026-03-16`。
|
||||
|
||||
该脚本计算 7 个固定类别(每个类别标准化为 `0-10`):
|
||||
|
||||
1. 工具覆盖度
|
||||
2. 上下文效率
|
||||
@@ -21,34 +31,37 @@
|
||||
6. 安全护栏
|
||||
7. 成本效率
|
||||
|
||||
分数源自显式的文件/规则检查,并且对于同一提交是可复现的。
|
||||
|
||||
## 输出约定
|
||||
|
||||
返回:
|
||||
|
||||
1. `overall_score` (满分 70)
|
||||
2. 类别得分和具体发现
|
||||
3. 前 3 项待办事项及其确切文件路径
|
||||
4. 建议接下来应用的 ECC 技能
|
||||
1. `overall_score` 分(满分 `max_score` 分;`repo` 为 70 分;范围限定审计则分数更小)
|
||||
2. 类别分数及具体发现项
|
||||
3. 失败的检查及其确切的文件路径
|
||||
4. 确定性输出的前 3 项行动(`top_actions`)
|
||||
5. 建议接下来应用的 ECC 技能
|
||||
|
||||
## 检查清单
|
||||
|
||||
* 检查 `hooks/hooks.json`, `scripts/hooks/` 以及钩子测试。
|
||||
* 检查 `skills/`、命令覆盖度和智能体覆盖度。
|
||||
* 验证 `.cursor/`, `.opencode/`, `.codex/` 在跨工具链间的一致性。
|
||||
* 标记已损坏或过时的引用。
|
||||
* 直接使用脚本输出;不要手动重新评分。
|
||||
* 如果请求 `--format json`,则原样返回脚本的 JSON 输出。
|
||||
* 如果请求文本输出,则总结失败的检查和首要行动。
|
||||
* 包含来自 `checks[]` 和 `top_actions[]` 的确切文件路径。
|
||||
|
||||
## 结果示例
|
||||
|
||||
```text
|
||||
Harness Audit (repo): 52/70
|
||||
- Quality Gates: 9/10
|
||||
- Eval Coverage: 6/10
|
||||
- Cost Efficiency: 4/10
|
||||
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) Add cost tracking hook in scripts/hooks/cost-tracker.js
|
||||
2) Add pass@k docs and templates in skills/eval-harness/SKILL.md
|
||||
3) Add command parity for /harness-audit in .opencode/commands/
|
||||
1) [Security Guardrails] Add prompt/tool preflight security guards in hooks/hooks.json. (hooks/hooks.json)
|
||||
2) [Tool Coverage] Sync commands/harness-audit.md and .opencode/commands/harness-audit.md. (.opencode/commands/harness-audit.md)
|
||||
3) [Eval Coverage] Increase automated test coverage across scripts/hooks/lib. (tests/)
|
||||
```
|
||||
|
||||
## 参数
|
||||
|
||||
Reference in New Issue
Block a user