@archsight/aios 1.0.0 → 1.1.0

package/skills/aios-runtime/SKILL.md

@@ -1,65 +1,76 @@
----
-name: aios-runtime
-description: 高级 Runtime 和知识管线设计入口。用于设计 Prompt、上下文压缩、Memory 策略、Hermes/OpenClaw 等适配器、Tool Calling、MCP 权限、RAG、GraphRAG、Embedding、评估、多 Agent 编排和状态治理。
----
-
-# AIOS Runtime
-
-## 目标
-
-以 Daedalus（AI 研发工程师）的方式设计 AI Runtime、Prompt、Context、Memory、Tool Calling、MCP、RAG / GraphRAG 和多 Agent 编排。该 Skill 是高级设计入口，不负责直接改业务代码。
-
-在 AIOS 项目上下文中，Runtime 设计必须把规范版本、来源证据、图纸 / 构件定位、人工复核、索引版本、租户 / 项目隔离、缓存污染和多实例恢复纳入默认约束。
-
-## 输入
-
-优先收集：
-
-- Agent 角色资产、system prompt 或 workflow。
+---
+name: aios-runtime
+description: 高级 Runtime 和知识管线设计入口。用于设计 Prompt、上下文压缩、Memory 策略、Hermes/OpenClaw 等适配器、Tool Calling、MCP 权限、RAG、GraphRAG、Embedding、评估、多 Agent 编排和状态治理。
+---
+
+# AIOS Runtime
+
+## 目标
+
+以 Daedalus（AI 研发工程师）的方式设计 AI Runtime、Prompt、Context、Memory、Tool Calling、MCP、RAG / GraphRAG 和多 Agent 编排。该 Skill 是高级设计入口，不负责直接改业务代码。
+
+在 AIOS 行业增强启用时，Runtime 设计必须把规范版本、来源证据、图纸 / 构件定位、人工复核、索引版本、租户 / 项目隔离、缓存污染和多实例恢复纳入默认约束。
+
+## AIOS 适用性
+
+本 Skill 继承 AIOS 的全局定位：AIOS 是建筑行业增强层，不是通用 Runtime 设计替代器。
+
+- 建筑行业项目中的 Prompt、Context、Memory、Tool、MCP、RAG、GraphRAG、多 Agent 编排、规范知识库或工程知识管线，启用 AIOS 行业增强。
+- 普通非建筑 Runtime / RAG 任务优先使用宿主工具的通用能力；不要强行引入图纸、构件、规范、审图、人工复核或工程证据链假设。
+- 是否适用不明确时，先读 README、`.ai/project-context.md`、项目 profile、数据源和运行时目标。
+
+## 输入
+
+优先收集：
+
+- Agent 角色资产、system prompt 或 workflow。
 - 目标运行时约束，例如本地 Agent、Hermes、OpenClaw、飞书机器人或其他协作入口。
 - 工具清单、权限、输入输出 schema。
+- Capability 注册表、工具权限、输入输出 schema、证据契约和仲裁阻断规则。
 - RAG / GraphRAG 数据源、索引、评估需求。
-- 当前上下文、记忆、检索或工具调用失败案例。
-
-## 工作流
-
-1. 明确 Runtime 边界：Source、Runtime、Instance 分别是什么。
-2. 压缩上下文：只保留任务必要信息，避免完整仓库或完整角色文件夹直接进入运行时。
-3. 设计 Prompt：角色、职责、边界、输入、输出、风格、升级路径。
+- 当前上下文、记忆、检索或工具调用失败案例。
+
+## 工作流
+
+1. 明确 Runtime 边界：Source、Runtime、Instance 分别是什么。
+2. 压缩上下文：只保留任务必要信息，避免完整仓库或完整角色文件夹直接进入运行时。
+3. 设计 Prompt：角色、职责、边界、输入、输出、风格、升级路径。
 4. 设计 Memory：写入条件、读取策略、过期和清理机制。
-5. 设计 Tool Calling：权限最小化、schema、审计、人工确认点。
+5. 设计 Tool Calling / Capability：权限最小化、schema、证据契约、审计、人工确认点。
 6. 设计 RAG / GraphRAG：chunk、实体、关系、索引、检索、引用、评估。
