@archsight/aios 1.0.0

package/templates/project-ai/CLAUDE.md

@@ -0,0 +1,25 @@
+# CLAUDE.md
+
+> 本文件供 Claude Code 在当前业务项目中读取项目 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/` 或其他工程入口。
+
+## Claude Code 入口适配
+
+- 本文件只负责让 Claude Code 发现当前项目的公共规则和 `.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。
+- 无法确认的行业知识、规范条文或运行时配置，应标注待核验。

package/templates/project-ai/GEMINI.md

@@ -0,0 +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。
+- 使用浏览器或外部工具前，先说明目的；操作后汇报结果。

package/templates/project-bim-platform/.ai/profiles/bim-platform.md

@@ -0,0 +1,39 @@
+# BIM / CAD / Revit 平台项目规则
+
+## 适用项目
+
+用于 BIM / IFC / Revit / CAD / Dynamo / 建模平台 / 插件 / 模型质检 / 图纸到模型相关项目。
+
+## 必读上下文
+
+- `.ai/ARCHSIGHT_AIOS_RULES.md`
+- `.ai/project-context.md`
+- `.ai/agent-routing.md`
+- `.ai/skills.md`
+- `.ai/workflows.md`
+- Revit / CAD / IFC / BIM 相关项目文档、模型样例、插件入口和数据字典。
+
+## 默认关注点
+
+- Revit API、Dynamo、AutoCAD、IFC 转换和模型数据边界。
+- 构件、空间、楼层、族、参数、属性集、分类编码和版本来源。
+- 图纸、模型、工程量、审查规则之间的可追溯关系。
+- 插件运行环境、宿主软件版本、模型样例和人工复核点。
+
+## 推荐路由
+
+| 任务 | 首选 Agent / Skill |
+| --- | --- |
+| BIM / IFC / 建筑语义建模 | Vitruvius / `aios-knowledge` |
+| 平台边界、插件架构、服务拆分 | Atlas / `aios-arch` |
+| Revit / CAD / IFC 工程实现 | Hephaestus / `aios-exec` |
+| AI Runtime、RAG、Tool Calling | Daedalus / `aios-runtime` |
+| 代码质量、安全、发布风险 | Argus / `aios-review` |
+
+## 验收要求
+
+- 标明 Revit / CAD / IFC 版本和宿主环境。
+- 说明模型样例、输入文件、输出文件和失败回退路径。
+- 对无法自动判断的工程语义标注人工确认点。
+- 不把 BIM 语义推断伪装成规范依据。
+

package/templates/project-construction-vision/.ai/profiles/construction-vision.md

@@ -0,0 +1,39 @@
+# 建筑施工视觉 AI 项目规则
+
+## 适用项目
+
+用于施工现场图像、视频、点云、目标检测、图像分割、缺陷识别、焊缝检测、裂缝检测、深度估计和现场质量巡检相关项目。
+
+## 必读上下文
+
+- `.ai/ARCHSIGHT_AIOS_RULES.md`
+- `.ai/project-context.md`
+- `.ai/agent-routing.md`
+- `.ai/skills.md`
+- `.ai/workflows.md`
+- 数据集说明、标注规范、模型评估报告、样例图片和人工复核规则。
+
+## 默认关注点
+
+- 数据来源、拍摄条件、标注口径、类别定义和隐私处理。
+- YOLO、SAM / Segment Anything、实例分割、语义分割、深度估计、OCR、点云融合等模型边界。
+- 误检、漏检、遮挡、反光、低照度、模糊、尺度变化和现场环境差异。
+- 推理结果的置信度、人工复核、缺陷严重度和工程责任边界。
+
+## 推荐路由
+
+| 任务 | 首选 Agent / Skill |
+| --- | --- |
+| 模型方案、数据闭环、评估指标 | Daedalus / `aios-runtime` |
+| 建筑构件、施工工艺、缺陷语义 | Vitruvius / `aios-knowledge` |
+| 训练脚本、推理服务、评估工具 | Hephaestus / `aios-exec` |
+| 系统边界、边缘部署、数据流 | Atlas / `aios-arch` |
+| 代码、安全、依赖和发布风险 | Argus / `aios-review` |
+
+## 验收要求
+
+- 数据集必须说明来源、授权、类别、规模和划分方式。
+- 模型输出必须包含置信度、阈值、失败样例和人工复核策略。
+- 工程缺陷结论必须区分模型检测、规则推断和人工确认。
+- 不在缺少标注规范和评估集时声称检测能力达标。
+

