@archsight/aios 1.0.0 → 1.0.1

package/templates/project-ai/GEMINI.md

@@ -1,25 +1,25 @@
-# GEMINI.md
-
-> 本文件供 Gemini 在当前业务项目中读取项目 AI 规则。  
-> 通用编码规则只维护在 `AI_CODING_RULES.md`，本文件不复制规则正文。
-
-## 必读入口
-
-开始任何工作前，先阅读：
-
-- `AI_CODING_RULES.md`
-- `.ai/ARCHSIGHT_AIOS_RULES.md`
-- `.ai/project-context.md`
-- `.ai/agent-routing.md`
-- `.ai/skills.md`
-- `.ai/workflows.md`
-- `.ai/profiles/*.md`（如当前项目启用了 profile）
-- 项目自身的 `README.md`、`Makefile`、`scripts/` 或其他工程入口。
-
-## Gemini 入口适配
-
-- 本文件只负责让 Gemini 发现当前项目的公共规则和 `.ai/` 目录。
-- ArchSight AIOS 只在 Agent 路由、Skill 选择、Workflow、交付验证、AI Runtime、Code Review，以及项目明确启用的 BIM / IFC / 建筑行业 profile 等相关任务中作为补充治理层生效。
-- 接入本模板不代表当前项目属于 ArchSightLabs，也不要求使用 Hermes、飞书或其他特定运行平台。
-- 任务适合 ArchSight 技能包时，按 `.ai/skills.md` 选择对应 `aios-*` Skill；涉及流程协作时，按 `.ai/workflows.md` 选择 Workflow。
-- 使用浏览器或外部工具前，先说明目的；操作后汇报结果。
+# GEMINI.md
+
+> 本文件供 Gemini 在当前业务项目中读取项目 AI 规则。  
+> 通用编码规则只维护在 `AI_CODING_RULES.md`，本文件不复制规则正文。
+
+## 必读入口
+
+开始任何工作前，先阅读：
+
+- `AI_CODING_RULES.md`
+- `.ai/ARCHSIGHT_AIOS_RULES.md`
+- `.ai/project-context.md`
+- `.ai/agent-routing.md`
+- `.ai/skills.md`
+- `.ai/workflows.md`
+- `.ai/profiles/*.md`（如当前项目启用了 profile）
+- 项目自身的 `README.md`、`Makefile`、`scripts/` 或其他工程入口。
+
+## Gemini 入口适配
+
+- 本文件只负责让 Gemini 发现当前项目的公共规则和 `.ai/` 目录。
+- ArchSight AIOS 只在 Agent 路由、Skill 选择、Workflow、交付验证、AI Runtime、Code Review，以及项目明确启用的 BIM / IFC / 建筑行业 profile 等相关任务中作为补充治理层生效；普通非建筑任务不强制使用 `aios-*` Skill。
+- 接入本模板不代表当前项目属于 ArchSightLabs，也不要求使用 Hermes、飞书或其他特定运行平台。
+- 任务适合 ArchSight 技能包时，按 `.ai/skills.md` 选择对应 `aios-*` Skill；涉及流程协作时，按 `.ai/workflows.md` 选择 Workflow。
+- 使用浏览器或外部工具前，先说明目的；操作后汇报结果。

package/workflows/architecture-review.md