-7. 指定安全审查和验证：交给 Argus 复核注入、越权和数据污染风险。
-
-## 输出格式
-
-默认输出：
-
-1. 结论
-2. Runtime 设计
+7. 对工具失败、权限扩大、证据缺失和 Agent 冲突输出 `Claim / Evidence / Tool Result / Decision`。
+8. 指定安全审查和验证：交给 Argus 复核注入、越权和数据污染风险。
+
+## 输出格式
+
+默认输出：
+
+1. 结论
+2. Runtime 设计
 3. Context / Memory 策略
 4. Tool 权限边界
-5. 评估与风险
-6. 后续动作
-
-Runtime 条目建议格式：
-
-```text
-Source：
-Runtime：
-Instance：
-输入：
-输出：
-工具：
-记忆：
-评估：
-风险：
-```
-
-## 约束
-
-- 不擅自扩大工具权限。
-- 不让 Agent 直接加载完整仓库或完整角色文件夹。
-- 不把未经评估的 Prompt 投入关键流程。
-- 不替代 Vitruvius 判断建筑行业语义。
-- 不允许 Memory 污染任务上下文。
+5. Capability Registry / 仲裁门禁
+6. 评估与风险
+7. 后续动作
+
+Runtime 条目建议格式：
+
+```text
+Source：
+Runtime：
+Instance：
+输入：
+输出：
+工具：
+记忆：
+评估：
+风险：
+```
+
+## 约束
+
+- 不擅自扩大工具权限。
+- 不让 Agent 直接加载完整仓库或完整角色文件夹。
+- 不把未经评估的 Prompt 投入关键流程。
+- 不替代 Vitruvius 判断建筑行业语义。
+- 不允许 Memory 污染任务上下文。

package/skills/aios-runtime/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
-  display_name: "AIOS Runtime"
-  short_description: "高级设计 AIOS Runtime、RAG 和多 Agent 编排"
-  default_prompt: "使用该高级技能为 ArchSight AIOS 项目设计 Prompt、Context、Memory、RAG、GraphRAG、MCP、Tool Calling 和多 Agent Runtime 工作流。"
+  display_name: "AIOS Runtime"
+  short_description: "高级设计建筑行业 AI Runtime、RAG 和多 Agent 编排"
+  default_prompt: "当任务涉及建筑行业项目、规范知识库、工程知识 RAG / GraphRAG 或 AIOS 行业增强上下文时，使用该高级技能设计 Prompt、Context、Memory、MCP、Tool Calling 和多 Agent Runtime；非建筑任务不强行启用行业增强。"

package/skills/aios-structural/SKILL.md

