4c-toolset-audit.md
1.69 KB
4C Toolset 接口设计审计标准
来源:UE 5.8 MCP 工作流设计方法论 — 审计 Hermes skill 的工具接口设计质量。 适用场景:创建新 skill 时自检 / 审计现有 skill 时对照。
4C 标准
| 标准 | 含义 | 判据 | Hermes 对照 |
|---|---|---|---|
| Content 精简 | 工具接口不过度暴露参数,每个工具只做一件事 | SKILL.md ≤80 行、核心步骤 ≤5 步、参数 ≤5 个 | ✅ 极简设计原则已覆盖 |
| Comprehensive & symmetric 功能完整对称 | 有 create 必有 delete/list/update;操作成对出现 | 每个 tool 是否有对应的 tear-down/cleanup? | ⚠️ 部分 skill 只有正向操作 |
| Composable 可组合 | 工具间可拼接,输出可直接作为另一工具的输入 | skill 间是否有依赖声明?输出格式是否稳定? | ❌ 无依赖声明(已知 gap) |
| Clear 过程清晰 | 每个工具的前置条件、副作用、成功后状态、失败后状态明确 | SKILL.md 是否有「前置条件」「副作用」「成功时」「失败时」? | ⚠️ 仅少数 skill 有 |
审计方法
对 skill 逐个检查:
- 读 SKILL.md → 数参数、步骤、章节
- 找是否有对称操作(create/delete/list/update 四件套)
- 找是否有依赖声明(YAML frontmatter
dependencies:) - 找是否有「前置条件」「副作用」「失败排查」章节
审计模板
### skill-name 4C 审计
- Content: [行数/步骤数/参数数] → [PASS/WARN/FAIL]
- Comprehensive: [对称操作检查] → [PASS/WARN/FAIL]
- Composable: [依赖声明/输出格式] → [PASS/WARN/FAIL]
- Clear: [前置/副作用/失败排查] → [PASS/WARN/FAIL]