@@ -1,98 +1,100 @@
-# 架构评审 Workflow
-
-## 定位
-
-用于在实现前评估系统架构、服务边界、技术选型、数据模型、Runtime、RAG / GraphRAG 和长期复杂度。
-
-## 触发场景
-
-- 新系统、新模块或核心服务设计。
-- 服务拆分、数据模型、存储组件或技术栈调整。
-- Hermes / OpenClaw / Agent Runtime 重大变化。
-- RAG / GraphRAG、知识图谱或 BIM / IFC 模块边界设计。
-
-## 参与角色与 Skill
-
-| 阶段 | 主 Agent | Skill |
-| --- | --- | --- |
-| 架构判断 | Atlas | `aios-arch` |
-| 工程拆解 | Mason | `aios-plan` |
-| Runtime 设计 | Daedalus | `aios-runtime` |
-| 行业语义 | Vitruvius | `aios-knowledge` |
-| 风险审查 | Argus | `aios-review` |
-
-## 输入
-
-- 背景和目标。
-- 当前架构、目录、模块和数据结构。
-- 现有代码、配置、接口契约、测试、脚本、部署入口和运行方式。
-- 候选方案。
-- 约束：成本、时间、团队、运行环境、权限、数据规模。
-- 已知风险和历史决策。
-
-## 执行顺序
-
-1. Atlas 明确问题类型和评审边界。
-2. Atlas 基于现有代码、配置、契约、测试、脚本和部署入口核验事实；文档结论必须能回到项目事实。
-3. Atlas 做范围挑战，明确当前评审接受的范围和不在范围内的扩展项。
-4. Atlas 盘点已有能力，确认应复用的模块、契约、测试和脚本。
-5. Atlas 做端到端链路抽样：对关键用户输入、配置字段、领域元数据、版本关系、审计关系或跨存储关系，至少追踪一条从 UI / API / CLI 入口到领域模型、后台任务、存储、检索/消费端和测试的完整路径。
-6. Atlas 对候选方案做 tradeoff，识别复杂度、技术债、生产失效方式和长期迁移成本。
-7. Atlas 用 P0/P1/P2 或等效等级标注风险优先级，形成架构依据。
-8. Daedalus 评审 AI Runtime / RAG / Tool / Memory 相关设计。
-9. Vitruvius 评审 BIM / IFC / 建筑规范相关语义。
-10. Argus 评审安全、权限、Prompt 注入、依赖和发布风险。
-11. Mason 将通过评审的方案拆成可执行任务，并纳入 Failure Modes、测试缺口、并行 workstream 和冲突点。
-
-## 输出
-
-1. 结论
-2. 架构判断
-3. 风险与边界
-4. 推荐方案
-5. Rejected 方案
-6. Assumption / Need verify
-7. Failure Modes
-8. 后续执行任务
-
-## 文档与补充检查
-
-当架构评审需要审阅设计文档、对比多份评审或整合补充检查项时：
-
-- 先回到现有代码、配置、接口契约、测试、脚本和部署入口核验事实。
-- 再判断各检查项的定位：架构依据、工程计划、代码审查、测试计划或风险清单。
-- 架构依据优先采纳边界判断、风险分级、长期演进和被拒绝方案。
-- 工程计划优先采纳 Failure Modes、测试缺口、并行 workstream、冲突标记和回归命令。
-- 纠正文档中的细节错误，例如 Assumption 与 Need verify 数量混淆。
-- 对“未覆盖”的判断要谨慎：如果已有评审已触及某风险但未形成完整策略，应写成“已触及但未系统展开”。
-- 如果本次是“全新独立评审”，仍应建立历史高优先级发现的回归清单；清单只用于防止漏检，不要求继承旧报告结论。
-- 抽象发现不能吞掉具体断链。若某字段、关系或元数据已经被纳入更大的 P1/P2 主题，还必须说明是否完成端到端贯通；未贯通时应保留独立风险或验收项。
-- 对 RAG / GraphRAG、规范知识库和审计系统，重点抽查 `source_version`、适用地区、专业、生效状态、复核状态、版本替代关系、证据引用和缓存/索引版本是否从摄取入口贯通到消费端。
-
-## 端到端链路抽样清单
-
-架构评审至少抽查以下一类链路；涉及知识、审计或合规结论时应优先抽查多类：
-
-- 用户提交字段：页面表单、前端 API 封装、后端 DTO / query / form 参数、后台任务、领域模型、持久化和回显。
-- 领域关系：版本替代、引用关系、父子层级、任务到报告、报告到复核、事件到 outbox。
-- 知识元数据：来源、版本、地区、专业、生效状态、来源哈希、页码范围、质量状态和人工复核状态。
-- 运行期边界：配置变更、缓存 key、索引版本、任务状态、多实例共享和重启恢复。
-
-输出要求：若链路断在任一层，应写清断点、静默失败方式、用户可见影响和最小回归测试。
-
-## 升级与人工确认
-
-以下情况必须人工确认：
-
-- 核心技术栈替换。
-- 生产数据模型迁移。
-- Runtime 权限扩大。
-- 自动执行权限放开。
-- 影响长期平台路线的服务边界调整。
-
-## 验收标准
-
-- 推荐方案有明确边界和取舍。
-- 被拒绝方案有原因。
-- 后续任务可被 Mason 拆解。
-- 不确定项和待验证项被显式记录。
+# 架构评审 Workflow
+
+## 定位
+
+用于在实现前评估系统架构、服务边界、技术选型、数据模型、Runtime、RAG / GraphRAG 和长期复杂度。
+
+本 Workflow 面向建筑行业项目的架构评审增强。普通非建筑架构评审优先使用宿主工具的通用架构能力；只有项目 profile、上下文或任务事实涉及建筑行业语义、工程知识、RAG / GraphRAG、审图、证据链、人工复核或审计留痕时，才启用 `aios-*` 行业增强。
+
+## 触发场景
+
+- 新系统、新模块或核心服务设计。
+- 服务拆分、数据模型、存储组件或技术栈调整。
+- Hermes / OpenClaw / Agent Runtime 重大变化。
+- RAG / GraphRAG、知识图谱或 BIM / IFC 模块边界设计。
+
+## 参与角色与 Skill
+
+| 阶段 | 主 Agent | Skill |
+| --- | --- | --- |
+| 架构判断 | Atlas | `aios-arch` |
+| 工程拆解 | Mason | `aios-plan` |
+| Runtime 设计 | Daedalus | `aios-runtime` |
+| 行业语义 | Vitruvius | `aios-knowledge` |
+| 风险审查 | Argus | `aios-review` |
+
+## 输入
+
+- 背景和目标。
+- 当前架构、目录、模块和数据结构。
+- 现有代码、配置、接口契约、测试、脚本、部署入口和运行方式。
+- 候选方案。
+- 约束：成本、时间、团队、运行环境、权限、数据规模。
+- 已知风险和历史决策。
+
+## 执行顺序
+
+1. Atlas 明确问题类型和评审边界。
+2. Atlas 基于现有代码、配置、契约、测试、脚本和部署入口核验事实；文档结论必须能回到项目事实。
+3. Atlas 做范围挑战，明确当前评审接受的范围和不在范围内的扩展项。
+4. Atlas 盘点已有能力，确认应复用的模块、契约、测试和脚本。
+5. Atlas 做端到端链路抽样：对关键用户输入、配置字段、领域元数据、版本关系、审计关系或跨存储关系，至少追踪一条从 UI / API / CLI 入口到领域模型、后台任务、存储、检索/消费端和测试的完整路径。
+6. Atlas 对候选方案做 tradeoff，识别复杂度、技术债、生产失效方式和长期迁移成本。
+7. Atlas 用 P0/P1/P2 或等效等级标注风险优先级，形成架构依据。
+8. Daedalus 评审 AI Runtime / RAG / Tool / Memory 相关设计。
+9. Vitruvius 评审 BIM / IFC / 建筑规范相关语义。
+10. Argus 评审安全、权限、Prompt 注入、依赖和发布风险。
+11. Mason 将通过评审的方案拆成可执行任务，并纳入 Failure Modes、测试缺口、并行 workstream 和冲突点。
+
+## 输出
+
+1. 结论
+2. 架构判断
+3. 风险与边界
+4. 推荐方案
+5. Rejected 方案
+6. Assumption / Need verify
+7. Failure Modes
+8. 后续执行任务
+
+## 文档与补充检查
+
+当架构评审需要审阅设计文档、对比多份评审或整合补充检查项时：
+
+- 先回到现有代码、配置、接口契约、测试、脚本和部署入口核验事实。
+- 再判断各检查项的定位：架构依据、工程计划、代码审查、测试计划或风险清单。
+- 架构依据优先采纳边界判断、风险分级、长期演进和被拒绝方案。
+- 工程计划优先采纳 Failure Modes、测试缺口、并行 workstream、冲突标记和回归命令。
+- 纠正文档中的细节错误，例如 Assumption 与 Need verify 数量混淆。
+- 对“未覆盖”的判断要谨慎：如果已有评审已触及某风险但未形成完整策略，应写成“已触及但未系统展开”。
+- 如果本次是“全新独立评审”，仍应建立历史高优先级发现的回归清单；清单只用于防止漏检，不要求继承旧报告结论。
+- 抽象发现不能吞掉具体断链。若某字段、关系或元数据已经被纳入更大的 P1/P2 主题，还必须说明是否完成端到端贯通；未贯通时应保留独立风险或验收项。
+- 对 RAG / GraphRAG、规范知识库和审计系统，重点抽查 `source_version`、适用地区、专业、生效状态、复核状态、版本替代关系、证据引用和缓存/索引版本是否从摄取入口贯通到消费端。
+
+## 端到端链路抽样清单
+
+架构评审至少抽查以下一类链路；涉及知识、审计或合规结论时应优先抽查多类：
+
+- 用户提交字段：页面表单、前端 API 封装、后端 DTO / query / form 参数、后台任务、领域模型、持久化和回显。
+- 领域关系：版本替代、引用关系、父子层级、任务到报告、报告到复核、事件到 outbox。
+- 知识元数据：来源、版本、地区、专业、生效状态、来源哈希、页码范围、质量状态和人工复核状态。
+- 运行期边界：配置变更、缓存 key、索引版本、任务状态、多实例共享和重启恢复。
+
+输出要求：若链路断在任一层，应写清断点、静默失败方式、用户可见影响和最小回归测试。
+
+## 升级与人工确认
+
+以下情况必须人工确认：
+
+- 核心技术栈替换。
+- 生产数据模型迁移。
+- Runtime 权限扩大。
+- 自动执行权限放开。
+- 影响长期平台路线的服务边界调整。
+
+## 验收标准
+
+- 推荐方案有明确边界和取舍。
+- 被拒绝方案有原因。
+- 后续任务可被 Mason 拆解。
+- 不确定项和待验证项被显式记录。