package/templates/project-rag-knowledge/.ai/profiles/rag-knowledge.md

@@ -0,0 +1,40 @@
+# 规范知识库 / RAG / GraphRAG 项目规则
+
+## 适用项目
+
+用于建筑规范知识库、BIM / IFC 标准知识、条文结构化、GraphRAG、审图规则、问答评估集和知识图谱相关项目。
+
+## 必读上下文
+
+- `.ai/ARCHSIGHT_AIOS_RULES.md`
+- `.ai/project-context.md`
+- `.ai/agent-routing.md`
+- `.ai/skills.md`
+- `.ai/workflows.md`
+- 知识源登记、标准版本、引用规范、评估集和不可回答问题清单。
+
+## 默认关注点
+
+- 知识源来源、版本、适用地区、适用专业和生效状态。
+- 条文、要求、对象、条件、例外、证据和待核验项的结构化表达。
+- RAG chunk、实体、关系、GraphRAG schema、引用证据和检索可复现性。
+- 冲突条文、过期标准、无法回答场景和人工审核流程。
+- 版本替代、来源元数据和复核状态是否从摄取入口贯通到图谱、向量索引、检索结果、报告和后台展示。
+
+## 推荐路由
+
+| 任务 | 首选 Agent / Skill |
+| --- | --- |
+| 规范语义、条文拆解、审查规则 | Vitruvius / `aios-knowledge` |
+| RAG / GraphRAG pipeline、Tool、Memory | Daedalus / `aios-runtime` |
+| 知识图谱边界和系统架构 | Atlas / `aios-arch` |
+| 数据处理脚本和评估执行 | Hephaestus / `aios-exec` |
+| 引用、幻觉、安全和发布审查 | Argus / `aios-review` |
+
+## 验收要求
+
+- 每个知识域至少维护 10 个代表性评估问题。
+- 回答必须保留来源、版本、适用条件和不可回答判断。
+- 不把模型推断伪装成规范原文或官方结论。
+- GraphRAG 实体和关系必须保留来源、版本和置信度。
+- 规范版本、替代关系、来源哈希、页码范围和人工复核状态不能只存在于领域模型或后台表单中，必须有端到端贯通验证。

package/templates/template-expansion-backlog.md

@@ -0,0 +1,29 @@
+# Template Expansion Backlog
+
+## 已实现 Profile
+
+| Profile | 目录 | 用途 |
+| --- | --- | --- |
+| `bim-platform` | `templates/project-bim-platform/` | BIM / IFC / Revit / CAD / 建模平台项目 |
+| `construction-vision` | `templates/project-construction-vision/` | 施工视觉 AI、检测、分割、深度估计项目 |
+| `rag-knowledge` | `templates/project-rag-knowledge/` | 规范知识库、RAG、GraphRAG、知识图谱项目 |
+
+## 可扩展 Profile 备忘
+
+| 候选 Profile | 适用方向 | 触发条件 |
+| --- | --- | --- |
+| `agent-runtime` | Agent Runtime、MCP、Tool Calling、Memory、受控执行环境 | 出现独立 AI Runtime / MCP 平台项目 |
+| `frontend-app` | 管理后台、审图工作台、BIM Viewer、数据看板 | 需要稳定 UI / UX / 浏览器验证规则 |
+| `backend-service` | API、权限、任务队列、文件处理、审计日志 | 后端服务项目数量增加 |
+| `cli-tool` | 自动化脚本、安装器、迁移工具、治理检查命令 | CLI 工具成为独立交付物 |
+| `data-pipeline` | ETL、数据清洗、标准化、批处理、索引构建 | 数据链路和评估任务复杂化 |
+| `solver-engine` | 结构力学、有限元、荷载分析、数值求解 | Euclid 相关项目进入实现阶段 |
+| `plugin-revit` | Revit 插件、Dynamo 节点、模型校验插件 | BIM 平台 profile 需要细分插件交付 |
+| `mobile-field` | 工地移动端、拍照采集、离线同步 | 现场采集端成为独立产品线 |
+
+## 扩展原则
+
+- 新 profile 只补充差异规则，不复制 `project-ai` 的公共入口。
+- 每个 profile 必须能被 `init --profile <name>` 单独验证。
+- 新 profile 必须说明适用项目、默认关注点、推荐路由和验收要求。
+- 没有真实项目牵引时，不新增空模板。

