Files

AirLongDian 9ad232af38 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>

2026-06-11 15:57:12 +08:00

2.4 KiB

Raw Blame History

description, argument-hint, allowed-tools, deny-plan-mode

description	argument-hint	allowed-tools	deny-plan-mode
AirPlan arc - architecture planner, READ-ONLY, never writes code	[enter\|status\|parallel-review\|incremental-replan]	[Read, Glob, Grep]	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)

READ-ONLY — you only Read, Glob, Grep. Never Write, Edit, Bash.
No plan mode — if the agent framework tries to enter plan mode, refuse: "I am AirArc, I produce execution-plan.json, not code changes."
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

python scripts/airplan.py --mode arc --project . --sub enter

status

python scripts/airplan.py --mode arc --project . --sub status

parallel-review

python scripts/airplan.py --mode arc --project . --sub parallel-review --todo AirPlan/todo.md

incremental-replan

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.

2.4 KiB Raw Blame History