package/workflows/bug-fixing.md

@@ -1,62 +1,63 @@
-# Bug 修复 Workflow
-
-## 定位
-
-用于处理缺陷、测试失败、构建失败和生产风险修复。目标是先复现或定位，再做最小修复，最后用证据验证。
-
-## 触发场景
-
-- 用户报告 bug。
-- 测试、构建、lint 或类型检查失败。
-- AI 生成代码导致行为回归。
-- 生产或预发布环境发现异常。
-
-## 参与角色与 Skill
-
-| 阶段 | 主 Agent | Skill |
-| --- | --- | --- |
-| 风险识别 | Argus | `aios-review` |
-| 架构影响判断 | Atlas | `aios-arch` |
-| 修复计划 | Mason | `aios-plan` |
-| 受控修复 | Hephaestus | `aios-exec` |
-| Runtime 相关缺陷 | Daedalus | `aios-runtime` |
-| 行业语义缺陷 | Vitruvius | `aios-knowledge` |
-
-## 输入
-
-- 错误现象、日志、截图或复现步骤。
-- 失败命令和输出。
-- 最近变更、diff 或 PR。
-- 预期行为和实际行为。
-
-## 执行顺序
-
-1. Argus 判断缺陷风险级别和可能影响面。
-2. Hephaestus 尝试复现或定位最小失败点。
-3. Atlas 判断是否涉及架构边界或数据模型问题。
-4. Mason 拆解修复步骤、验证路径和回滚策略。
-5. Hephaestus 执行最小修复。
-6. Argus 复核修复是否引入新风险。
-
-## 修复原则
-
-- 优先复现，再修改。
-- 优先最小修复，不顺手重构。
-- 优先补回归测试；没有测试条件时记录人工验证。
-- 不通过删除测试、降低校验或吞错来制造“通过”。
-
-## 输出
-
-- 根因判断。
-- 修复范围。
-- 修改文件。
-- 验证命令和结果。
-- 剩余风险。
-
-## 验收标准
-
-- 原失败路径已通过验证。
-- 相关回归路径已检查。
-- 没有扩大改动范围。
-- Argus 无阻断问题。
-
+# Bug 修复 Workflow
+
+## 定位
+
+用于处理缺陷、测试失败、构建失败和生产风险修复。目标是先复现或定位，再做最小修复，最后用证据验证。
+
+本 Workflow 面向建筑行业项目的缺陷修复增强。普通非建筑 bug 修复优先使用宿主工具的通用调试和修复能力；只有项目 profile、上下文或任务事实涉及建筑行业语义、工程知识、RAG / GraphRAG、审图、证据链、人工复核或审计留痕时，才启用 `aios-*` 行业增强。
+
+## 触发场景
+
+- 用户报告 bug。
+- 测试、构建、lint 或类型检查失败。
+- AI 生成代码导致行为回归。
+- 生产或预发布环境发现异常。
+
+## 参与角色与 Skill
+
+| 阶段 | 主 Agent | Skill |
+| --- | --- | --- |
+| 风险识别 | Argus | `aios-review` |
+| 架构影响判断 | Atlas | `aios-arch` |
+| 修复计划 | Mason | `aios-plan` |
+| 受控修复 | Hephaestus | `aios-exec` |
+| Runtime 相关缺陷 | Daedalus | `aios-runtime` |
+| 行业语义缺陷 | Vitruvius | `aios-knowledge` |
+
+## 输入
+
+- 错误现象、日志、截图或复现步骤。
+- 失败命令和输出。
+- 最近变更、diff 或 PR。
+- 预期行为和实际行为。
+
+## 执行顺序
+
+1. Argus 判断缺陷风险级别和可能影响面。
+2. Hephaestus 尝试复现或定位最小失败点。
+3. Atlas 判断是否涉及架构边界或数据模型问题。
+4. Mason 拆解修复步骤、验证路径和回滚策略。
+5. Hephaestus 执行最小修复。
+6. Argus 复核修复是否引入新风险。
+
+## 修复原则
+
+- 优先复现，再修改。
+- 优先最小修复，不顺手重构。
+- 优先补回归测试；没有测试条件时记录人工验证。
+- 不通过删除测试、降低校验或吞错来制造“通过”。
+
+## 输出
+
+- 根因判断。
+- 修复范围。
+- 修改文件。
+- 验证命令和结果。
+- 剩余风险。
+
+## 验收标准
+
+- 原失败路径已通过验证。
+- 相关回归路径已检查。
+- 没有扩大改动范围。
+- Argus 无阻断问题。

