@archsight/aios 1.0.0 → 1.1.0

package/workflows/feature-development.md

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

package/workflows/rag-pipeline.md

@@ -28,15 +28,18 @@
 - 目标问题和用户场景。
 - 数据规模、更新频率、版本和来源。
 - 期望引用、追溯和评估方式。
+- 可用 Capability，例如 `knowledge.norm_lookup`、测试 / eval runner、GraphRAG 构建检查。
 
 ## 执行顺序
 
 1. Vitruvius 拆解领域对象、术语、条文条件和待核验项。
 2. Daedalus 设计 chunk、抽取、embedding、索引、检索、重排、引用和评估。
-3. Atlas 判断知识层、平台层和 Runtime 层边界。
-4. Mason 拆解实现任务和验证路径。
-5. Hephaestus 执行受控实现或文档落地。
-6. Argus 审查数据污染、Prompt 注入、工具权限和发布风险。
+3. 使用或要求 `knowledge.norm_lookup` 等 Capability 证据校验规范版本、适用条件、来源页码和冲突关系。
+4. Atlas 判断知识层、平台层和 Runtime 层边界。
+5. Mason 拆解实现任务和验证路径。
+6. Hephaestus 执行受控实现或文档落地。
+7. Argus 审查数据污染、Prompt 注入、工具权限和发布风险。
+8. 对冲突条文、适用性不明或工具失败输出 `Claim / Evidence / Tool Result / Decision`。
 
 ## 输出
 
@@ -45,6 +48,7 @@
 - 检索和生成链路。
 - 评估指标。
 - 风险与待核验项。
+- Capability 证据和仲裁结论。
 - 后续任务。
 
 ## 验收标准
@@ -54,4 +58,4 @@
 - RAG / GraphRAG 有评估方式。
 - 不能自动判断的行业问题被标注。
 - 权限、数据污染和 Prompt 注入风险已审查。
-
+- 规范或知识结论缺少版本、来源、适用条件时不得标记为已验证。

package/workflows/review.md