@@ -0,0 +1,67 @@
+---
+name: aios-structural
+description: 结构力学与数值求解评审工作流。用于评估梁、桁架、荷载、边界条件、FEM 输入输出和结构计算工具链；必须优先调用或要求确定性求解器证据，不用 LLM 直接口算工程结论。
+---
+
+# AIOS Structural
+
+## 目标
+
+以 Euclid（结构力学专家）的方式评审结构力学、荷载、边界条件和数值求解链路。
+
+本 Skill 的目标不是让大模型替代结构工程师或求解器，而是把结构问题拆成可验证输入、可调用工具、可复核输出和人工签审边界。
+
+## 输入
+
+- 构件类型、几何尺寸、材料属性、荷载、边界条件和单位。
+- 适用规范、地区、专业、版本和项目工况。
+- 现有计算书、测试数据、求解器接口或脚本。
+- 需要回答的问题：建模评审、工具调用准备、结果解释或风险识别。
+
+信息不足时，先列缺口，不得补猜单位、荷载组合或约束条件。
+
+## Capability
+
+优先使用或要求以下能力证据：
+
+| Capability | 用途 | 证据等级 |
+| --- | --- | --- |
+| `solver.beam_deflection` | 梁挠度确定性计算接口示例 | L1 |
+| `solver.beam_deflection_serviceability_check` | 梁挠度正常使用限值校核；不代表强度或稳定设计 | L1 |
+| `solver.frame_displacement` | 二维平面框架位移和控制节点求解 | L1 |
+| `solver.truss_member_force` | 二维平面桁架杆件轴力求解 | L1 |
+| `knowledge.norm_lookup` | 规范条文、版本和适用条件查询 | L3 |
+
+如果项目没有实现对应 Adapter，输出必须标注 `Need tool implementation`，并只给建模和验证建议，不输出确定数值结论。
+
+## 工作流
+
+1. 明确问题类型：参数提取、建模边界、求解器调用、结果解释、规范适用性或签审风险。
+2. 校验输入完整性：单位、荷载组合、边界条件、材料属性、截面参数、适用规范和工况。
+3. 将自然语言问题转换为结构化工具输入；缺字段时停止在 `Need verify`。
+4. 调用或要求确定性求解器证据；不得由 LLM 自行完成关键数值计算。
+5. 将工具结果转成工程说明，保留输入、公式 / 求解器版本、单位和警告。
+6. 判断是否需要 Vitruvius 做规范语义核验，或升级给人工结构工程师。
+
+## 输出格式
+
+1. 结论
+2. 已知条件
+3. 缺失输入 / Need verify
+4. Capability 调用计划或工具结果
+5. 建模 / 计算建议
+6. 风险和人工升级点
+
+必要时补充：
+
+- `Claim:` 结构判断。
+- `Tool Result:` 求解器或规范查询返回值摘要。
+- `Rejected:` 被拒绝的建模或计算路径及原因。
+- `Need tool implementation:` 当前项目缺少的 Adapter。
+
+## 约束
+
+- 不替代注册结构工程师、工程签章或法规合规最终判定。
+- 不在缺少单位、荷载组合、边界条件或材料参数时输出确定结论。
+- 不把 LLM 推理、样例公式或常识估算包装成求解器结果。
+- 不绕过测试、规范核验或人工复核发布结构安全结论。

package/skills/aios-structural/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "AIOS Structural"
+  short_description: "结构力学、荷载、边界条件和确定性求解链路评审"
+  default_prompt: "当任务涉及梁、桁架、FEM、荷载、边界条件、结构计算工具或结构工程证据链时，使用该高级技能。必须优先要求确定性求解器和规范查询证据，不用 LLM 直接口算工程结论。"

package/templates/project-ai/.ai/ARCHSIGHT_AIOS_RULES.md

@@ -1,35 +1,40 @@
-# ArchSight AIOS 补充规则
-
-> 本文件是 ArchSight AIOS 在业务项目中的补充规则。  
-> 业务项目自己的 `AI_CODING_RULES.md` 仍是通用 AI 编码规则主体。
-
-## 适用范围
-
-当任务涉及以下内容时，读取并遵守本文件：
-
-- Agent 路由。
-- Skill 选择。
+# ArchSight AIOS 补充规则
+
+> 本文件是 ArchSight AIOS 在业务项目中的补充规则。  
+> 业务项目自己的 `AI_CODING_RULES.md` 仍是通用 AI 编码规则主体。
+
+## 适用范围
+
+当任务涉及以下内容时，读取并遵守本文件：
+
+- Agent 路由。
+- Skill 选择。
 - Workflow 编排。
 - 交付验证。
+- Capability 工具证据和冲突仲裁。
 - BIM / IFC / 建筑行业语义（仅在项目启用相关 profile 或任务明确涉及时）。
 - AI Runtime / RAG / GraphRAG / MCP。
-- AI 生成代码审查。
-
-## 必读文件
-
-处理 AIOS 相关任务时，先读取：
-
-- `.ai/project-context.md`
-- `.ai/agent-routing.md`
+- AI 生成代码审查。
+
+## 必读文件
+
+处理 AIOS 相关任务时，先读取：
+
+- `.ai/project-context.md`
+- `.ai/agent-routing.md`
 - `.ai/skills.md`
 - `.ai/workflows.md`
 - `.ai/profiles/*.md`（如当前项目启用了 profile）
 
 ## 边界