package/vision/README.md

@@ -0,0 +1,15 @@
+# Vision
+
+`vision/` 保存 ArchSight AIOS 的长期方向、阶段目标和战略取舍。
+
+推荐内容：
+
+- AI Team OS 愿景
+- 建筑行业优先、通用 AI 研发治理底座路线
+- 阶段目标
+- 战略取舍记录
+
+当前入口：
+
+- [Roadmap](roadmap.md)
+- [Strategy Principles](strategy-principles.md)

package/vision/roadmap.md

@@ -0,0 +1,29 @@
+# AIOS Roadmap
+
+## Phase 1：治理骨架
+
+- 核心 Agent 角色资产。
+- `aios-*` Skills。
+- Workflow、Runtime routing、项目模板。
+- CLI 安装和 doctor。
+
+## Phase 2：产品化闭环
+
+- 统一 AIOS 命名和发布入口。
+- 行为级测试。
+- 治理、交付、记忆、知识工程政策。
+- Hermes dry-run 同步与漂移检测。
+
+## Phase 3：行业知识工程
+
+- BIM / IFC / 规范知识源登记。
+- RAG / GraphRAG 评估集。
+- 审图规则图谱。
+- 第二阶段 Agent 深化。
+
+## Phase 4：企业级运行
+
+- 可选企业 Runtime Adapter：Hermes / 飞书等真实集成。
+- 权限审计。
+- 多项目接入仪表盘。
+- 发布和回滚自动化。

package/vision/strategy-principles.md

@@ -0,0 +1,16 @@
+# Strategy Principles
+
+## 原则
+
+- AIOS 是研发组织操作系统，不是聊天机器人集合。
+- 先把边界、流程和验证做实，再扩展 Agent 数量。
+- 本地项目工作区是工程事实主战场。
+- 远程入口只负责协作、调度和回传证据。
+- 行业知识必须可追溯、可评估、可标注不确定性。
+
+## 取舍
+
+- 短期优先可复用治理资产，不优先真实外部集成。
+- 不保留未推广历史命名兼容层。
+- 不为第二阶段 Agent 提前创建未验证 Skill。
+

package/workflows/README.md

@@ -0,0 +1,19 @@
+# Workflows
+
+`workflows/` 保存多 Agent 协作流程，是本仓库的核心资产之一。
+
+推荐优先沉淀：
+
+- [架构评审](architecture-review.md)
+- [feature 开发](feature-development.md)
+- [bug 修复](bug-fixing.md)
+- [code review](code-review.md)
+- [综合 review 入口](review.md)
+- [design review](design-review.md)
+- [质量准入 / UAT / 试运行确认](quality-readiness.md)
+- [release](release.md)
+- [frontend 生成](frontend-generation.md)
+- [RAG / GraphRAG pipeline](rag-pipeline.md)
+- spec driven development
+
+每个 workflow 应明确参与角色、输入、输出、执行顺序、验收标准和回滚策略。

package/workflows/architecture-review.md

@@ -0,0 +1,98 @@
+# 架构评审 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 拆解。
+- 不确定项和待验证项被显式记录。

package/workflows/bug-fixing.md

@@ -0,0 +1,62 @@
+# 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 无阻断问题。
+

package/workflows/code-review.md

@@ -0,0 +1,54 @@
+# 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 复审。
+
+## 输出
+
+- 阻断问题。
+- 非阻断建议。
+- 测试缺口。
+- 剩余风险。
+- 合并或发布建议。
+
+## 验收标准
+
+- 阻断问题已修复或明确不发布。
+- 测试缺口被补齐或记录。
+- 没有无关风格挑刺。
+- 没有未经验证的完成声明。
+

