@archsight/aios 1.0.0

package/AGENTS.md

@@ -0,0 +1,24 @@
+# AGENTS.md
+
+> 本文件供 **Codex（OpenAI Codex / codex.ai）** 在本仓库中工作时参考。  
+> 本文件是 Codex 的工具入口适配器，不复制公共规范正文。
+
+---
+
+## 必读入口
+
+开始任何工作前，先阅读：
+
+- [AI 编码规范（公共）](./AI_CODING_RULES.md)
+- [项目总览](./README.md)
+- [Agent Routing](./runtime/agent-routing.md)
+- [Workflows](./workflows/README.md)
+
+---
+
+## Codex 特别说明
+
+- Codex 在执行终端命令时，须优先使用项目根目录的 `Makefile` 或 `scripts/` 中的辅助脚本（如存在）。
+- Codex 在用户指定或任务适合本仓库技能包时，须先阅读 [Skills](./skills/README.md) 和对应 `skills/*/SKILL.md`。
+- 生成代码时，严格遵守 `AI_CODING_RULES.md` 第二节「AI 行为准则」，尤其是最小代码和不做假设原则。
+- Codex 不得在未经验证的状态下关闭 PR 或标记任务为完成。

package/AI_CODING_RULES.md

@@ -0,0 +1,117 @@
+# AI 编码规范（公共）
+
+> 真正工程师的编程素养准则（Skills for Real Engineers）
+>
+> 本文件是本仓库所有 AI 编码助手的统一规范主体。  
+> `AGENTS.md`、`CLAUDE.md`、`GEMINI.md`、`OPENCODE.md` 等入口文件只引用本文件，不复制规范正文。
+
+状态：治理基线  
+版本：0.2  
+日期：2026-05-19  
+适用范围：AI 编程助手、Agent、脚本生成器和自动化执行流程
+
+---
+
+## 一、目的
+
+本规范用于约束 AI 在编码、改代码、写脚本、写文档和生成 UI 时的行为，避免瞎写代码、过度设计、擅自加功能、乱改无关文件和未经验证就声称完成。
+
+核心原则：
+
+> 先理解目标，再用最少、最稳、最贴合现有项目的方式完成任务。
+
+---
+
+## 二、AI 行为准则（最高优先级）
+
+以下准则优先于任何技术实现细节。
+
+| # | 准则 | 说明 |
+| --- | --- | --- |
+| 1 | 不要假设，不要掩饰困惑，要揭示取舍 | 遇到需求不确定、信息缺失或存在多种方案时，直接说明不确定点、选项和理由，不用猜测填补空白。 |
+| 2 | 用能解决问题的最小代码，拒绝带有猜想的实现 | 只写当前需求明确要求的代码，不顺手加功能，不以防万一加抽象层，不预埋未来逻辑。 |
+| 3 | 只触碰必须改动的部分，只清理自己制造的脏 | 不重构无关代码，不格式化他人文件，不因为看起来更好就修改未受影响的部分。 |
+| 4 | 定义成功标准，循环迭代直到验证通过 | 开始实现前明确什么状态算完成；每次变更后验证是否达到标准，未通过则继续迭代。 |
+| 5 | 文档输出必须使用中文 | 除代码标识符、API 路由、命令、英文专有名词外，README、PRD、设计文档、治理文档和注释默认使用中文。 |
+| 6 | UI 界面必须为中文 | 面向国内用户的 UI 标签、提示、状态、AI 建议和错误信息必须统一中文；单位符号、代码、协议名等必要技术文本除外。 |
+
+---
+
+## 三、执行流程
+
+### 1. 理解目标
+
+- 明确用户真正要解决的问题、边界和完成标准。
+- 信息不足时说明缺口；关键歧义会改变方案时先提问。
+- 能从现有代码、文档、测试或命令中确认的事实，优先查证，不凭记忆硬猜。
+
+### 2. 最小修改
+
+- 只改完成任务必须改的文件和代码。
+- 优先复用项目已有工具、脚本、函数、模式和风格。
+- 不引入新依赖、不新增配置、不扩大功能范围，除非用户明确要求。
+- 发现无关问题可以记录，但不顺手重构或格式化。
+
+### 3. 验证完成
+
+- 修改后运行与风险匹配的测试、构建、lint、类型检查或人工验证。
+- 验证失败时继续修复，不把失败结果包装成完成。
+- 最终说明改了什么、如何验证、还有哪些未验证风险。
+
+### 4. 达成即停
+
+- 满足明确需求后停止，不继续添加“顺便”的功能、抽象或文档。
+- 如果后续值得做，作为建议或待办提出，不混进当前改动。
+
+---
+
+## 四、语言与 UI
+
+- 仓库文档、最终报告、变更说明、验收记录默认使用中文。
+- 面向用户的 UI 文案、提示、状态、AI 建议和错误信息默认使用中文。
+- 代码标识符、API、命令、环境变量、协议名、行业术语和单位符号可以保留英文。
+- 不为了显得专业而把普通中文说明改成英文。
+- 不在同一功能中混用多套中英文表达。
+
+---
+
+## 五、检查清单
+
+开始前：
+
+- [ ] 是否理解了目标、边界和完成标准？
+- [ ] 是否存在会影响实现方向的歧义？
+- [ ] 是否已经查过项目现有工具、脚本和模式？
+
+修改中：
+
+- [ ] 是否只改必要文件？
+- [ ] 是否避免了额外功能、额外依赖和无意义抽象？
+- [ ] 是否保持了现有代码风格和项目约定？
+
+完成前：
+
+- [ ] 是否满足所有明确需求？
+- [ ] 是否完成了合适的验证？
+- [ ] 是否检查了 diff 范围，没有混入无关改动？
+- [ ] 是否如实说明未验证项和剩余风险？
+
+---
+
+## 六、红线
+
+以下行为默认不允许：
+
+- 未经要求添加新功能、引入新依赖或大规模重构。
+- 未经要求修改无关文件、重排格式或替换项目既有风格。
+- 未经确认执行破坏性操作。
+- 未经验证声称任务完成。
+- 把猜测、模型推断或未核验资料写成事实。
+- 用复杂设计替代清晰需求。
+- 在文档和 UI 中无理由使用英文替代中文。
+
+---
+
+## 七、一句话原则
+
+> 像真正工程师一样工作：先想清楚，少写代码，精准修改，验证完成，然后停手。

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# 变更记录
+
+## 1.0.0
+
+首个面向开源准备的版本。
+
+### 新增
+
+- `archsight-aios` CLI，包含 `install`、`doctor`、`init`、`validate` 和 Hermes 校验命令。
+- 项目接入模板，覆盖 `AGENTS.md`、`CLAUDE.md`、`GEMINI.md`、`AI_CODING_RULES.md` 和 `.ai/`。
+- 三类项目 profile：BIM / CAD / Revit 平台、施工视觉 AI、RAG / GraphRAG 规范知识库。
+- 面向业务专家的参与指南、快速上手、术语表、贡献说明、安全策略、行为准则和 MIT 许可证。
+
+### 调整
+
+- README 改为外部读者优先，先说明用途、适用人群、三步开始、项目生成内容和常用命令。
+- `package.json` 补充 repository、keywords、homepage、issue tracker 和 MIT license。

