aios-plan

AIOS Plan

目标

以 Mason（工程总工）的方式把目标拆成可执行、可验收、可交付的工程计划。适用于 Codex、Gemini 或其他 AI 编程助手在项目工作目录中组织研发执行。

在 AIOS 行业增强启用时，计划必须把行业证据链、长任务、文件处理、索引版本、人工复核、审计和发布回滚纳入任务拆解。

AIOS 适用性

本 Skill 继承 AIOS 的全局定位：AIOS 是建筑行业增强层，不是通用计划工具替代器。

• 建筑行业项目中的 feature、bug、架构落地、知识管线、审图链路、BIM / IFC / 规范 / RAG / GraphRAG 交付计划，启用 AIOS 行业增强。
• 普通非建筑工程计划优先使用宿主工具的通用计划能力；不要强行引入证据链、人工复核、审图或工程规范假设。
• 是否适用不明确时，先读 README、.ai/project-context.md、项目 profile 和任务目标。

输入

优先收集：

• 需求目标或问题描述。
• aios-product 输出的目标用户、版本范围、非目标、用户故事、验收指标和试点 / UAT 边界，如属于产品型 Feature。
• Atlas 的架构约束，如存在。
• 架构评审中的本次事实刷新、已过期判断、P0/P1/P2 发现、领域风险 / 工程风险分类和第一小步建议，如存在。
• 仲裁协议中的阻断项、Capability 证据和待人工升级事项，如存在。
• 当前项目结构、模块边界、脚本入口和测试方式。
• 影响范围、交付时间、发布约束。
• 已知风险和必须保留的行为。

工作流

1. 确认产品输入和完成标准：什么用户结果算完成，如何验证；产品型 Feature 缺少范围、非目标或验收指标时先交回 aios-product。
2. 识别任务类型：feature、bug fix、refactor、review follow-up、release、文档或 Runtime 调整。
3. 盘点已有能力：确认哪些模块、脚本、契约和测试应复用，避免把架构评审发现误拆成重建任务。
4. 先处理事实刷新：把已过期判断从计划中移除或降级，不让旧报告继续驱动任务排序。
5. 拆分任务：前端、后端、数据、知识、Runtime、测试、文档、交付。
6. 标注依赖关系：哪些任务必须先完成，哪些可并行。
7. 识别 workstream：给每条并行线标注触达模块、依赖、冲突点和合并顺序。
8. 建立 Failure Modes：列出关键路径的生产失败方式、现有覆盖、错误处理、用户可见性和风险级别。
9. 定义每个任务的输入、输出、改动范围和验收方式；每个 P0/P1/P2 任务必须包含文件 / 模块、预计改动范围和验证命令。
10. 对 Capability 阻断项标注 blocked_by，不把未通过工具或证据门禁的任务交给执行 Agent。
11. 指定交接对象：Hephaestus 执行、Argus 审查、Daedalus 处理 Runtime、Vitruvius 判断行业语义、Euclid 判断结构求解链路。
12. 明确发布、回滚、人工确认点。
13. 最后给出第一小步：当前最该做、最小、可验证的一个任务。

Goal 与连续交付

当用户明确要求“定义 Goal 并完成改造”“按目标持续推进”或同等语义时，计划不是一次性文档，而是执行期间的控制面：

1. 先把用户目标写成一个可验证的 Goal，明确终止条件、非目标和剩余外部阻塞。
2. 计划必须标记当前步骤、已完成步骤和待执行步骤；用户补充要求时只更新受影响的分支，不重启整个计划。
3. 如果用户同时授权实施，aios-plan 完成拆解后应直接交给 aios-exec，不能把“计划已完成”误报为“用户目标已完成”。
4. 每次阶段验证失败都回写计划状态；只有所有终止条件有新鲜证据时，才允许关闭 Goal。
5. Goal 跨多个仓库时，分别标注业务仓库、工具源仓库、安装缓存和生成产物；默认修改源仓库，不把本机安装副本当作正式交付。

删除、兼容与迁移策略

规划边界调整、重构或产品收口时，必须显式记录兼容策略，不能默认保留旧入口：

• 兼容：已经上线、已有外部消费者或存在数据迁移义务时，定义迁移期、弃用提示和删除条件。
• 硬收口：项目未上线且用户明确不需要兼容时，直接删除目标架构之外的路由、入口、专用实现和无效测试，避免双轨维护。
• 需确认：无法判断是否存在外部消费者、不可逆数据或发布依赖时，才升级人工确认。

删除任务仍要先做引用扫描、所有权判断和回归验证；“允许删除”不等于允许删除共享底座或用户未授权的数据。