ae44be31d5
Includes AirPlan design documents, AircOding-alpha1-plan, AirPlanV2, AirPlan-ParaV2, AirPlan-Para V1 reference docs, and all working code changes across packages. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
143 lines
4.3 KiB
Markdown
Executable File
143 lines
4.3 KiB
Markdown
Executable File
# AirPlan-Para V1.0.0
|
||
## 让 AI 开发从“能写代码”升级到“能稳定交付”
|
||
|
||
AirPlan-Para 是一套已经落地的 AI 工程插件套件。它面向 Claude Code / Codex 本地工作流，把规划、调度、执行、调试、GUI 证据、网络抓包、静态分析和长会话恢复整合成一个可恢复、可追溯、可验证的工程系统。其调度层 aireng 采用非占用式设计，开发者可随时介入调整约束与方向；同时以隔离并行执行替代串行等待，显著加快多任务交付速度。
|
||
|
||
## 当前版本已经实现的核心能力
|
||
|
||
### AirArc：规划 + 并行评审
|
||
|
||
- architecture-first planning
|
||
- `plan.md` / `todo.md` 驱动
|
||
- dependency edges
|
||
- parallel groups
|
||
- shared write-set conflicts
|
||
- serialization points
|
||
- execution plan 输出
|
||
|
||
### AirEng：调度 + 合并
|
||
|
||
作为公共调度层，aireng 有两个核心设计优势：一是派发 worker 后多数时候处于非占用状态，开发者可随时交流补充信息、调整约束或介入更正，调度不是黑盒；二是以 bounded concurrency 策略并行派发多个隔离 worker，将串行等待变为并发推进，大幅压缩交付周期。
|
||
|
||
- 读取 AirArc execution artifacts
|
||
- 生成 dispatch manifest
|
||
- bounded concurrency 调度多个隔离 AirDo worker
|
||
- 合并结构化结果
|
||
- 准备 repair dispatch 与 repair queue
|
||
- 同步 `plan.md`、`todo.md`、ADR、C4
|
||
|
||
### AirDo：单任务执行 + finalize
|
||
|
||
- task-local brief / handoff
|
||
- 结构化 `result.json`
|
||
- finalize 到 `AirPlan/state/airdo/results/`
|
||
- `worker-state.json` 记录 canonical result path
|
||
- GUI 任务自动接 AirXDB
|
||
- blocked / failed validation 自动接 AirDbg
|
||
|
||
### AirDbg：Debug-first repair
|
||
|
||
- reproduce
|
||
- root cause analysis
|
||
- minimal fix
|
||
- regression verification
|
||
- 联动 AirXDB / AirNDB / AirSDB
|
||
- 维护 AGENTS、ADR、C4、debug log
|
||
|
||
### AirXDB：GUI 证据
|
||
|
||
- Midscene GUI 调试
|
||
- 本地与远程截图
|
||
- Computer MCP smoke
|
||
- model-family 检查
|
||
- Windows 截图资产修复
|
||
|
||
### AirNDB：网络证据
|
||
|
||
- bounded local / remote tcpdump or WinDump
|
||
- Windows 自动下载官方 WinDump.exe
|
||
- BPF filter
|
||
- pcap 读取与摘要
|
||
- 远程 SSH 抓包辅助
|
||
|
||
### AirSDB：C/C++ 静态分析
|
||
|
||
- 本机与远程 cppcheck
|
||
- `--check-level=exhaustive`
|
||
- XML / JSON 报告
|
||
- `staticanalysis.md` AI-readable 摘要
|
||
|
||
### AirContext：上下文压缩 + 自动恢复
|
||
|
||
- 规则驱动的外部上下文压缩
|
||
- `aircontext` wrapper 自动恢复会话
|
||
- 在 `AirPlan/AirContext/` 维护每项目配置、规则和 snapshot
|
||
- 为 AirArc / AirEng / AirDbg / generic workflow 提供不同压缩模板
|
||
|
||
## 结果完整性保护
|
||
|
||
AirPlan-Para 不允许“看起来完成、实际上没做完”的空结果混进交付流。
|
||
|
||
当前版本已经实现：
|
||
|
||
- untouched 默认模板不能 finalize
|
||
- `done` 结果不能是逻辑空载荷
|
||
- `worker-state.json` 中的 `resultPath` 是 canonical 结果定位
|
||
- 无真实 blocker 时，worker 默认继续执行到 finalize
|
||
|
||
## 自动项目初始化
|
||
|
||
`airarc` 和 `aireng` 在首次启动时会自动检测并补齐缺失的 `AirPlan/` bootstrap 工件，无需先手动初始化一次项目。
|
||
|
||
使用 `aircontext` 时，套件还会在项目内维护：
|
||
|
||
- `AirPlan/AirContext/config.yaml`
|
||
- `AirPlan/AirContext/rules.md`
|
||
- `AirPlan/AirContext/active_rules.md`
|
||
- `AirPlan/AirContext/state.json`
|
||
- `AirPlan/AirContext/snapshots/`
|
||
|
||
## 插件组成
|
||
|
||
AirPlan-Para V1.0.0 当前包含 8 个插件：
|
||
|
||
- `airarc 0.3.1`
|
||
- `aireng 0.6.0`
|
||
- `airdo 0.5.0`
|
||
- `airdbg 0.1.4`
|
||
- `airxdb 0.2.2`
|
||
- `airndb 0.1.2`
|
||
- `airsdb 0.1.1`
|
||
- `aircontext 0.1.0`
|
||
|
||
## 部署方式
|
||
|
||
部署包名称：
|
||
|
||
- `AirPlan-Para.zip`
|
||
|
||
安装入口：
|
||
|
||
- `install_to_home.ps1`
|
||
- `install_to_home.cmd`
|
||
- `init_project_airplan.ps1`
|
||
|
||
仓库中同时包含 `AirContext/` 目录，用于套件里的 context continuity 插件。
|
||
|
||
## 适合什么场景
|
||
|
||
- 长周期项目
|
||
- 多会话恢复
|
||
- 任务级隔离执行
|
||
- 受控并发调度，以并行执行缩短交付周期
|
||
- 需要在 AI 执行过程中随时介入、调整方向的团队
|
||
- GUI、网络、静态分析参与交付验证
|
||
- C/C++、Qt、嵌入式、远程设备
|
||
- 需要工程证据和调试轨迹的团队
|
||
- 需要控制 compact 策略并自动恢复长会话的团队
|
||
|
||
## 一句话总结
|
||
|
||
如果普通 coding agent 解决的是“让 AI 开始写代码”，
|
||
那么 AirPlan-Para 解决的是“让 AI 在真实项目里更稳定、更快速、更可协作地持续交付”。
|