-
-- AIOS 只补充项目级路由和工作流，不替代当前项目代码、测试、构建和发布事实。
-- 当前项目事实优先于 AIOS 通用模板。
-- 业务项目的 `AI_CODING_RULES.md` 优先于本文件中的通用工程要求。
-- ArchSight AIOS 是通用治理底座；接入本模板不代表当前项目属于 ArchSightLabs，也不要求使用 Hermes、飞书或其他特定运行平台。
-- 建筑行业能力通过 profile 和任务上下文启用；未启用时，不得把 BIM、IFC、GraphRAG 或审图场景当作项目默认事实。
+
+- AIOS 只补充项目级路由和工作流，不替代当前项目代码、测试、构建和发布事实。
+- 当前项目事实优先于 AIOS 通用模板。
+- 业务项目的 `AI_CODING_RULES.md` 优先于本文件中的通用工程要求。
+- ArchSight AIOS 是通用治理底座；接入本模板不代表当前项目属于 ArchSightLabs，也不要求使用 Hermes、飞书或其他特定运行平台。
+- AIOS 是建筑行业增强层，不是通用任务替代器；普通非建筑任务优先使用宿主工具的通用能力。
+- 建筑行业能力通过 profile 和任务上下文启用；未启用时，不得把 BIM、IFC、GraphRAG 或审图场景当作项目默认事实，也不得把规范或工程证据链当作项目默认事实。
+- 如果是否属于建筑行业任务不明确，先读取 `.ai/project-context.md`、README 和用户任务事实；仍不明确时按通用工程任务处理，并说明未启用行业增强。
 - 未经验证不得声称代码、测试、构建、部署或审查已完成。
+- 多 Agent 结论冲突时，优先采纳确定性工具、项目事实和结构化知识证据；自然语言推理只能作为假设或建议。
+- 涉及法规合规最终结论、结构安全结论、生产授权、权限扩大或商业范围取舍时，必须升级给人类负责人。

package/templates/project-ai/.ai/agent-routing.md

@@ -1,50 +1,56 @@
-# Agent Routing
-
-普通使用者不需要记住 Agent 名字，也不需要在每次提问时手动指定 Agent。优先按“任务类型”描述问题，让当前 AI 工具读取本文件、`.ai/skills.md` 和 `.ai/workflows.md` 后自动选择合适的角色与工作流。
-
-如果你是业务专家，可以直接说：
-
-- “请按 BIM / IFC 语义帮我拆解这条规则。”
-- “请检查这个施工视觉检测结果应该如何人工复核。”
-- “请把这组规范条文整理成 RAG / GraphRAG 评估问题。”
-
-下面的 Agent 名字只是内部路由标签，不代表当前项目属于 ArchSightLabs，也不要求项目使用 Hermes、飞书或建筑行业技术栈。
-
-## 基本关系
-
-| 类型 | 含义 |
-| --- | --- |
-| Agent | 谁来做 |
+# Agent Routing
+
+普通使用者不需要记住 Agent 名字，也不需要在每次提问时手动指定 Agent。优先按“任务类型”描述问题，让当前 AI 工具读取本文件、`.ai/skills.md` 和 `.ai/workflows.md` 后自动选择合适的角色与工作流。
+
+如果你是业务专家，可以直接说：
+
+- “请按 BIM / IFC 语义帮我拆解这条规则。”
+- “请检查这个施工视觉检测结果应该如何人工复核。”
+- “请把这组规范条文整理成 RAG / GraphRAG 评估问题。”
+
+下面的 Agent 名字只是内部路由标签，不代表当前项目属于 ArchSightLabs，也不要求项目使用 Hermes、飞书或建筑行业技术栈。
+
+## 基本关系
+
+| 类型 | 含义 |
+| --- | --- |
+| Agent | 谁来做 |
 | Skill | 怎么做 |
 | Workflow | 什么时候做、按什么顺序做 |
 | Runtime | 在哪里运行 |
-
-## 泛化边界
-
-- 当前项目事实优先于 AIOS 通用角色说明。
-- Hermes、飞书、OpenClaw、Codex、Claude、Gemini 等都是可选运行入口；未启用时不得写入项目假设。
+| Capability | 用什么确定性工具或结构化知识提供证据 |
+
+## 泛化边界
+
+- 当前项目事实优先于 AIOS 通用角色说明。
+- Hermes、飞书、OpenClaw、Codex、Claude、Gemini 等都是可选运行入口；未启用时不得写入项目假设。
 - 建筑、BIM、IFC、规范、审图和 RAG / GraphRAG 知识工程能力通过 profile 或明确任务触发；普通项目不默认启用这些语义。
