audit

/core:audit 审计维护活动

用途

用户显式 /core:audit 时执行。Claude 不会自动调用（disable-model-invocation: true）。

回答五类问题：

1. 最近 N 天自动发生了什么维护动作？（events.jsonl 聚合）
2. 有没有 T3/T4 待处理项？（activity-state.pending_maintenance + proposals/pending/）
3. 有没有失败的提案或低成功率的 skill？（skill-metrics.yaml）
4. board summary 是否健康？（current drift + 近 30 天修复历史）
5. skill-metrics 是否刷新？（skill_metrics_recomputed 事件 + 当前 generated_at）

输入

参数格式（自由文本）：

• 无参数 → 默认近 14 天
• 7d / 30d → 指定窗口

audit 保持纯只读——dismiss 等写操作迁到 /core:maintenance-review --dismiss <PM-ID>。这样 audit 与 maintenance-review 的边界清晰：audit 报告状态，maintenance-review 修改状态。

执行步骤

1. Read .claude/workframe-state/activity-state.json — 拿 session_counter / dormant / pending_maintenance / recent_drift_repairs
2. Read .claude/workframe-state/skill-metrics.yaml — 最近窗口的 skill/rule 汇总
3. 读取 .claude/workframe-state/events.jsonl 近 N 天 — 按 type 分组统计（含 summary_drift_repaired / summary_drift_repair_skipped）
4. Glob projects/proposals/pending/*.yaml — 列出待审批提案
5. Glob projects/proposals/applied/*.yaml 过滤 verified: null — 列出待闭环验证
6. Read .claude/workframe-state/session-digest-latest.md — 上次会话摘要
7. Board summary drift check（只读不改）：
   • 调用只读检查命令（插件根路径从 plugin-root.txt 取，不依赖 PATH）：

     python "$(cat .claude/workframe-state/plugin-root.txt)/bin/workframe-audit-board-drift"
     

   • 输出文本格式：

     actual: total=N, counts={pending:..,...}, unknown=[..]
     summary: total=M, counts={pending:..,...}
     drift: <empty | field1=summary→actual, field2=...>
     

   • audit 只解析 drift: 行决定是否展示 drift 状态；不调用 workframe-recompute-board-summary（那个会写文件，违反 audit 只读约束）。修复路径走 SessionStart drift check 自动 / workframe-recompute-board-summary 兜底命令
   • 调用方式说明：${CLAUDE_PLUGIN_ROOT} 在 agent Bash 上下文不可用，CC 官方的 plugin bin/ PATH 注入在部分环境也不生效（Windows + directory 订阅实测未注入），故统一走 plugin-root.txt 配方——该文件由 SessionStart hook 每次会话刷新为当前插件根（正斜杠绝对路径）。若环境里 workframe-audit-board-drift 恰好已在 PATH，裸调等价

输出格式

## 🔍 维护审计报告（近 <N> 天）

### 📊 事件统计
- skill_used: X 次（top: librarian ×5 / task-management ×3）
- rule_triggered: N/A（无 deterministic producer，字段保留仅为兼容；见 event-schema.json）
- user_correction: Z 次（problem 信号）
- task_blocked: W 次
- skill_metrics_recomputed: M 次（最近 generated_at: <ISO>）
- proposal_applied: A 次，proposal_verified: B 次（signal_met=true），proposal_failed: C 次（best_effort；依赖 self-iteration 执行）

### 🗂️ 提案状态
- pending 待审批：N 条
  - [PROP-...] confidence=0.75 | L2 | pattern=...
- applied 待验证：M 条（verify_by 到期前不闭合）

### 🏁 活动指标
- session_counter: xxx
- active_sessions_30: yy
- dormant: false (profile=normal)
- wake_up_pending: false
- last_digest_at: <ISO>

### ⚠️ pending_maintenance（按 severity 排序）
- 总数：N 条（open: N1 / closed: N2）
- critical: ...
- warn: ...
  - [PM-20260424-003] cadence_timeout — 距上次自迭代 10 天
- info: ...

> 关闭指定条目请使用 `/core:maintenance-review --dismiss <PM-ID>`（audit 保持只读，写操作归 maintenance-review）。

### 📐 Board Summary Drift 健康度

- **当前状态**：✅ summary 与 tasks 实际计数一致 / ⚠️ 发现 N 项 drift（current snapshot）
- **近 30 天修复历史**（来自 activity-state.recent_drift_repairs + events.jsonl）：
  - 自动修复（summary_drift_repaired）：X 次
  - 跳过修复（summary_drift_repair_skipped）：Y 次
    - unknown_statuses_in_tasks: <list>
    - summary_block_not_found / recompute_failed / read_failed / parse_failed: <count>

如近 30 天 ≥3 次自动修复 → 提示：
> ⚠️ 频繁触发 drift 修复可能是 SessionEnd hook 经常未执行或超时。
> 大项目可设环境变量 `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS=5000` 缓解。

如出现 unknown_statuses_in_tasks → 提示：
> ⚠️ 检查 `projects/board.yaml` 中 task status 拼写：<具体值>
> SessionStart drift check 不会自动修复含未知 status 的 board.yaml（C+ 第一保护条件）。

### ⚠️ 其他注意项
- 低成功率 skill: <list>