Maintenance Review

---
name: maintenance-review
description: Dormant 项目唤醒后的手动维护入口，逐步执行 librarian / self-iteration / decay
user-invocable: true
disable-model-invocation: true
allowed-tools: [Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion]
---

# /core:maintenance-review 唤醒后手动维护

## 用途

dormant 项目被重新打开后，**自动维护链路全部暂停**。用户主动 `/core:maintenance-review` 才恢复正常维护。

**Claude 不会自动调用**（`disable-model-invocation: true`）。

## 输入

两种调用模式：

1. **完整 wake-up review**（无参数）：按顺序走完 3 个检查点，每步都用 `AskUserQuestion` 确认是否继续
2. **快速 dismiss 模式**（`--dismiss <PM-ID>`）：把指定 ID 的 `pending_maintenance` 条目关闭（经模式 A 的代码通道执行；audit 保持只读，写操作归本 skill）。不触发 librarian / self-iteration

## 执行步骤

### 模式 A：`--dismiss <PM-ID>`（快速关闭单条）

1. Read `.claude/workframe-state/activity-state.json`，确认 `id == <PM-ID>` 的条目存在且
   `status == "open"`，记下它的 `kind` / `severity`（用于第 3 步向用户复述）
2. 用代码通道关闭（**不要自己改这个文件**）——它一并写 `pending_maintenance_dismissed`
   事件（`ts` / `at` 由脚本填同一时刻，二者都是 schema 必填）：

   ```bash
   python "$(cat .claude/workframe-state/plugin-root.txt)/scripts/maintenance_workorder.py" \
       --close-pm <PM-ID>
   ```

   > `activity-state.json` 还装着 `session_counter` / `recent_drift_repairs` / 注入标记等
   > 攒出来的状态，整份重写漏字段不报错、只静默丢历史；脚本走文件锁 + 原子替换 + 三方合并，
   > 只动 `pending_maintenance` 一处。
3. 在响应中输出：`已关闭 PM-ID=<PM-ID>，原 kind=<X> severity=<Y>`
4. **不触发 librarian / self-iteration**；该条目会在 SessionStart 的 7 天 GC 后从数组中清理

### 模式 B：完整 wake-up review（无参数）

1. **会话摘要**
   - Read `.claude/workframe-state/activity-state.json` — 告知 dormant 多少天
   - Read `.claude/workframe-state/session-digest-latest.md` — 上次活跃时的摘要
   - 问用户："继续执行 Librarian 整理吗？" (A: 是 / B: 跳过本步 / C: 取消全部)

2. **Librarian 整理（如用户同意）**
   - 以 `manual-maintenance=true` 上下文调用 librarian skill
   - 用户已确认继续整理时，允许处理 dormant / wake_up_pending 下被冻结的 promotion 候选和 decay / 容量候选
   - 输出整理摘要（整理了几条、提升几条、确认降级几条、仍待审查几条）
   - 问："继续执行 self-iteration 吗？"

3. **Self-iteration 提案（如用户同意）**
   - 调用 self-iteration skill
   - 输出提案摘要（生成几个候选、阶段 4 审批清单）
   - 问："提案是否批准执行？（逐条选）"

4. **结尾**
   - 关闭本次处理过的 pending_maintenance 条目——走模式 A 第 2 步的
     `--close-pm <PM-ID> ...`（可一次传多个 ID），不要手改 activity-state.json
   - 结束 wake-up 状态（`dormant=false` / `wake_up_pending=false`）同样走代码通道：

     ```bash
     python "$(cat .claude/workframe-state/plugin-root.txt)/scripts/maintenance_workorder.py" --wake-done
     ```

     > **别直接 Edit 这个文件**——即使这两个字段本身是幂等赋值，用 Edit 改也等于
     > **整份 JSON 重写**：你读到的那一份会被整体写回，期间别的 hook 写进来的
     > `session_counter` / `pending_maintenance` / drift 历史统统被盖掉。
     > 字段幂等 ≠ 写入方式幂等。
   - 追加 events.jsonl `{"ts":"<now ISO-8601>","type":"maintenance_review_completed"}`
   - 输出下次建议时间

## 约束

- 必须每步等用户确认
- 任何写操作前做 snapshot / 备份（复用 librarian + self-iteration 自己的备份机制）
- 若用户随时取消，保留已完成步骤的结果，清理 pending_maintenance 中对应项
- `disable-model-invocation: true`（防止 Claude 自作主张把 dormant 项目"唤醒并整理"）

## 相邻入口：`workframe-maintenance` 批处理（不属本 skill，仅索引）

轻量维护有独立的**非交互批处理入口**：终端运行 `workframe-maintenance`（bin 包装；命令不在 PATH 时用 `python "<插件根>/bin/workframe-maintenance"`，插件根见 `.claude/workframe-state/plugin-root.txt`）→
`claude -p --maintenance` → Setup hook（`scripts/maintenance_workorder.py`）把四路保养事项
（notes 积压 / 待拍板候选计数 / 逾期提案验证 / pending_maintenance open 信号 + doctor 异常项）
聚合成 `.claude/workframe-state/maintenance-workorder.md` 工单，模型照单执行。

与本 skill 的分工：批处理只做 **L1 与记录性操作**（print 模式无交互卡，L2 一律攒到
promotion-candidates.md）；需要逐步确认、处理 L2 候选、或 dormant 唤醒的场景走本 skill。