package/CLAUDE.md

@@ -0,0 +1,23 @@
+# CLAUDE.md
+
+> 本文件供 **Claude Code** 在本仓库中工作时参考。
+> 本文件是 Claude Code 的工具入口适配器，不复制公共规范正文。
+
+---
+
+## 必读入口
+
+开始任何工作前，先阅读：
+
+- [AI 编码规范（公共）](./AI_CODING_RULES.md)
+- [项目总览](./README.md)
+- [Agent Routing](./runtime/agent-routing.md)
+- [Workflows](./workflows/README.md)
+
+---
+
+## Claude Code 特别说明
+
+- Claude Code 在进行多文件编辑时，应先声明将要修改的文件列表；若任务明确且低风险，可按公共规范直接执行。
+- 生成代码时，严格遵守 `AI_CODING_RULES.md` 第二节「AI 行为准则」，尤其是只触碰必须改动的部分和揭示取舍原则。
+- Claude Code 不得在对话中假设需求已明确；如有关键歧义，必须先提问再动手。

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,23 @@
+# Code of Conduct
+
+## 基本原则
+
+参与 ArchSight AIOS 的讨论、issue、pull request 和文档协作时，请保持专业、尊重和基于证据的沟通。
+
+## 鼓励的行为
+
+- 用清晰、具体的事实描述问题。
+- 尊重不同专业背景，包括业务专家、产品、工程、研究和运维人员。
+- 对规范、工程结论和 AI 输出标注来源和不确定性。
+- 指出风险时同时给出可执行的改进建议。
+
+## 不接受的行为
+
+- 人身攻击、歧视、骚扰或威胁。
+- 泄露客户、项目、人员或组织的敏感信息。
+- 将未经核验的 AI 输出包装成确定工程结论。
+- 在公开讨论中发布可利用的安全漏洞细节。
+
+## 处理方式
+
+维护者可以删除不当内容、关闭讨论、限制参与或要求修改提交内容。严重问题将按项目安全和治理要求处理。

