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 跨多个仓库时，分别标注业务仓库、工具源仓库、安装缓存和生成产物；默认修改源仓库，不把本机安装副本当作正式交付。 ## 删除、兼容与迁移策略 规划边界调整、重构或产品收口时，必须显式记录兼容策略，不能默认保留旧入口： - `兼容`：已经上线、已有外部消费者或存在数据迁移义务时，定义迁移期、弃用提示和删除条件。 - `硬收口`：项目未上线且用户明确不需要兼容时，直接删除目标架构之外的路由、入口、专用实现和无效测试，避免双轨维护。 - `需确认`：无法判断是否存在外部消费者、不可逆数据或发布依赖时，才升级人工确认。 删除任务仍要先做引用扫描、所有权判断和回归验证；“允许删除”不等于允许删除共享底座或用户未授权的数据。 ## 输出格式 默认输出： 1. 结论 2. 任务拆解 3. 依赖关系 4. 验收标准 5. 执行顺序 6. 风险与阻塞 必要时补充： - 已有能力：已有能力和复用判断。 - 事实刷新：本轮计划依据的当前代码事实，以及被剔除或降级的旧判断。 - 失败模式：关键路径、失败方式、测试覆盖、错误处理、用户可见性、级别。 - 并行工作线：并行 workstream、触达模块、依赖、冲突标记、后置任务。 - 测试缺口：用具体数据流或命令描述测试缺口，不只写“补测试”。 - 证据仲裁：阻断判断事项、Capability 证据、人工升级点和当前处理建议。 - 第一小步：当前最该执行的一件小事，说明为什么优先。 任务条目建议格式： ```text 任务： 分级：P0 / P1 / P2 类型：领域风险 / 工程风险 / 混合风险 范围： 输入： 输出： 依赖： 验证： 风险： ``` 并行 workstream 建议格式： ```text Lane： 目标： 触达模块： 依赖： 冲突点： 验证： 合并顺序： ``` Failure Modes 建议格式： ```text 关键路径： 生产失败方式： 现有覆盖： 错误处理： 用户可见性： 级别： ``` ## 约束 - 不替代 Atlas 做长期架构决策。 - 不替代 `aios-product` 定义用户问题、版本范围、产品优先级和成功指标。 - 不把模糊需求拆成不可验收任务。 - 不越过 Argus 直接放行高风险变更。 - 不为简单任务引入重流程。 - 不让执行型 Agent 接收无边界大上下文。 - 不把兼容层视为天然安全选项；兼容成本必须有真实消费者或发布事实支撑。 - 不在已授权连续交付的 Goal 中止步于计划文本，除非后续执行被权限、破坏性风险或外部条件真实阻塞。