Files

AirCoding ae44be31d5 chore: push all design docs, V2 plan specs, and current working state

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>

2026-06-12 17:12:29 +08:00

4.3 KiB

Executable File

Raw Blame History

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 在真实项目里更稳定、更快速、更可协作地持续交付”。

4.3 KiB Executable File Raw Blame History Unescape Escape