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

@@ -23,27 +23,39 @@ AirArc is a pure architecture planner. It analyzes dependencies, write-set confl
### enter
```bash
python "$HOME/plugins/airplan/scripts/airplan.py" --mode arc --project . --sub enter
python scripts/airplan.py --mode arc --project . --sub enter
```
### status
```bash
python "$HOME/plugins/airplan/scripts/airplan.py" --mode arc --project . --sub status
python scripts/airplan.py --mode arc --project . --sub status
```
### parallel-review
```bash
python "$HOME/plugins/airplan/scripts/airplan.py" --mode arc --project . --sub parallel-review --todo AirPlan/todo.md
python scripts/airplan.py --mode arc --project . --sub parallel-review --todo AirPlan/todo.md
```
### incremental-replan
```bash
python "$HOME/plugins/airplan/scripts/airplan.py" --mode arc --project . --sub incremental-replan --todo AirPlan/todo.md
python scripts/airplan.py --mode arc --project . --sub incremental-replan --todo AirPlan/todo.md
```
## 三阶段 → 命令映射
ArcPhaseGate 控制 execution-plan.json 写入权限。phase 默认 `discussing`,必须推进到 `confirmed` 才能生成规划。
| 阶段 | phase 值 | 操作 |
|------|---------|------|
| 需求探讨 | `discussing` | 与用户对话讨论,不需要命令 |
| 架构确认 | `proposing` | 向用户呈现方案,等待确认 |
| 生成规划 | `confirmed` | `parallel-review``incremental-replan` |
**推进方式**:用户说"确认"/"可以"/"同意"后,`ArcPhaseGate.confirm_architecture()` 自动推进。不丢失(已修复)。
## Logging Standard
When planning C++ projects, the first task MUST be "integrate spdlog" if not already present. All generated code must use spdlog, not std::cout/qDebug/printf.