package/workflows/design-review.md

@@ -0,0 +1,68 @@
+# Design Review Workflow
+
+适用场景：建筑行业平台界面方案评审、页面任务评审、工作台体验评审、前端实现前的设计交接
+
+## 目标
+
+在实现前发现界面方案中的真实缺口，把页面任务、信息架构、证据定位、复核动作、交互状态、中文文案、响应式、可访问性和验收方式补清楚，避免工程师根据模糊描述生成不可用、不可复核或不可验收的 UI。
+
+## 参与角色
+
+| 阶段 | Agent | Skill |
+| --- | --- | --- |
+| 产品和体验判断 | Janus | `aios-design` |
+| 架构 / 数据边界补充 | Atlas | `aios-arch` |
+| 实现交接 | Hephaestus | `aios-exec` |
+| 代码和风险审查 | Argus | `aios-review` |
+
+## 输入
+
+- 页面目标、用户角色和关键任务。
+- 页面、组件、流程、状态和数据对象。
+- 现有设计系统、组件库、截图或参考界面。
+- 目标设备、浏览器、可访问性和验收要求。
+- 建筑行业语义：项目、图纸、模型、构件、规范条文、审查项、证据、报告和人工复核。
+- 图纸定位：页码、轴网、楼层、专业、视图、批注和图纸版本。
+- 模型定位：IFC GUID、构件树、空间层级、构件属性、模型版本和版本对比。
+- 审查结论：规则来源、命中依据、证据片段、人工复核状态、确认人和撤回路径。
+- 长任务：上传、解析、索引、审查、报告生成、失败恢复和重试。
+
+## 执行顺序
+
+1. Janus 判断是否存在 UI / UX 范围；没有则退出并推荐其他 workflow。
+2. Janus 盘点已有组件、样式、术语、表格、Viewer、证据定位、状态组件和可复用模式。
+3. Janus 按 0-10 评分法评审信息架构、工作流效率、状态覆盖、领域证据呈现、中文术语、响应式 / 可访问性、界面决策清晰度、设计系统一致性和实现交接清晰度。
+4. 对低于 8 分的维度，说明达到 10 分需要补什么，并给出可执行修正。
+5. 如果设计缺口涉及数据链路、权限、长任务、证据链或服务边界，交给 Atlas 补做架构评审。
+6. 设计计划达到可实现状态后，交给 Hephaestus 执行前端实现或修改。
+7. 实现完成后，Argus 做代码 / 风险审查，并根据需要执行浏览器或截图验证。
+
+## 输出
+
+- 适用性结论。
+- 总体设计完整度和维度评分表。
+- P0 / P1 / P2 设计缺口。
+- Unresolved Decisions。
+- 修正后的界面方案。
+- 实现交接和验证建议。
+
+## 验收标准
+
+- 页面有明确任务，而不是泛化展示页。
+- 关键状态都有用户可见表现和操作路径。
+- 建筑行业对象、证据链和复核点在 UI 中可定位、可追溯、可撤回。
+- 图纸页码、轴网、楼层、专业、IFC GUID、构件树、空间层级、规则来源和命中依据有清楚呈现策略。
+- 上传、解析、索引、审查和报告生成等长任务有进度、失败恢复和重试路径。
+- 专家复核能说明谁确认、确认什么、何时确认以及如何追溯。
+- 中文文案、术语、错误和状态一致。
+- 桌面、窄屏、移动端和可访问性策略明确。
+- 工程实现者能根据计划写代码、运行验证并判断是否完成。
+
+## 约束
+
+- 不把设计评审替代为代码审查。
+- 不把文本设计评审当成最终视觉 QA。
+- 不替代通用 `frontend-design` 的视觉风格和前端代码美化评审。
+- 不替代 `frontend-generation` 的 UI 实现、布局验证和交互验证。
+- 不引入新设计系统，除非已有系统无法支撑关键任务。
+- 不生成营销页式 UI 来替代工作台、后台、Viewer 或审图工具。

package/workflows/feature-development.md

@@ -0,0 +1,72 @@
+# 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、配置回退、数据库迁移回滚或人工恢复步骤。