package/CONTRIBUTING.md

@@ -0,0 +1,60 @@
+# Contributing
+
+欢迎提交 ArchSight AIOS 的规则、文档、profile、skill、workflow 和测试改进。
+
+## 贡献类型
+
+| 类型 | 示例 |
+| --- | --- |
+| 文档 | 快速上手、业务专家指南、术语解释、案例说明。 |
+| Profile | BIM 平台、施工视觉、规范知识库之外的新项目类型。 |
+| Skill | 可重复执行、可验证的 AI 工作能力。 |
+| Workflow | 架构评审、审图规则沉淀、数据评估、发布检查等流程。 |
+| 测试 | CLI 行为、模板输出、manifest 一致性和回归用例。 |
+
+## 提交前检查
+
+```bash
+npm test
+npm run doctor
+npm run smoke:project
+```
+
+## 编写原则
+
+- 面向外部读者时，先说明用途，再说明实现细节。
+- 面向业务专家时，使用行业语言，避免只写工程术语。
+- 所有规范、条文、样例和业务判断都应保留来源、版本和适用范围。
+- 不提交涉密项目资料、未授权图纸、个人信息或客户内部数据。
+- 不把模型推断写成确定工程结论。
+
+## 新增 profile 的要求
+
+新增 profile 应放在 `templates/project-<name>/.ai/profiles/<name>.md`，并说明：
+
+- 适用项目
+- 必读上下文
+- 默认关注点
+- 推荐 Agent / Skill 路由
+- 验收要求
+
+同时更新：
+
+- `runtime/archsight-aios.manifest.json`
+- `templates/README.md`
+- `README.md`
+- `tests/cli.test.mjs`
+
+## 新增 skill 的要求
+
+新增 skill 应包含：
+
+- `SKILL.md`
+- `agents/openai.yaml`
+- 清晰的输入、工作流、输出格式和约束
+
+同时更新 manifest、routing 和必要测试。
+
+## Commit 建议
+
+提交信息应说明为什么改，而不仅是改了什么。涉及取舍时记录约束、拒绝的方案、验证方式和未验证风险。

package/GEMINI.md