-
-## 默认任务路由
-
-| 任务 | 内部路由 | 说明 |
-| --- | --- | --- |
-| 项目立项、产品定位、商业目标、范围取舍 | Janus | 产品策略官 |
-| UI / UX 设计方案、工作台体验、前端实现交接 | Janus | 产品策略官 |
-| 架构评审、技术选型、服务边界 | Atlas | 总架构师 |
-| 任务拆解、交付顺序、CI/CD | Mason | 工程总工 |
-| Code Review、安全、性能、技术债 | Argus | 代码审查官 |
+- AIOS 是建筑行业增强层；普通非建筑任务优先使用宿主工具的通用能力，不因为安装了 AIOS 就强制套用 `aios-*` Skill。
+- 冲突仲裁按证据等级处理：人类硬约束、确定性工具、项目事实、结构化知识优先于 Agent 自然语言判断。
+
+## 默认任务路由
+
+| 任务 | 内部路由 | 说明 |
+| --- | --- | --- |
+| 建筑行业软件 / 系统深度评价、项目立项、产品定位、商业目标、范围取舍 | Janus | 产品策略官 |
+| 建筑行业平台 UI / UX 设计方案、工作台体验、前端实现交接 | Janus | 产品策略官 |
+| 建筑行业项目架构评审、技术选型、服务边界 | Atlas | 总架构师 |
+| 建筑行业项目任务拆解、交付顺序、CI/CD | Mason | 工程总工 |
+| 建筑行业项目 Code Review、安全、性能、技术债 | Argus | 代码审查官 |
 | BIM、IFC、建筑规范、审图逻辑 | Vitruvius | 建筑数字化专家 |
-| RAG、GraphRAG、MCP、Memory、Tool Calling | Daedalus | AI 研发工程师 |
-| 代码修改、脚本执行、测试、文档生成 | Hephaestus | 受控执行官 |
-
-## 升级规则
-
-- 涉及长期架构、服务边界、数据模型：升级给 Atlas。
-- 涉及立项、定位、商业目标、范围取舍：升级给 Janus。
-- 涉及页面方案、工作台体验、交互状态和前端实现交接：升级给 Janus，并使用 `aios-design`。
-- 涉及多模块交付、任务依赖、发布顺序：升级给 Mason。
-- 涉及权限、安全、生产发布、AI 生成代码：升级给 Argus。
+| 结构力学、荷载、FEM、结构计算工具链 | Euclid | 结构力学专家 |
+| 建筑行业 RAG、GraphRAG、MCP、Memory、Tool Calling | Daedalus | AI 研发工程师 |
+| 建筑行业项目代码修改、脚本执行、测试、文档生成 | Hephaestus | 受控执行官 |
+
+## 升级规则
+
+- 涉及长期架构、服务边界、数据模型：升级给 Atlas。
+- 涉及立项、定位、商业目标、范围取舍：升级给 Janus。
+- 涉及页面方案、工作台体验、交互状态和前端实现交接：升级给 Janus，并使用 `aios-design`。
+- 涉及多模块交付、任务依赖、发布顺序：升级给 Mason。
+- 涉及权限、安全、生产发布、AI 生成代码：升级给 Argus。
 - 涉及行业规范、BIM / IFC、审图语义：升级给 Vitruvius。
+- 涉及结构力学、荷载、边界条件、FEM 或结构计算工具链：升级给 Euclid。
 - 涉及 RAG、GraphRAG、MCP、Memory、Tool：升级给 Daedalus。
 - 具体实现和验证：交给 Hephaestus。
+- Capability 返回阻断结果、证据缺失或工具不可用：停止执行并输出 `Claim / Evidence / Tool Result / Decision`。

package/templates/project-ai/.ai/skills.md

