# Self Audit

> Self Audit

- Skill: `vivy-yi/self-audit` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vivy-yi/self-audit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vivy-yi/self-audit/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: vivy-yi (https://skillmd.com/u/vivy-yi)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vivy-yi/self-audit

---


# /self-audit — 自动质量审计

## 审计范围

扫描 `plugins/legal-scenes/` 下全部场景和 `plugins/legal-atomic/` 下的全部原子 skill。

## 工作流程

### Phase 1：结构检查（无 LLM，纯规则）

逐文件检查以下指标，记录到 `_audit-log.yaml`：

| 检查项 | 方法 | 自动修复 |
|--------|------|---------|
| frontmatter 完整性 | name/description/legal_frame/version 是否存在 | ❌ 标记，不自动修复 |
| trigger_phrases 存在 | 数组非空 | ❌ 标记 |
| legal_sources 有 effective_date | 逐条检查 | ❌ 标记 |
| 文件大小 > 500b | wc -c | ❌ 标记 |
| body 含 ## 工作流程 或 ## 核心分析 | grep 存在 | ❌ 标记 |
| 无美版法律术语 | grep UCC/FRCP/Delaware 等 | ❌ 标记 |
| ../../CLAUDE.md 可解析 | test -f 检查 | ✅ 如路径错误，自动修正 |
| references/ 文件存在 | test -f 检查 | ❌ 标记 |

### Phase 2：内容深度评估（需 LLM，对每个 skill）

对每个 body < 2000b 的 SKILL.md，读取内容并评估：

```
评估维度：
- 是否有实质性法律分析（非仅标题）
- 是否包含可操作的工作流步骤
- 是否引用具体法条
- 论证链路是否完整

输出：PASS / WARN / FAIL
```

### Phase 3：修复

仅执行自动修复项（路径修正）。其余标记到审计日志。

### Phase 4：输出报告

```
📋 Self-Audit 报告 — [日期]

场景覆盖：[N]/31 ✅

结构问题：
- frontmatter 缺失：[N] 个文件
- trigger_phrases 缺失：[N] 个文件
- body 过小（<500b）：[N] 个文件
- body 空心（仅标题）：[N] 个文件
- 美版术语：[N] 个文件
- 路径错误：[N] → 已自动修复 [M] 个

内容质量（LLM 评估）：
- PASS：[N]
- WARN：[N]
- FAIL：[N]

详细列表：
[逐文件清单]
```

## 审计日志

每次运行结果追加到 `_audit-log.yaml`：

```yaml
- run_at: 2026-06-15
  scenes_checked: 31
  files_checked: 475
  auto_fixed: 3
  issues:
    - file: plugins/legal-scenes/xxx/skills/yyy/SKILL.md
      severity: warn
      issue: body_too_small
      detail: "仅43行，含frontmatter后正文不足100字"
    - file: plugins/legal-scenes/xxx/skills/zzz/SKILL.md
      severity: error
      issue: missing_legal_frame
      detail: "legal_frame: cn-mainland 字段缺失"
```

## 作为 evolution 的辅助输入源

self-audit Phase 2 的 LLM 内容质量评估（WARN/FAIL 结果）可作为 evolution REFL 阶段的**辅助输入**。

**典型场景**：

- self-audit 发现某 SKILL.md body < 2000b 且 Phase 2 评 FAIL → evolution 可触发"内容深度不足"反思
- self-audit 发现 frontmatter 缺 legal_frame → evolution 不处理（结构问题 auto-test 修）
- self-audit 发现内容"空心"（仅标题）→ evolution 可触发"骨架级 SKILL.md"反思

**不直接触发 evolution**：

self-audit 的输出**不直接**调用 evolution——它写到审计日志，由人工或 cron 任务决定是否升级到 evolution。

升级条件（建议）：

- Phase 2 FAIL 数 ≥5 个 → 建议升级到 evolution（一次性反思）
- 同一 skill 连续 3 周 Phase 2 FAIL → 强制升级（系统性问题）

**完整链路**：

```
self-audit (Phase 1 + Phase 2)
  → 写入 _audit-log.yaml
    → [人工/cron 判定升级]
      → evolution REFL（参考 self-audit 报告作为辅助 evidence）
```

## 本技能不做什么

- 不修改 SKILL.md 的内容逻辑——只修复路径。
- 不执行 AI 驱动的功能测试（仅内容质量评估）。
- 不自动触发 cold-start——cold-start 仍由用户手动运行。
- 不直接触发 evolution——升级由人工/cron 决定。

---

*Greater China Legal — shared self-audit v1.0.0*