@@ -0,0 +1,24 @@
+# GEMINI.md
+
+> 本文件供 **Gemini（Google Gemini / Antigravity）** 在本仓库中工作时参考。  
+> 本文件是 Gemini 的工具入口适配器，不复制公共规范正文。
+
+---
+
+## 必读入口
+
+开始任何工作前，先阅读：
+
+- [AI 编码规范（公共）](./AI_CODING_RULES.md)
+- [项目总览](./README.md)
+- [Agent Routing](./runtime/agent-routing.md)
+- [Workflows](./workflows/README.md)
+
+---
+
+## Gemini 特别说明
+
+- Gemini 在使用浏览器或外部工具时，须在操作前声明目的，操作后汇报结果。
+- Gemini 在用户指定或任务适合本仓库技能包时，须先阅读 [Skills](./skills/README.md) 和对应 `skills/*/SKILL.md`，按其中的输入、工作流、输出格式和约束执行。
+- 生成代码时，严格遵守 `AI_CODING_RULES.md` 第二节「AI 行为准则」，尤其是定义成功标准并验证和不做假设原则。
+- Gemini 不得在知识库过时或不确定时，将其作为唯一依据直接输出代码，须与当前代码库交叉验证。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ArchSightLabs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,154 @@
+# ArchSight AIOS
+
+ArchSight AIOS 是一套面向建筑 AI 研发的规则、Agent、Skill、Workflow 和项目接入工具包。它重点服务 BIM / IFC / Revit / CAD、施工视觉 AI、建筑规范知识库、GraphRAG、智能审图和 AI Coding 治理，让 Codex、Claude Code、Antigravity 2.0 等 AI Coding 工具在同一个项目里读取同一套规则、项目上下文和验收要求。
+
+AIOS 不是全行业项目模板集合。它保留通用的 AI 编码规则、Agent 路由、Workflow、项目 `.ai/` 上下文和交付验证能力，但真正的差异化能力集中在建筑行业语义、工程证据链、规范知识工程和可复核的 AI 研发流程。
+
+## 设计目标
+
+AIOS 的目标不是替代 Codex、Claude Code 或 Gemini 自带的通用工程能力，而是让它们在建筑行业平台研发中做出更专业的判断。它面向建筑行业架构师、博士 / 研究型团队和后端开发，把通用架构评审补足为面向 BIM / IFC、建筑规范、审图链路、知识库、RAG / GraphRAG、任务编排、审计证据和长期平台演进的工作方法。
+
+没有 `.ai/` 目录时，AIOS Skill 仍应可直接使用：优先读取代码、接口、schema、配置、测试和部署入口；只有项目明确启用 profile 或任务本身涉及建筑行业语义时，才加载 BIM、IFC、规范知识或智能审图假设。
+
+## 适合谁
+
+| 角色 | 可以用它做什么 |
+| --- | --- |
+| 建筑行业架构师 | 评估平台边界、BIM / IFC 数据链路、规范知识工程、审图流程和长期演进风险。 |
+| 博士 / 研究型团队 | 把算法、RAG / GraphRAG、评估集、实验假设和工程验收连接到可复核的研发流程。 |
+| 后端开发 | 拆清服务边界、任务队列、文件处理、审计日志、索引版本、缓存和多实例运行风险。 |
+| 业务专家 | 沉淀规范条文、审查口径、工程术语、样例和人工复核点。 |
+| 产品 / 项目 / 设计负责人 | 把业务目标、页面任务、工作台体验、验收标准和 AI 协作流程写进项目规则。 |
+| 企业负责人 / 业务一把手 | 用 `aios-ceo` 判断立项价值、产品定位、商业目标、投入产出、阶段路线和停损信号。 |
+| AI / 软件工程师 | 给建筑 AI 项目接入统一 AI 编码规则、Skills、Workflows 和行业 profile。 |
+| 团队负责人 | 统一多工具、多模型、多 Agent 的工作边界和交付检查方式。 |
+
+## 解决什么问题
+
+- 不同 AI 工具各读各的规则，导致输出风格和边界不一致。
+- 项目里缺少明确的 `.ai/` 上下文目录，AI 不知道行业知识、验收标准和人工复核点。
+- 建筑行业项目涉及规范、BIM、图纸、模型、施工现场、知识库和 AI 检测，容易把模型推断误当成工程结论；AIOS 通过 profile 叠加这些行业规则，而不是把它们写成所有项目的默认事实。
+- AI 生成代码、文档或规则后，缺少统一的 review、验证和发布检查路径。
+
+## 三步开始
+
+```bash
+npx @archsight/aios install --target all --scope user
+npx @archsight/aios doctor
+
+cd /path/to/your-project
+npx @archsight/aios init
+```
+
+执行后，当前业务项目会获得统一的 AI 入口文件和 `.ai/` 项目治理目录。已有 `AGENTS.md`、`CLAUDE.md`、`GEMINI.md` 或 `AI_CODING_RULES.md` 的项目不会被覆盖；CLI 会补充缺失文件，并在合适的位置追加 ArchSight AIOS 引用。
+
+如果你不写代码，只参与业务判断，可以先看 [业务专家指南](docs/business-expert-guide.md)。如果你需要一步一步安装和验证，可以看 [快速上手](docs/quickstart.md)。
+
+## 行业能力 Profile
+
+可以按建筑 AI 能力方向叠加行业规则：
+
+```bash
+npx @archsight/aios init --profile bim-platform
+npx @archsight/aios init --profile construction-vision
+npx @archsight/aios init --profile rag-knowledge
+```
+
+| Profile | 适用项目 |
+| --- | --- |
+| `bim-platform` | 工程模型轴：BIM / IFC / Revit / CAD / 建模平台 / 模型质检。 |
+| `construction-vision` | 现场感知轴：YOLO、图像分割、Segment Anything、深度估计、焊缝 / 裂缝检测、施工巡检。 |
+| `rag-knowledge` | 知识规则轴：建筑规范知识库、RAG、GraphRAG、知识图谱、审图规则。 |
+
+## 项目会生成什么
+
+| 文件 / 目录 | 作用 |
+| --- | --- |
+| `AGENTS.md` | Codex 等 Agent 工具读取的项目入口。 |
+| `CLAUDE.md` | Claude Code 读取的项目入口。 |
+| `GEMINI.md` | Gemini 读取的项目入口。 |
+| `AI_CODING_RULES.md` | 项目通用 AI 编码规则。 |
+| `.ai/ARCHSIGHT_AIOS_RULES.md` | ArchSight AIOS 补充规则。 |
+| `.ai/project-context.md` | 项目事实、业务背景和边界。 |
+| `.ai/agent-routing.md` | 不同任务该交给哪个 Agent / Skill。 |
+| `.ai/skills.md` | 当前项目可用的 ArchSight Skills。 |
+| `.ai/workflows.md` | 当前项目可用的 Workflow 和验收路径。 |
+
+## 常用命令
+
+| 命令 | 用途 |
+| --- | --- |
+| `help` | 查看 CLI 帮助、可用命令和示例。 |
+| `install` | 安装 ArchSight AIOS 用户级资产到 Codex、Antigravity 2.0、Gemini 和共享目录。 |
+| `doctor` | 检查仓库资产、manifest、用户级安装、Skill 和 Workflow 是否一致。 |
+| `init` | 给具体业务项目接入 AI 规则、`.ai/` 治理目录和可选行业 profile。 |
+| `validate` | 验证项目接入模板能否生成并引用当前登记的 Skills / Workflows。 |
+
+## 安装位置
+
+`install --target all --scope user` 会写入当前用户目录：
+
+- Codex：`~/.codex/skills/`、`~/.codex/workflows/aios/`
+- Gemini：`~/.gemini/GEMINI.md`、`~/.gemini/archsight-aios/`
+- Antigravity 2.0：`~/.gemini/config/plugins/archsight-aios/`
+- Antigravity 1.x legacy：仅当已存在 `~/.gemini/antigravity/` 时，写入 `~/.gemini/antigravity/skills/`；如果同时检测到 Antigravity 2.0 配置，也会额外写入 2.0 plugin 目录。
+
+`~/.agents/skills/` 和 `~/.agents/workflows/aios/` 是可选的通用 Agent 共享目录，不是所有 AI Agent 都会自动读取。需要这类兼容目录时，单独执行：
+
+```bash
+npx @archsight/aios install --target agents --scope user
+```
+
+## init 默认行为
+
+`init` 默认使用 `--mode auto`：
+
+- 新项目或没有 AI 工具入口文件时，创建 `AGENTS.md`、`AI_CODING_RULES.md`、`CLAUDE.md`、`GEMINI.md` 和 `.ai/` 模板文件。
+- 已存在 `AGENTS.md`、`AI_CODING_RULES.md`、`CLAUDE.md` 或 `GEMINI.md` 时，创建缺失的 `.ai/` 文件，并在 `AGENTS.md`、`CLAUDE.md`、`GEMINI.md` 中追加或刷新 ArchSight AIOS 托管引用块。
+- 重复执行不会重复追加托管块，也不会覆盖已有项目规则。
+- 自动模式不修改已有 `AI_CODING_RULES.md` 正文。
+
+## 行业边界
+
+建筑行业能力通过 `--profile` 或明确任务触发。未启用相关 profile 的项目，不应默认加载 BIM、IFC、GraphRAG、审图或建筑规范假设。
+
+前端应用、后端服务、CLI 工具、数据管道等工程形态优先由 Workflow / Skill / Agent 路由处理，不默认扩展为 profile。只有当某类项目存在稳定的行业语义、证据链、评估集或人工复核差异时，才应考虑新增 profile。
+
+如需强制指定模式：
+
+```bash
+npx @archsight/aios init --mode full
+npx @archsight/aios init --mode linked
+npx @archsight/aios init --mode ai-only
+```
+
+## 本地开发验证
+
+如果是从源码仓库运行，而不是通过 npm 包运行：
+
+```bash
+npm run install:user
+npm run doctor
+npm run smoke:project
+npm test
+```
+
+## 核心材料
+
+- [快速上手](docs/quickstart.md)
+- [业务专家指南](docs/business-expert-guide.md)
+- [术语表](docs/glossary.md)
+- [AI 编码规范](AI_CODING_RULES.md)
+- [Agents](agents/README.md)
+- [Skills](skills/README.md)
+- [Workflows](workflows/README.md)
+- [Templates](templates/README.md)
+- [Runtime 路由](runtime/agent-routing.md)
+
+## 开源协作
+
+- 许可证：[MIT](LICENSE)
+- 贡献说明：[CONTRIBUTING.md](CONTRIBUTING.md)
+- 安全问题：[SECURITY.md](SECURITY.md)
+- 行为准则：[CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)
+- 变更记录：[CHANGELOG.md](CHANGELOG.md)

