# Aios Plan

> 工程交付规划工作流。用于把功能、bug 修复、架构决策或 AI 生成方案拆成可执行任务、依赖、验证步骤、PR/发布顺序、CI/CD 检查和实施交接。

- Skill: `archsightlabs/aios-plan` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add archsightlabs/aios-plan`
- Raw SKILL.md: https://api.skillmd.com/api/skills/archsightlabs/aios-plan/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: archsightlabs (https://skillmd.com/u/archsightlabs)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/archsightlabs/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 中止步于计划文本，除非后续执行被权限、破坏性风险或外部条件真实阻塞。