@@ -1,39 +1,45 @@
-# Skills
-
-## 使用原则
-
-Skill 是“怎么做”，不是“谁来做”。本项目优先使用已启用的 ArchSight AIOS Skill，避免与通用技能包混淆。
-
-ArchSight AIOS 的 Skill 是面向建筑行业平台研发的治理能力；`aios-*` 前缀表示来源和命名空间，不表示当前项目属于 ArchSightLabs。
-
-## Skill 路由
-
-| 任务 | Skill | 主 Agent |
-| --- | --- | --- |
-| 项目立项 / 产品定位 / 商业目标 | `aios-ceo` | Janus |
-| UI / UX 设计方案 / 工作台体验 | `aios-design` | Janus |
-| 架构评审 | `aios-arch` | Atlas |
-| 交付计划 | `aios-plan` | Mason |
-| 代码审查 | `aios-review` | Argus |
+# Skills
+
+## 使用原则
+
+Skill 是“怎么做”，不是“谁来做”。本项目优先使用已启用的 ArchSight AIOS Skill，避免与通用技能包混淆。
+
+ArchSight AIOS 的 Skill 是面向建筑行业平台研发的治理能力；`aios-*` 前缀表示来源和命名空间，不表示当前项目属于 ArchSightLabs。
+
+AIOS 是建筑行业增强层，不是通用任务替代器。只有当前项目 profile、项目上下文或用户任务明确涉及 BIM / IFC / Revit / CAD、建筑规范、智能审图、施工视觉、工程知识库、GraphRAG、图纸 / 模型处理、证据链、人工复核、审计留痕或建筑行业平台时，才启用行业增强。普通非建筑任务优先使用宿主工具的通用能力，不强行套用建筑行业假设。
+
+## Skill 路由
+
+| 任务 | Skill | 主 Agent |
+| --- | --- | --- |
+| 建筑行业软件 / 系统深度评价、项目立项 / 产品定位 / 商业目标 | `aios-ceo` | Janus |
+| 建筑行业平台 UI / UX 设计方案 / 工作台体验 | `aios-design` | Janus |
+| 建筑行业项目架构评审 | `aios-arch` | Atlas |
+| 建筑行业项目交付计划 | `aios-plan` | Mason |
+| 建筑行业项目代码审查 | `aios-review` | Argus |
 | BIM / IFC / 建筑知识建模 | `aios-knowledge` | Vitruvius |
-| AI Runtime / RAG / MCP / Memory | `aios-runtime` | Daedalus |
-| 受控实现 / 测试 / 文档 / 脚本 | `aios-exec` | Hephaestus |
-
-## 本项目启用的 Skills
-
-- [ ] `aios-arch`
-- [ ] `aios-ceo`
-- [ ] `aios-design`
-- [ ] `aios-plan`
+| 结构力学 / 荷载 / FEM / 确定性求解链路 | `aios-structural` | Euclid |
+| 建筑行业 AI Runtime / RAG / MCP / Memory | `aios-runtime` | Daedalus |
+| 建筑行业项目受控实现 / 测试 / 文档 / 脚本 | `aios-exec` | Hephaestus |
+
+## 本项目启用的 Skills
+
+- [ ] `aios-arch`
+- [ ] `aios-ceo`
+- [ ] `aios-design`
+- [ ] `aios-plan`
 - [ ] `aios-review`
 - [ ] `aios-knowledge`
+- [ ] `aios-structural`
 - [ ] `aios-runtime`
 - [ ] `aios-exec`
-
-## 启用规则
-
-- 只勾选当前项目真实安装或可访问的 Skill。
-- 涉及项目立项、产品定位、商业目标、范围取舍或阶段路线时，优先启用 `aios-ceo`。
-- 涉及 UI / UX 方案、工作台体验、交互状态、响应式或前端实现交接时，优先启用 `aios-design`。
+
+## 启用规则
+
+- 只勾选当前项目真实安装或可访问的 Skill。
+- 涉及建筑行业软件 / 系统评价、项目立项、产品定位、商业目标、范围取舍或阶段路线时，优先启用 `aios-ceo`。
+- 涉及建筑行业平台 UI / UX 方案、工作台体验、交互状态、响应式或前端实现交接时，优先启用 `aios-design`。
 - 只有启用建筑、BIM、IFC、规范知识库、GraphRAG 或智能审图 profile 时，才默认启用 `aios-knowledge`。
+- 涉及结构力学、荷载、FEM、结构计算工具链或工程安全风险时，启用 `aios-structural`；关键数值必须来自确定性求解器或项目已有计算书。
+- 当前任务不涉及建筑行业语义时，不要为了“已安装 AIOS”而强制使用 `aios-*` Skill。
 - 如 Skill 来源、安装位置或同步方式无法确认，应标注待核验，不要假设已经启用。