package/SECURITY.md

@@ -0,0 +1,32 @@
+# Security Policy
+
+## 支持范围
+
+当前项目处于早期阶段，默认支持 `main` 分支上的最新代码。
+
+## 报告安全问题
+
+请不要在公开 issue 中披露可利用的安全细节。可以通过 GitHub Security Advisories 或私下联系维护者报告问题。
+
+报告时请尽量包含：
+
+- 影响范围
+- 复现步骤
+- 可能的风险
+- 已知缓解方式
+
+## 数据和隐私边界
+
+本仓库不应包含：
+
+- 客户内部项目资料
+- 未授权图纸、模型、现场图片或视频
+- 个人信息
+- 密钥、token、cookie、凭据
+- 涉密或受合同限制的数据
+
+## AI 输出安全边界
+
+- AIOS 不替代工程安全责任人、注册工程师、审图机构或项目负责人。
+- 缺少来源、版本或适用范围时，不应给出确定合规结论。
+- 模型检测、规则推断和人工确认必须区分。

package/agents/README.md

@@ -0,0 +1,68 @@
+# Agents
+
+`agents/` 保存 Agent 组织定义。
+
+普通使用者通常不需要记住这些 Agent 名字，也不需要手动指定某个 Agent。日常使用时，先执行 `archsight-aios init`，再按项目任务选择合适的 profile、Skill 或 Workflow 即可。Agent 名字是角色契约标签，用来帮助 AIOS 做任务路由、职责边界和运行时 prompt 管理。
+
+这些角色不代表接入项目属于 ArchSightLabs，也不要求项目使用 Hermes、飞书或任何特定运行平台。建筑行业是当前重点覆盖方向，但只有项目启用相关 profile 或任务明确涉及 BIM / IFC / 规范 / 审图 / RAG 知识工程时，才应引入对应行业假设。
+
+例如：
+
+| 你要做的事 | 关注入口 |
+| --- | --- |
+| 接入项目 AI 规则 | `archsight-aios init` |
+| BIM / IFC / Revit / CAD 项目 | `--profile bim-platform` |
+| 施工视觉 AI 项目 | `--profile construction-vision` |
+| 规范知识库 / GraphRAG 项目 | `--profile rag-knowledge` |
+| 看某类任务怎么做 | `skills/` 和 `workflows/` |
+
+维护者才需要关心 Agent 定义。每个 Agent 不应只保存 prompt，而应保存职责、边界、输入、输出、禁止事项、参与 workflow 和模型路由。
+
+当前采用三层管理：
+
+| 层 | 内容 | 作用 |
+| --- | --- | --- |
+| Source | `role.md` / `responsibilities.md` / `constraints.md` / `workflow.md` | 长期维护角色资产 |
+| Runtime | `system-prompt.md` | 运行时可加载的最小提示词 |
+| Instance / Adapter | Codex、Claude Code、Gemini、Hermes、飞书等 | 实际对话或协作入口 |
+
+当前与规划 Agent：
+
+| 内部名称 | 中文角色 | 定位 | 适用任务 |
+| --- | --- | --- | --- |
+| Atlas | 总架构师 | 核心 | 架构评审、技术路线、服务边界、复杂度治理。 |
+| Mason | 工程总工 | 核心 | 交付计划、任务拆解、依赖排序、CI/CD 和发布路径。 |
+| Argus | 代码审查官 | 核心 | Code Review、安全、性能、技术债、Prompt 注入和风险审查。 |
+| Vitruvius | 建筑数字化专家 | 核心 | BIM / IFC、建筑规范、审图语义、工程数据建模。 |
+| Daedalus | AI 研发工程师 | 核心 | RAG / GraphRAG、MCP、Tool Calling、Memory 和 Agent Runtime。 |
+| Hephaestus | 受控执行官 | 核心 | 代码修改、脚本执行、测试、文档生成和受控交付。 |
+| Euclid | 结构力学专家 | 按需 | 结构力学、荷载、FEM、计算流程和专业核验。 |
+| Athena | 知识治理官 | 按需 | 知识源、版本、授权、Memory / RAG 入库和清理治理。 |
+| Mercury | AI 情报官 | 按需 | AI 生态、模型能力、开源项目和工具链情报分析。 |
+| Janus | 产品策略官 | 按需 | 产品目标、MVP 边界、用户场景、商业化和路线判断。 |
+| Themis | QA 负责人 | 按需（规划） | UAT、试运行确认、测试策略、验收矩阵、回归覆盖、质量门禁和验证证据。 |
+| Aegis | 运行可靠性官 | 按需（规划） | 部署、监控、事故响应、回滚演练、SRE 和运行风险治理。 |
+
+## 治理责任面
+
+这些角色不是单纯增加 Agent 名字，而是把研发工程治理拆成几个稳定责任面：
+
+| 责任面 | 角色 | 关注点 |
+| --- | --- | --- |
+| 方向与边界 | Janus / Atlas | 产品目标、MVP、路线、架构边界、技术路线和复杂度。 |
+| 计划与执行 | Mason / Hephaestus | 交付拆解、任务排序、发布路径、受控改代码、脚本执行、测试和交付。 |
+| 质量与风险 | Argus / Themis | Code Review、安全、性能、技术债、Prompt 注入、UAT、试运行确认、测试策略、验收矩阵和验证证据。 |
+| AI 工程专项 | Daedalus | RAG、GraphRAG、MCP、Tool Calling、Memory 和 Agent Runtime。 |
+| 行业知识专项 | Vitruvius / Euclid / Athena | BIM / IFC、建筑规范、审图语义、工程数据、结构力学、知识源、版本、授权和 RAG / Memory 入库治理。 |
+| 运行可靠性 | Aegis | 部署、监控、事故响应、回滚演练、SRE 和运行风险治理。 |
+| 外部情报 | Mercury | 模型能力、AI 生态、开源项目和工具链趋势。 |
+
+Themis 和 Aegis 当前只作为规划角色记录，不进入默认路由，也不要求项目立即创建运行时实例。Themis 对应 QA 责任面，重点覆盖 UAT、试运行确认、验收矩阵、回归覆盖和质量门禁；Aegis 对应运行可靠性责任面。等真实项目对 QA、生产运行和事故治理提出稳定需求后，再补齐角色 Source、Runtime Prompt、Skill 和 Workflow。
+
+每个核心 Agent 目录至少包含：
+
+- `role.md`
+- `responsibilities.md`
+- `constraints.md`
+- `workflow.md`
+- `system-prompt.md`

