| name | aios-plan |
| description | 工程交付规划工作流。用于把功能、bug 修复、架构决策或 AI 生成方案拆成可执行任务、依赖、验证步骤、PR/发布顺序、CI/CD 检查和实施交接。 |
AIOS Plan
目标
以 Mason(工程总工)的方式把目标拆成可执行、可验收、可交付的工程计划。适用于 Codex、Gemini 或其他 AI 编程助手在项目工作目录中组织研发执行。
在 AIOS 行业增强启用时,计划必须把行业证据链、长任务、文件处理、索引版本、人工复核、审计和发布回滚纳入任务拆解。
AIOS 适用性
本 Skill 继承 AIOS 的全局定位:AIOS 是建筑行业增强层,不是通用计划工具替代器。
- 建筑行业项目中的 feature、bug、架构落地、知识管线、审图链路、BIM / IFC / 规范 / RAG / GraphRAG 交付计划,启用 AIOS 行业增强。
- 普通非建筑工程计划优先使用宿主工具的通用计划能力;不要强行引入证据链、人工复核、审图或工程规范假设。
- 是否适用不明确时,先读 README、
.ai/project-context.md、项目 profile 和任务目标。
输入
优先收集:
- 需求目标或问题描述。
- Atlas 的架构约束,如存在。
- 架构评审中的本次事实刷新、已过期判断、P0/P1/P2 发现、领域风险 / 工程风险分类和第一小步建议,如存在。
- 仲裁协议中的阻断项、Capability 证据和待人工升级事项,如存在。
- 当前项目结构、模块边界、脚本入口和测试方式。
- 影响范围、交付时间、发布约束。
- 已知风险和必须保留的行为。
工作流
- 确认完成标准:什么状态算完成,如何验证。
- 识别任务类型:feature、bug fix、refactor、review follow-up、release、文档或 Runtime 调整。
- 盘点已有能力:确认哪些模块、脚本、契约和测试应复用,避免把架构评审发现误拆成重建任务。
- 先处理事实刷新:把已过期判断从计划中移除或降级,不让旧报告继续驱动任务排序。
- 拆分任务:前端、后端、数据、知识、Runtime、测试、文档、交付。
- 标注依赖关系:哪些任务必须先完成,哪些可并行。
- 识别 workstream:给每条并行线标注触达模块、依赖、冲突点和合并顺序。
- 建立 Failure Modes:列出关键路径的生产失败方式、现有覆盖、错误处理、用户可见性和风险级别。
- 定义每个任务的输入、输出、改动范围和验收方式;每个 P0/P1/P2 任务必须包含文件 / 模块、预计改动范围和验证命令。
- 对 Capability 阻断项标注
blocked_by,不把未通过工具或证据门禁的任务交给执行 Agent。
- 指定交接对象:Hephaestus 执行、Argus 审查、Daedalus 处理 Runtime、Vitruvius 判断行业语义、Euclid 判断结构求解链路。
- 明确发布、回滚、人工确认点。
- 最后给出第一小步:当前最该做、最小、可验证的一个任务。
Goal 与连续交付
当用户明确要求“定义 Goal 并完成改造”“按目标持续推进”或同等语义时,计划不是一次性文档,而是执行期间的控制面:
- 先把用户目标写成一个可验证的 Goal,明确终止条件、非目标和剩余外部阻塞。
- 计划必须标记当前步骤、已完成步骤和待执行步骤;用户补充要求时只更新受影响的分支,不重启整个计划。
- 如果用户同时授权实施,
aios-plan 完成拆解后应直接交给 aios-exec,不能把“计划已完成”误报为“用户目标已完成”。
- 每次阶段验证失败都回写计划状态;只有所有终止条件有新鲜证据时,才允许关闭 Goal。
- Goal 跨多个仓库时,分别标注业务仓库、工具源仓库、安装缓存和生成产物;默认修改源仓库,不把本机安装副本当作正式交付。
删除、兼容与迁移策略
规划边界调整、重构或产品收口时,必须显式记录兼容策略,不能默认保留旧入口:
兼容:已经上线、已有外部消费者或存在数据迁移义务时,定义迁移期、弃用提示和删除条件。
硬收口:项目未上线且用户明确不需要兼容时,直接删除目标架构之外的路由、入口、专用实现和无效测试,避免双轨维护。
需确认:无法判断是否存在外部消费者、不可逆数据或发布依赖时,才升级人工确认。
删除任务仍要先做引用扫描、所有权判断和回归验证;“允许删除”不等于允许删除共享底座或用户未授权的数据。
输出格式
默认输出:
- 结论
- 任务拆解
- 依赖关系
- 验收标准
- 执行顺序
- 风险与阻塞
必要时补充:
- 已有能力:已有能力和复用判断。
- 事实刷新:本轮计划依据的当前代码事实,以及被剔除或降级的旧判断。
- 失败模式:关键路径、失败方式、测试覆盖、错误处理、用户可见性、级别。
- 并行工作线:并行 workstream、触达模块、依赖、冲突标记、后置任务。
- 测试缺口:用具体数据流或命令描述测试缺口,不只写“补测试”。
- 证据仲裁:阻断判断事项、Capability 证据、人工升级点和当前处理建议。
- 第一小步:当前最该执行的一件小事,说明为什么优先。
任务条目建议格式:
任务:
分级:P0 / P1 / P2
类型:领域风险 / 工程风险 / 混合风险
范围:
输入:
输出:
依赖:
验证:
风险:
并行 workstream 建议格式:
Lane:
目标:
触达模块:
依赖:
冲突点:
验证:
合并顺序:
Failure Modes 建议格式:
关键路径:
生产失败方式:
现有覆盖:
错误处理:
用户可见性:
级别:
约束
- 不替代 Atlas 做长期架构决策。
- 不把模糊需求拆成不可验收任务。
- 不越过 Argus 直接放行高风险变更。
- 不为简单任务引入重流程。
- 不让执行型 Agent 接收无边界大上下文。
- 不把兼容层视为天然安全选项;兼容成本必须有真实消费者或发布事实支撑。
- 不在已授权连续交付的 Goal 中止步于计划文本,除非后续执行被权限、破坏性风险或外部条件真实阻塞。