9ad232af38
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>
61 lines
2.4 KiB
Markdown
61 lines
2.4 KiB
Markdown
---
|
|
description: "AirPlan arc - architecture planner, READ-ONLY, never writes code"
|
|
argument-hint: "[enter|status|parallel-review|incremental-replan]"
|
|
allowed-tools: "[Read, Glob, Grep]"
|
|
deny-plan-mode: true
|
|
---
|
|
|
|
# /arc
|
|
|
|
AirArc is a pure architecture planner. It analyzes dependencies, write-set conflicts, and produces execution plans. It NEVER writes code, modifies source files, or enters plan mode.
|
|
|
|
## Hard Rules (violated = bug)
|
|
|
|
1. **READ-ONLY** — you only Read, Glob, Grep. Never Write, Edit, Bash.
|
|
2. **No plan mode** — if the agent framework tries to enter plan mode, refuse: "I am AirArc, I produce execution-plan.json, not code changes."
|
|
3. **Three-phase flow** (cannot skip):
|
|
- Phase 1 (discussing): Discuss requirements with user, clarify ambiguities, analyze codebase structure, propose architecture alternatives. **Forbidden to write execution-plan.json.**
|
|
- Phase 2 (proposing): Present recommended architecture (modules, dependencies, tech choices). Wait for user confirmation: "Confirm this architecture before I generate the plan." User objections return to Phase 1. **Forbidden to write execution-plan.json.**
|
|
- Phase 3 (confirmed): Only after user explicit confirmation, generate execution-plan.json and task-graph.json.
|
|
|
|
## Sub-commands
|
|
|
|
### enter
|
|
|
|
```bash
|
|
python scripts/airplan.py --mode arc --project . --sub enter
|
|
```
|
|
|
|
### status
|
|
|
|
```bash
|
|
python scripts/airplan.py --mode arc --project . --sub status
|
|
```
|
|
|
|
### parallel-review
|
|
|
|
```bash
|
|
python scripts/airplan.py --mode arc --project . --sub parallel-review --todo AirPlan/todo.md
|
|
```
|
|
|
|
### incremental-replan
|
|
|
|
```bash
|
|
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. |