package/agents/argus/constraints.md

@@ -0,0 +1,37 @@
+# Argus 约束与边界
+
+## 不做什么
+
+- 不做无关风格挑刺。
+- 不把个人偏好包装成质量问题。
+- 不替代 Hephaestus 大规模改代码。
+- 不替代 Atlas 做架构路线决策。
+- 不替代 Mason 做交付计划。
+- 不在没有证据时断言存在漏洞。
+
+## 决策边界
+
+Argus 可以阻断高风险交付建议，但不能独立批准以下事项：
+
+- 跳过安全审查。
+- 跳过测试。
+- 放宽生产权限。
+- 自动发布到生产。
+- 接受未验证的核心逻辑修改。
+
+## 输出约束
+
+- Review 结论必须先列问题，再给摘要。
+- 发现应按严重程度排序。
+- 每个发现应说明影响、证据和建议。
+- 没有发现问题时，应明确说明剩余测试缺口。
+- 输出默认使用中文。
+
+## 协作约束
+
+- 架构边界问题升级给 Atlas。
+- 任务拆解和交付顺序问题交给 Mason。
+- AI Runtime、MCP、Tool Calling、Memory 风险交给 Daedalus 协作判断。
+- 行业规则和 BIM / IFC 语义问题交给 Vitruvius。
+- 代码修复交给 Hephaestus。
+

package/agents/argus/responsibilities.md

@@ -0,0 +1,29 @@
+# Argus 职责清单
+
+## 核心职责
+
+- 执行 Code Review。
+- 识别安全、权限、性能和可靠性风险。
+- 审查架构反模式和技术债。
+- 审查 Prompt 注入、Tool 滥用和 Agent 失控风险。
+- 审查依赖、脚本、CI/CD 和自动化流程风险。
+- 检查测试覆盖、验证证据和未测试项。
+- 给出明确的阻断项、建议项和剩余风险。
+
+## 具体工作
+
+- 按严重程度排序 Review 发现。
+- 将风格偏好与真实风险区分开。
+- 检查是否存在越权访问、未过滤输入、注入、敏感信息泄露。
+- 检查是否违反 Atlas 的架构边界。
+- 检查是否违反 Mason 的交付流程。
+- 检查执行型 Agent 是否修改了无关代码。
+
+## 成功标准
+
+- 发现聚焦真实风险，而不是无关风格挑刺。
+- 每个问题都有清晰位置、影响和修复建议。
+- 能区分必须修复、建议修复和可接受风险。
+- 不在缺少证据时夸大问题。
+- 不放过安全、权限和生产发布风险。
+