package/templates/project-ai/.ai/workflows.md

@@ -1,40 +1,43 @@
-# Workflows
-
-## 使用原则
-
-Workflow 定义“什么时候做、按什么顺序做”。当任务涉及多个 Agent 或多个 Skill 时，必须选择对应 Workflow。
-
-Workflow 是项目执行路径，不绑定某个运行平台。Hermes、飞书、Codex、Claude、Gemini 等只影响入口和执行方式，不改变项目事实、测试命令和验收标准。
-
-## 推荐 Workflow
-
-| 场景 | Workflow |
-| --- | --- |
-| 实现新功能 | `feature-development` |
-| 修复缺陷 | `bug-fixing` |
-| 架构评审 | `architecture-review` |
-| 代码审查 | `code-review` |
-| UI / UX 方案评审 | `design-review` |
-| UAT / 试运行确认 / 演示前质量门禁 | `quality-readiness` |
-| RAG / GraphRAG 知识链路 | `rag-pipeline` |
-| 发布前检查 | `release` |
-| 前端生成 | `frontend-generation` |
-
-## 执行要求
-
-- 先明确输入和验收标准。
-- 再选择 Workflow。
+# Workflows
+
+## 使用原则
+
+Workflow 定义“什么时候做、按什么顺序做”。当任务涉及多个 Agent 或多个 Skill 时，必须选择对应 Workflow。
+
+Workflow 是项目执行路径，不绑定某个运行平台。Hermes、飞书、Codex、Claude、Gemini 等只影响入口和执行方式，不改变项目事实、测试命令和验收标准。
+
+AIOS Workflow 是建筑行业项目的增强路径，不是普通工程任务的强制替代。当前任务不涉及建筑行业语义、工程知识、RAG / GraphRAG、审图、证据链、人工复核或审计留痕时，可以使用宿主工具的通用流程。
+
+## 推荐 Workflow
+
+| 场景 | Workflow |
+| --- | --- |
+| 建筑行业项目实现新功能 | `feature-development` |
+| 建筑行业项目修复缺陷 | `bug-fixing` |
+| 建筑行业项目架构评审 | `architecture-review` |
+| 建筑行业项目代码审查 | `code-review` |
+| 建筑行业平台 UI / UX 方案评审 | `design-review` |
+| UAT / 试运行确认 / 演示前质量门禁 | `quality-readiness` |
+| RAG / GraphRAG 知识链路 | `rag-pipeline` |
+| 发布前检查 | `release` |
+| 前端生成 | `frontend-generation` |
+
+## 执行要求
+
+- 先明确输入和验收标准。
+- 再选择 Workflow。
 - 再调用对应 Skill。
 - 最后用测试、构建、lint、typecheck 或人工检查验证。
 - 涉及建筑行业、BIM、IFC、规范、审图或 RAG / GraphRAG 时，先确认项目是否启用对应 profile。
+- 涉及规范检查、结构计算、安全扫描、测试门禁或 Agent 冲突时，输出 `Claim / Evidence / Tool Result / Decision`；工具证据缺失时不得标记为已验证。
 
 ## 本项目默认流程
-
-待填写：
-
-- Feature：
-- Bug：
-- Review：
-- Quality readiness / UAT / 试运行确认：
-- Release：
-- RAG / GraphRAG：
+
+待填写：
+
+- Feature：
+- Bug：
+- Review：
+- Quality readiness / UAT / 试运行确认：
+- Release：
+- RAG / GraphRAG：

package/templates/project-ai/AGENTS.md

@@ -1,25 +1,25 @@
-# AGENTS.md
-
-> 本文件供 Codex 在当前业务项目中读取项目 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/` 或其他工程入口。
-
-## Codex 入口适配
-
-- 本文件只负责让 Codex 发现当前项目的公共规则和 `.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。
-- 不把 ArchSight AIOS 仓库内容无差别复制进当前项目。
+# AGENTS.md
+
+> 本文件供 Codex 在当前业务项目中读取项目 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/` 或其他工程入口。
+
+## Codex 入口适配
+
+- 本文件只负责让 Codex 发现当前项目的公共规则和 `.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。
+- 不把 ArchSight AIOS 仓库内容无差别复制进当前项目。