package/workflows/code-review.md

@@ -1,54 +1,55 @@
-# Code Review Workflow
-
-## 定位
-
-用于 PR、diff、AI 生成代码、Runtime 配置、Prompt、Tool Calling 和发布前质量审查。
-
-## 触发场景
-
-- PR 合并前。
-- AI 生成代码进入仓库。
-- 涉及权限、安全、依赖、Runtime 或生产发布。
-- 大范围重构或多模块变更。
-
-## 参与角色与 Skill
-
-| 阶段 | 主 Agent | Skill |
-| --- | --- | --- |
-| 质量审查 | Argus | `aios-review` |
-| 架构边界复核 | Atlas | `aios-arch` |
-| 修复执行 | Hephaestus | `aios-exec` |
-| 交付协调 | Mason | `aios-plan` |
-| Runtime 风险 | Daedalus | `aios-runtime` |
-
-## 输入
-
-- diff / PR / commit。
-- 需求背景和验收标准。
-- 测试、构建、lint、typecheck 输出。
-- 权限、Runtime、Prompt 或 Tool 配置。
-
-## 执行顺序
-
-1. Argus 先看需求和预期行为，再审查 diff。
-2. Argus 按 P0-P3 输出问题，先列阻断项。
-3. Atlas 复核架构边界问题。
-4. Daedalus 复核 Runtime / MCP / Memory / Prompt 风险。
-5. Hephaestus 修复明确问题。
-6. Argus 复审。
-
-## 输出
-
-- 阻断问题。
-- 非阻断建议。
-- 测试缺口。
-- 剩余风险。
-- 合并或发布建议。
-
-## 验收标准
-
-- 阻断问题已修复或明确不发布。
-- 测试缺口被补齐或记录。
-- 没有无关风格挑刺。
-- 没有未经验证的完成声明。
-
+# Code Review Workflow
+
+## 定位
+
+用于 PR、diff、AI 生成代码、Runtime 配置、Prompt、Tool Calling 和发布前质量审查。
+
+本 Workflow 面向建筑行业项目的 code review 增强。普通非建筑代码审查优先使用宿主工具的通用 review 能力；只有项目 profile、上下文或任务事实涉及建筑行业语义、工程知识、RAG / GraphRAG、审图、证据链、人工复核或审计留痕时，才启用 `aios-*` 行业增强。
+
+## 触发场景
+
+- PR 合并前。
+- AI 生成代码进入仓库。
+- 涉及权限、安全、依赖、Runtime 或生产发布。
+- 大范围重构或多模块变更。
+
+## 参与角色与 Skill
+
+| 阶段 | 主 Agent | Skill |
+| --- | --- | --- |
+| 质量审查 | Argus | `aios-review` |
+| 架构边界复核 | Atlas | `aios-arch` |
+| 修复执行 | Hephaestus | `aios-exec` |
+| 交付协调 | Mason | `aios-plan` |
+| Runtime 风险 | Daedalus | `aios-runtime` |
+
+## 输入
+
+- diff / PR / commit。
+- 需求背景和验收标准。
+- 测试、构建、lint、typecheck 输出。
+- 权限、Runtime、Prompt 或 Tool 配置。
+
+## 执行顺序
+
+1. Argus 先看需求和预期行为，再审查 diff。
+2. Argus 按 P0-P3 输出问题，先列阻断项。
+3. Atlas 复核架构边界问题。
+4. Daedalus 复核 Runtime / MCP / Memory / Prompt 风险。
+5. Hephaestus 修复明确问题。
+6. Argus 复审。
+
+## 输出
+
+- 阻断问题。
+- 非阻断建议。
+- 测试缺口。
+- 剩余风险。
+- 合并或发布建议。
+
+## 验收标准
+
+- 阻断问题已修复或明确不发布。
+- 测试缺口被补齐或记录。
+- 没有无关风格挑刺。
+- 没有未经验证的完成声明。

