docs: 全部 12 个命令文件完整化 — 消除 P0/P1 操作歧义

P0: 9 个存根命令文件从 11 行模板扩展为完整操作文档
- dbg: 7 步工作流表格 + 证据类型 + 子命令 + Dbg↔Do 集成路径
- ctx: 三级降级压缩 + 质量校验 + Token 估算 + 陈旧锁清理
- dep: SSH 部署流程 + MD5 校验 + systemd 管理
- tst: 5 种测试框架 + run 命令 + T-TEST 集成
- sec: advisory/blocking 双模式 + 文件/目录/Woker result 三种扫描
- rvr: 审查模式 + highRiskAudit + code-to-design + Eng merge 集成
- sdb: 6 种后端 + diff 模式 + Dbg 取证集成
- ndb: 网络抓包 + Dbg 取证集成
- xdb: kmsgrab/xvfb/fallback 三后端 + Dbg/Do GUI 验证集成

P1: 3 个有内容文件的歧义修复
- do: AirDbg 路由具体命令 + 证据采集(xdb/ndb/sdb/tst)命令
- arc: 三阶段→命令映射表 + phase 推进方式
- eng: monitor 轮询循环伪代码(Agent 无时钟概念,必须循环调 monitor)

全部命令统一使用 `python scripts/airplan.py` 路径(清除旧 $HOME/plugins 引用)

63 项功能测试全通过

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
AirLongDian
2026-06-11 15:57:12 +08:00
parent cda601a73a
commit 9ad232af38
12 changed files with 499 additions and 72 deletions

View File

@@ -1,11 +1,53 @@
---
description: "AirPlan rvr mode"
argument-hint: "[enter|status|...]"
description: "AirPlan rvr mode - requirement reviewer with highRiskAudit and code-to-design"
argument-hint: "[review|status]"
allowed-tools: "[Read, Glob, Grep, Bash, Write, Edit]"
---
# /rvr
Run AirPlan rvr mode.
AirRvr 是需求审查器。基于原始需求文档对已完成任务进行独立审查,验证交付物与需求的一致性。含 highRiskAudit生命周期/空指针/悬垂指针/异常安全/并发)和 Code-to-Design 逐行对照。
python "$HOME/plugins/airplan/scripts/airplan.py" --mode rvr --project . [OPTIONS]
## 硬规则
1. **code-to-design 对照** — 每次审查必须逐行对照代码实现与设计文档ADR、C4、需求
2. **高风险审计** — 终审必须包含 lifecycle/nullPointer/danglingPointer/exceptionSafety/concurrency 五项检查
3. **verdict 控制合并** — fail 阻止合并conditional-pass 记录遗留项pass 正常合并
4. **deliveryVerdict = block-release** — eng dispatch 阻止所有后续派发
## 审查模式
| 模式 | 触发时机 | 审查范围 |
|------|---------|---------|
| per-task | 单个任务完成后 | 单任务 |
| per-wave | 波次所有任务完成后 | 整波 |
| per-milestone | 项目阶段结束时 | 全量(比对 requirements.md |
## 子命令
### review — 执行审查
```bash
python scripts/airplan.py --mode rvr --project . --sub review --task-id T-001
```
返回 `{task_id, verdict, report_path}`。审查报告含 coverage/intentAlignment/regressionRisk/codeQuality/lifecycleHealth/runtimeStability/codeToDesignTable/highRiskAudit。
制品:`AirPlan/state/airrvr/reviews/{task_id}-{ts}.json`
### status — 查看审查状态
```bash
python scripts/airplan.py --mode rvr --project . --sub status
```
## 集成路径
**Eng merge 时自动检查**merge_worker_result Phase 1.5 自动调用 `get_verdict_for_task(task_id)`
- `verdict=fail` → 抛出 `ValueError` 阻止合并
- `verdict=conditional-pass` → 记录 residualItems 但允许合并
- `deliveryVerdict=block-release` → dispatch_worker_group 阻止所有后续派发
**触发方式**:设置 `reviewPolicy.requireBeforeMerge=true` 或在 result 中设 `requireReview=true`
**INVALIDATED 任务清理检查**P1-21ADR 变更级联失效后,手动调 `check_invalidated_cleanup()` 验证旧代码已清理。