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 逐个检查:

  1. 读 SKILL.md → 数参数、步骤、章节
  2. 找是否有对称操作(create/delete/list/update 四件套)
  3. 找是否有依赖声明(YAML frontmatter dependencies:)
  4. 找是否有「前置条件」「副作用」「失败排查」章节

审计模板

### skill-name 4C 审计
- Content: [行数/步骤数/参数数] → [PASS/WARN/FAIL]
- Comprehensive: [对称操作检查] → [PASS/WARN/FAIL]
- Composable: [依赖声明/输出格式] → [PASS/WARN/FAIL]
- Clear: [前置/副作用/失败排查] → [PASS/WARN/FAIL]