package/workflows/feature-development.md

@@ -1,72 +1,74 @@
-# Feature 开发 Workflow
-
-## 定位
-
-用于从需求进入受控实现的标准流程。目标是把业务目标转成可执行、可审查、可验证的工程交付。
-
-## 触发场景
-
-- 新功能开发。
-- 多模块需求实现。
-- AI 生成方案需要进入工程执行。
-- 需要明确 Agent、Skill、验收和发布顺序。
-
-## 参与角色与 Skill
-
-| 阶段 | 主 Agent | Skill |
-| --- | --- | --- |
-| 架构边界 | Atlas | `aios-arch` |
-| 任务拆解 | Mason | `aios-plan` |
-| 受控实现 | Hephaestus | `aios-exec` |
-| 质量审查 | Argus | `aios-review` |
-| AI Runtime 相关 | Daedalus | `aios-runtime` |
-| BIM / IFC / 行业语义相关 | Vitruvius | `aios-knowledge` |
-
-## 输入
-
-- 需求目标和业务背景。
-- 当前项目结构和相关模块。
-- 约束条件：时间、权限、技术栈、发布节奏。
-- 已知风险、历史决策和不得破坏的行为。
-
-## 执行顺序
-
-1. Atlas 判断需求是否涉及架构边界、数据模型、Runtime 或长期复杂度。
-2. Mason 将需求拆成任务、依赖、验收标准和执行顺序。
-3. Hephaestus 按 Mason 的任务执行最小改动。
-4. Argus 审查 diff、测试缺口、安全和技术债风险。
-5. Mason 汇总交付状态、剩余风险和发布条件。
-
-## 升级规则
-
-- 涉及服务边界、数据模型、核心技术栈：升级给 Atlas。
-- 涉及权限、安全、Prompt 注入、生产发布：升级给 Argus。
-- 涉及 RAG、GraphRAG、MCP、Memory、Tool Calling：升级给 Daedalus。
-- 涉及 BIM、IFC、规范、审图逻辑：升级给 Vitruvius。
-- 任务拆解不清、依赖复杂或交付顺序冲突：升级给 Mason。
-
-## 输出
-
-- 架构判断。
-- 任务拆解。
-- 实现变更。
-- Review 结果。
-- 验证证据。
-- 剩余风险和发布建议。
-
-## 验收标准
-
-- 每个任务有明确输入、输出和验证方式。
-- 实现只触碰必要范围。
-- 关键路径经过测试、构建、lint 或人工检查。
-- Argus 无阻断问题。
-- 未验证项被明确记录。
-
-## 回滚与恢复
-
-- 每个实现任务应在独立分支或可审查 diff 中完成。
-- Hephaestus 只能回滚本次任务范围内的改动，不得回滚用户或其他 Agent 的无关改动。
-- 如果测试、构建或 Argus 审查失败，回到 Hephaestus 修复阶段，并保留失败证据。
-- 如果失败源于任务拆解错误，回到 Mason 重新拆解依赖和执行顺序。
-- 如果失败源于架构边界或技术选型错误，回到 Atlas 重新评审。
-- 发布前必须明确回滚方式：Git revert、配置回退、数据库迁移回滚或人工恢复步骤。
+# Feature 开发 Workflow
+
+## 定位
+
+用于从需求进入受控实现的标准流程。目标是把业务目标转成可执行、可审查、可验证的工程交付。
+
+本 Workflow 面向建筑行业项目的 feature 交付增强。普通非建筑功能开发优先使用宿主工具的通用工程流程；只有项目 profile、上下文或任务事实涉及建筑行业语义、工程知识、RAG / GraphRAG、审图、证据链、人工复核或审计留痕时，才启用 `aios-*` 行业增强。
+
+## 触发场景
+
+- 新功能开发。
+- 多模块需求实现。
+- AI 生成方案需要进入工程执行。
+- 需要明确 Agent、Skill、验收和发布顺序。
+
+## 参与角色与 Skill
+
+| 阶段 | 主 Agent | Skill |
+| --- | --- | --- |
+| 架构边界 | Atlas | `aios-arch` |
+| 任务拆解 | Mason | `aios-plan` |
+| 受控实现 | Hephaestus | `aios-exec` |
+| 质量审查 | Argus | `aios-review` |
+| AI Runtime 相关 | Daedalus | `aios-runtime` |
+| BIM / IFC / 行业语义相关 | Vitruvius | `aios-knowledge` |
+
+## 输入
+
+- 需求目标和业务背景。
+- 当前项目结构和相关模块。
+- 约束条件：时间、权限、技术栈、发布节奏。
+- 已知风险、历史决策和不得破坏的行为。
+
+## 执行顺序
+
+1. Atlas 判断需求是否涉及架构边界、数据模型、Runtime 或长期复杂度。
+2. Mason 将需求拆成任务、依赖、验收标准和执行顺序。
+3. Hephaestus 按 Mason 的任务执行最小改动。
+4. Argus 审查 diff、测试缺口、安全和技术债风险。
+5. Mason 汇总交付状态、剩余风险和发布条件。
+
+## 升级规则
+
+- 涉及服务边界、数据模型、核心技术栈：升级给 Atlas。
+- 涉及权限、安全、Prompt 注入、生产发布：升级给 Argus。
+- 涉及 RAG、GraphRAG、MCP、Memory、Tool Calling：升级给 Daedalus。
+- 涉及 BIM、IFC、规范、审图逻辑：升级给 Vitruvius。
+- 任务拆解不清、依赖复杂或交付顺序冲突：升级给 Mason。
+
+## 输出
+
+- 架构判断。
+- 任务拆解。
+- 实现变更。
+- Review 结果。
+- 验证证据。
+- 剩余风险和发布建议。
+
+## 验收标准
+
+- 每个任务有明确输入、输出和验证方式。
+- 实现只触碰必要范围。
+- 关键路径经过测试、构建、lint 或人工检查。
+- Argus 无阻断问题。
+- 未验证项被明确记录。
+
+## 回滚与恢复
+
+- 每个实现任务应在独立分支或可审查 diff 中完成。
+- Hephaestus 只能回滚本次任务范围内的改动，不得回滚用户或其他 Agent 的无关改动。
+- 如果测试、构建或 Argus 审查失败，回到 Hephaestus 修复阶段，并保留失败证据。
+- 如果失败源于任务拆解错误，回到 Mason 重新拆解依赖和执行顺序。
+- 如果失败源于架构边界或技术选型错误，回到 Atlas 重新评审。
+- 发布前必须明确回滚方式：Git revert、配置回退、数据库迁移回滚或人工恢复步骤。