@@ -1,70 +1,74 @@
-# Review 流程
-
-状态：治理基线  
-适用场景：代码审查、架构审查、安全审查、AI 生成内容审查
-
----
-
-## 目标
-
-在合并或交付前发现真实风险，优先阻止缺陷、越界修改、过度设计和安全问题。
-
-## 与 `code-review` 的关系
-
-`review.md` 是综合评审入口，适用于代码、架构、安全、AI 生成内容和交付完整性的总览审查。
-
-如果任务对象是 PR、diff、commit 或 AI 生成代码，应进入 [Code Review Workflow](code-review.md)，并使用 `aios-review`。
-
-## 角色与 Skill 路由
-
-| 审查对象 | 主 Agent | Skill | 后续 Workflow |
-| --- | --- | --- | --- |
-| PR / diff / AI 生成代码 | Argus | `aios-review` | `code-review` |
-| 架构边界 / 技术选型 | Atlas | `aios-arch` | `architecture-review` |
-| 交付计划 / 测试完整性 | Mason | `aios-plan` | `feature-development` |
-| RAG / MCP / Memory / Tool | Daedalus | `aios-runtime` | `rag-pipeline` |
-| BIM / IFC / 规范语义 | Vitruvius | `aios-knowledge` | `rag-pipeline` |
-
-## 输入
-
-- diff 或 PR。
-- 需求背景。
-- 测试结果。
-- 影响范围说明。
-
-## 输出
-
-- 按严重程度排序的 review finding。
-- 必须修复项。
-- 可选改进项。
-- 测试缺口。
-- 推荐进入的后续 workflow。
-
-## 审查重点
-
-- 是否满足明确需求。
-- 是否存在无关改动。
-- 是否过度设计。
-- 是否引入安全、权限、数据泄露风险。
-- 是否缺少关键测试。
-- 是否破坏既有行为。
-
-## 验收标准
-
-- P0 / P1 问题必须修复后才能继续。
-- P2 问题必须有修复或明确接受风险。
-- P3 建议不得阻塞交付。
-- 每个发现都应能路由到明确 Agent、Skill 或 Workflow。
-
-## 回滚与恢复
-
-- 如果评审发现阻断问题，停止当前交付，回到对应 workflow 的修复阶段。
-- 如果评审对象不清，先回到 Mason 做任务拆解。
-- 如果问题属于架构边界，回到 Atlas 做架构评审。
-- 如果已进入代码修改，回滚策略以具体项目的 Git 分支、PR 和发布策略为准。
-
-## 禁止事项
-
-- 不用风格偏好阻塞交付。
-- 不把可选重构伪装成必须修复。
-- 不忽略 AI 生成代码的越界风险。
+# Review 流程
+
+状态：治理基线  
+适用场景：代码审查、架构审查、安全审查、AI 生成内容审查
+
+---
+
+## 目标
+
+在合并或交付前发现真实风险，优先阻止缺陷、越界修改、过度设计和安全问题。
+
+## AIOS 适用性
+
+本 Workflow 面向建筑行业项目的综合评审增强。普通非建筑 PR、diff、架构或安全审查优先使用宿主工具的通用 review 能力；只有项目 profile、上下文或任务事实涉及建筑行业语义、工程知识、RAG / GraphRAG、审图、证据链、人工复核或审计留痕时，才启用 `aios-*` 行业增强。
+
+## 与 `code-review` 的关系
+
+`review.md` 是综合评审入口，适用于代码、架构、安全、AI 生成内容和交付完整性的总览审查。
+
+如果任务对象是 PR、diff、commit 或 AI 生成代码，应进入 [Code Review Workflow](code-review.md)，并使用 `aios-review`。
+
+## 角色与 Skill 路由
+
+| 审查对象 | 主 Agent | Skill | 后续 Workflow |
+| --- | --- | --- | --- |
+| 建筑行业项目中的 PR / diff / AI 生成代码 | Argus | `aios-review` | `code-review` |
+| 建筑行业项目中的架构边界 / 技术选型 | Atlas | `aios-arch` | `architecture-review` |
+| 建筑行业项目中的交付计划 / 测试完整性 | Mason | `aios-plan` | `feature-development` |
+| 建筑行业项目中的 RAG / MCP / Memory / Tool | Daedalus | `aios-runtime` | `rag-pipeline` |
+| BIM / IFC / 规范语义 | Vitruvius | `aios-knowledge` | `rag-pipeline` |
+
+## 输入
+
+- diff 或 PR。
+- 需求背景。
+- 测试结果。
+- 影响范围说明。
+
+## 输出
+
+- 按严重程度排序的 review finding。
+- 必须修复项。
+- 可选改进项。
+- 测试缺口。
+- 推荐进入的后续 workflow。
+
+## 审查重点
+
+- 是否满足明确需求。
+- 是否存在无关改动。
+- 是否过度设计。
+- 是否引入安全、权限、数据泄露风险。
+- 是否缺少关键测试。
+- 是否破坏既有行为。
+
+## 验收标准
+
+- P0 / P1 问题必须修复后才能继续。
+- P2 问题必须有修复或明确接受风险。
+- P3 建议不得阻塞交付。
+- 每个发现都应能路由到明确 Agent、Skill 或 Workflow。
+
+## 回滚与恢复
+
+- 如果评审发现阻断问题，停止当前交付，回到对应 workflow 的修复阶段。
+- 如果评审对象不清，先回到 Mason 做任务拆解。
+- 如果问题属于架构边界，回到 Atlas 做架构评审。
+- 如果已进入代码修改，回滚策略以具体项目的 Git 分支、PR 和发布策略为准。
+
+## 禁止事项
+
+- 不用风格偏好阻塞交付。
+- 不把可选重构伪装成必须修复。
+- 不忽略 AI 生成代码的越界风险。