@archsight/aios 1.0.0

package/governance/agent-boundary.md

@@ -0,0 +1,27 @@
+# Agent Boundary Policy
+
+## 基本关系
+
+| 层 | 说明 |
+| --- | --- |
+| Agent | 谁来做，定义职责和边界 |
+| Skill | 怎么做，定义可复用作业方法 |
+| Workflow | 什么时候做，定义顺序和验收 |
+| Runtime | 在哪里运行，定义权限和调度 |
+
+## 边界规则
+
+- Agent 不承载复杂工具流程；复杂流程沉淀为 Skill 或 Workflow。
+- Skill 不伪装成角色身份；Skill 只定义输入、步骤、输出和约束。
+- Runtime 不保存长期角色资产；Runtime 只引用仓库内受版本控制的 Prompt。
+- 具体业务项目事实优先于 AIOS 通用模板。
+
+## 升级规则
+
+- 架构边界升级给 Atlas。
+- 交付顺序升级给 Mason。
+- 安全质量升级给 Argus。
+- 建筑语义升级给 Vitruvius。
+- AI Runtime 升级给 Daedalus。
+- 受控执行交给 Hephaestus。
+

package/governance/ai-review-policy.md

@@ -0,0 +1,27 @@
+# AI Review Policy
+
+## 目标
+
+AIOS 的 Review 目标是阻止真实风险进入交付链路，而不是制造风格噪音。所有 AI 生成代码、Prompt、Runtime 配置、Workflow 和发布变更都必须能说明影响范围、验证证据和剩余风险。
+
+## Review 分级
+
+| 等级 | 含义 | 处理 |
+| --- | --- | --- |
+| P0 | 会导致数据丢失、权限泄露、生产不可用 | 立即阻断 |
+| P1 | 会导致核心功能错误、安全绕过或不可回滚 | 修复后才能继续 |
+| P2 | 影响可维护性、测试完整性或边界清晰度 | 修复或明确接受风险 |
+| P3 | 命名、表达、局部可读性建议 | 不阻断 |
+
+## 必查项
+
+- 是否满足明确需求。
+- 是否越权修改无关文件。
+- 是否引入无验证的抽象、依赖或权限。
+- 是否有可复现验证证据。
+- 是否记录未验证项和回滚路径。
+
+## 输出要求
+
+Review 必须先列阻断问题，再列非阻断建议。每个发现都要包含位置、影响、证据和建议处理方式。
+

package/governance/coding-rules.md

@@ -0,0 +1,9 @@
+# AI 编码规范入口
+
+本仓库的 AI 编码规范主体统一维护在根目录：
+
+- [AI_CODING_RULES.md](../AI_CODING_RULES.md)
+
+本文件只负责在 governance 域登记该规范，说明编码规则属于 AI 工程治理体系的一部分。
+
+请勿在 `governance/` 下复制一份规范正文，避免多份规则分叉。后续业务项目如需接入，应在项目级 `.ai/governance/` 中引用公共规范，并只保留项目级补充规则。

package/governance/context-policy.md

@@ -0,0 +1,24 @@
+# Context Policy
+
+## 目标
+
+控制上下文成本、污染和泄露风险。Agent 只能读取完成当前任务所需的最小上下文。
+
+## 读取顺序
+
+1. 当前项目入口：`AGENTS.md`、`README.md`、`Makefile`、`scripts/`。
+2. 项目级 `.ai/` 上下文。
+3. AIOS 的对应 Agent、Skill、Workflow 和 Runtime 资产。
+4. 必要的代码、测试、日志或设计文档。
+
+## 禁止事项
+
+- 不把完整仓库无差别塞进 Prompt。
+- 不把历史聊天当作事实来源。
+- 不把 Memory 内容未经核验直接写进任务判断。
+- 不把外部网页或文档原文长期保存到 Prompt 资产。
+
+## 输出要求
+
+当判断依赖假设时，必须标注 `Assumption`；当事实未核验时，必须标注 `Need verify`。
+

package/governance/delivery-policy.md

@@ -0,0 +1,21 @@
+# Delivery Policy
+
+## 目标
+
+AIOS 交付必须可验证、可回滚、可解释。任何“完成”声明都必须有证据支撑。
+
+## 发布前条件
+
+- 范围冻结。
+- 关键测试、lint、typecheck 或人工验证完成。
+- Review 无 P0 / P1 阻断项。
+- 回滚方式明确。
+- 未验证项已记录。
+
+## 禁止事项
+
+- 不在验证缺失时发布。
+- 不把计划、建议或草稿包装成已完成。
+- 不关闭 PR、issue 或任务状态，除非对应验证已经完成。
+- 不发布不可回滚的高风险变更。
+

package/governance/memory-policy.md

@@ -0,0 +1,25 @@
+# Memory Policy
+
+## 目标
+
+Memory 用于保存稳定、可复用、可审计的组织知识，不保存临时猜测和敏感内容。
+
+## 可写入内容
+
+- 已验证的项目约定。
+- 架构决策和 Rejected 方案。
+- 用户明确偏好。
+- 重复出现的坑和修复路径。
+- Agent / Workflow 的稳定运行经验。
+
+## 不写入内容
+
+- 密钥、凭据、私有数据样本。
+- 未核验行业结论。
+- 一次性任务细节。
+- 会快速过期的临时日志。
+
+## 清理规则
+
+Memory 必须能追溯来源文件或决策记录。相关文件删除、架构改变或验证失效时，应标记过期或删除。
+

package/governance/security-policy.md

@@ -0,0 +1,25 @@
+# Security Policy
+
+## 目标
+
+AIOS 默认按最小权限运行。任何 Agent、Skill、Runtime 或模板不得默认扩大文件、网络、密钥、生产环境或用户数据访问权。
+
+## 禁止事项
+
+- 不在 Prompt、模板、日志或同步记录中写入密钥。
+- 不让远程聊天入口直接执行项目代码、测试或部署。
+- 不把未清洗的外部文档直接注入系统 Prompt。
+- 不通过吞错、跳过测试或降低校验来制造通过。
+
+## 人工确认点
+
+- 生产部署。
+- 数据迁移或删除。
+- 新增外部服务权限。
+- 读取私有数据源或敏感日志。
+- 扩大 MCP / Tool 调用权限。
+
+## 审计要求
+
+安全相关变更必须记录：目的、权限范围、验证命令、回滚方式和剩余风险。
+

package/graph/README.md

@@ -0,0 +1,12 @@
+# Graph
+
+`graph/` 保存行业知识图谱设计。
+
+推荐内容：
+
+- 实体模型
+- 关系模型
+- [schema 设计](schema.md)
+- Neo4j 方案
+- 图谱构建流程
+- [图谱质量评估](quality-policy.md)

package/graph/quality-policy.md

@@ -0,0 +1,14 @@
+# Graph Quality Policy
+
+## 质量检查
+
+- 实体是否有唯一 ID。
+- 关系是否有来源。
+- 是否存在孤立关键实体。
+- 冲突关系是否经过人工复核。
+- 版本变化是否触发重建。
+
+## 发布条件
+
+知识图谱用于审图或合规建议前，必须完成抽样核验，并记录误差类型。
+

package/graph/schema.md

@@ -0,0 +1,28 @@
+# Knowledge Graph Schema
+
+## 核心实体
+
+| 实体 | 说明 |
+| --- | --- |
+| Standard | 标准或规范 |
+| Clause | 条文 |
+| Requirement | 审查要求 |
+| BuildingElement | 建筑或 BIM 构件 |
+| IfcEntity | IFC 实体 |
+| PropertySet | 属性集 |
+| Rule | 审查规则 |
+
+## 核心关系
+
+| 关系 | 说明 |
+| --- | --- |
+| CONTAINS | 标准包含条文 |
+| APPLIES_TO | 要求适用于对象 |
+| DERIVED_FROM | 规则来源于条文 |
+| CONFLICTS_WITH | 条文或规则冲突 |
+| REFERENCES | 引用外部标准 |
+
+## 约束
+
+所有实体和关系必须保留来源、版本和置信度。
+

package/infra/README.md

@@ -0,0 +1,21 @@
+# Infra
+
+`infra/` 保存 AI 研发基础设施说明和配置约定。
+
+推荐内容：
+
+- ECS
+- Docker
+- Nginx
+- Proxy
+- Feishu
+- OSS
+- PostgreSQL
+- Neo4j
+- Vector DB
+
+当前入口：
+
+- [环境策略](environment-policy.md)
+- [权限策略](permissions.md)
+- [服务边界](service-boundaries.md)

package/infra/environment-policy.md

@@ -0,0 +1,21 @@
+# Environment Policy
+
+## 目标
+
+AIOS 的本地、用户级和远程运行环境必须边界清晰。
+
+## 环境层级
+
+| 层级 | 说明 |
+| --- | --- |
+| Repo | 当前 AIOS 仓库 |
+| User Store | `~/.archsight-aios/` |
+| Project | 业务项目工作区 |
+| Remote Runtime | Hermes / 飞书 / Gateway |
+
+## 规则
+
+- 安装命令只能写用户级资产目录和目标助手配置。
+- 项目模板只能写目标项目缺失文件。
+- 远程 Runtime 不直接替代本地测试和构建。
+

package/infra/permissions.md

@@ -0,0 +1,21 @@
+# Permissions Policy
+
+## 最小权限
+
+- 默认只读项目上下文。
+- 代码修改必须绑定项目工作区。
+- 部署、删除、迁移必须人工确认。
+- 密钥只通过目标环境注入，不写入仓库。
+
+## 工具权限登记
+
+```text
+工具：
+用途：
+输入：
+输出：
+权限范围：
+人工确认点：
+审计记录：
+```
+

package/infra/service-boundaries.md

@@ -0,0 +1,18 @@
+# Service Boundaries
+
+## 当前边界
+
+| 服务 | 职责 |
+| --- | --- |
+| AIOS Repo | 规范、Agent、Skill、Workflow、Runtime 资产 |
+| User Store | 安装后的共享资产副本 |
+| Business Project | 真实代码、测试、构建和交付 |
+| Hermes | Agent 实例和异步任务调度 |
+| Feishu | 协作入口和通知入口 |
+
+## 禁止混淆
+
+- 不把 AIOS 仓库当作业务项目。
+- 不把飞书消息当作完整工程上下文。
+- 不把 Hermes Prompt 当作唯一资产源。
+

package/knowledge/README.md

@@ -0,0 +1,20 @@
+# Knowledge
+
+`knowledge/` 保存建筑行业知识体系。
+
+推荐方向：
+
+- BIM
+- IFC
+- 规范
+- 招采
+- 工程数据
+- 结构知识
+- 审查规则
+
+该目录未来应支撑 GraphRAG、知识图谱、条文结构化和智能审查。
+
+当前入口：
+
+- [领域分类](domain-taxonomy.md)
+- [知识来源登记](source-register.md)

package/knowledge/domain-taxonomy.md

@@ -0,0 +1,19 @@
+# Domain Taxonomy
+
+## 一级领域
+
+| 领域 | 说明 |
+| --- | --- |
+| BIM | 模型、构件、属性、交付标准 |
+| IFC | 实体、属性集、关系和交换规则 |
+| 建筑规范 | 条文、适用条件、审查逻辑 |
+| 招采 | 清单、合同、材料、供应商 |
+| 工程数据 | 项目、专业、楼层、构件、变更 |
+| 结构知识 | 荷载、构件、连接、验算 |
+
+## 建模原则
+
+- 每个术语必须有来源。
+- 条文必须保留版本和适用范围。
+- 审查规则必须区分事实、推理和待核验项。
+

package/knowledge/source-register.md

@@ -0,0 +1,23 @@
+# Knowledge Source Register
+
+## 来源登记字段
+
+```text
+名称：
+类型：
+版本：
+来源路径 / URL：
+授权状态：
+更新频率：
+负责人：
+可进入 RAG：是 / 否
+风险：
+```
+
+## 入库条件
+
+- 来源可追溯。
+- 授权状态明确。
+- 版本和发布时间明确。
+- 可区分原文、摘要和 AI 推断。
+

package/memory/README.md

@@ -0,0 +1,12 @@
+# Memory
+
+`memory/` 保存长期记忆体系设计。
+
+推荐内容：
+
+- [项目记忆](project-memory-policy.md)
+- Agent 记忆
+- [决策记录](decision-records.md)
+- 用户偏好
+- 组织约定
+- [记忆清理和更新策略](cleanup-policy.md)

package/memory/cleanup-policy.md

@@ -0,0 +1,15 @@
+# Memory Cleanup Policy
+
+## 触发条件
+
+- 来源文件被删除。
+- 架构或命名发生变化。
+- 记忆与当前测试或文档冲突。
+- 记忆包含敏感信息。
+
+## 处理方式
+
+- 可修正的，更新内容和来源。
+- 已过期的，标注失效原因。
+- 涉密的，立即删除并记录处理结果。
+

package/memory/decision-records.md

@@ -0,0 +1,26 @@
+# Decision Records
+
+## 目标
+
+记录会影响未来维护者判断的架构、产品、治理和运行时决策。
+
+## 格式
+
+```text
+Title:
+Date:
+Context:
+Decision:
+Rejected:
+Consequences:
+Verification:
+Owner:
+```
+
+## 写入条件
+
+- 选择了一个长期命名、目录或路由策略。
+- 拒绝了一个未来可能反复被提出的方案。
+- 改变了 Agent、Skill、Workflow 或 Runtime 边界。
+- 发布、权限或数据策略发生变化。
+

package/memory/project-memory-policy.md

@@ -0,0 +1,18 @@
+# Project Memory Policy
+
+## 目标
+
+项目记忆只保存稳定事实，帮助未来 Agent 更快进入上下文。
+
+## 推荐内容
+
+- 项目定位和非目标。
+- 常用命令。
+- 关键目录和模块边界。
+- 已确认用户偏好。
+- 已验证的坑和修复路径。
+
+## 更新规则
+
+项目记忆必须附带来源。没有来源的记忆只能作为线索，不能作为事实。
+

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@archsight/aios",
+  "version": "1.0.0",
+  "description": "面向建筑 AI 研发的规则、Skill、Workflow 与多 Agent 项目接入工具包。",
+  "type": "module",
+  "homepage": "https://github.com/ArchSightLabs/archsight-aios#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ArchSightLabs/archsight-aios.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ArchSightLabs/archsight-aios/issues"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "architecture",
+    "bim",
+    "ifc",
+    "rag",
+    "graphrag",
+    "construction",
+    "codex",
+    "antigravity",
+    "claude-code"
+  ],
+  "bin": {
+    "archsight-aios": "./bin/archsight-aios.mjs"
+  },
+  "scripts": {
+    "doctor": "node ./bin/archsight-aios.mjs doctor",
+    "install:user": "node ./bin/archsight-aios.mjs install --target all --scope user",
+    "smoke:project": "node ./bin/archsight-aios.mjs validate --temp",
+    "test": "node ./tests/cli.test.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin/",
+    "skills/",
+    "workflows/",
+    "templates/",
+    "runtime/",
+    "agents/",
+    "governance/",
+    "delivery/",
+    "memory/",
+    "knowledge/",
+    "rag/",
+    "graph/",
+    "standards/",
+    "infra/",
+    "prompts/",
+    "vision/",
+    "docs/",
+    "LICENSE",
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
+    "SECURITY.md",
+    "CODE_OF_CONDUCT.md",
+    "README.md",
+    "AI_CODING_RULES.md",
+    "AGENTS.md",
+    "CLAUDE.md",
+    "GEMINI.md"
+  ],
+  "license": "MIT"
+}

package/prompts/README.md

@@ -0,0 +1,13 @@
+# Prompts
+
+`prompts/` 保存资产化 prompt。
+
+每个 prompt 应记录适用范围、版本、输入格式、输出格式、评估方式、失效案例和禁止使用场景。
+
+Prompt 会腐化，因此不能只保存文本本身，必须保存评估和维护规则。
+
+当前入口：
+
+- [Prompt Registry](prompt-registry.md)
+- [Prompt Evaluation Policy](evaluation-policy.md)
+- [Prompt Failure Cases](failure-cases.md)

package/prompts/evaluation-policy.md

@@ -0,0 +1,18 @@
+# Prompt Evaluation Policy
+
+## 评估维度
+
+- 是否遵守角色边界。
+- 是否按输出格式回答。
+- 是否拒绝越权任务。
+- 是否标注不确定性。
+- 是否避免编造事实。
+- 是否能在项目上下文中收敛到可执行动作。
+
+## 最小流程
+
+1. 选择代表性任务。
+2. 运行旧版和新版 Prompt。
+3. 比较输出质量、风险和遵循度。
+4. 记录失效案例。
+

package/prompts/failure-cases.md

@@ -0,0 +1,23 @@
+# Prompt Failure Cases
+
+## 记录格式
+
+```text
+Prompt：
+版本：
+输入：
+错误输出：
+失败类型：
+影响：
+修复：
+回归测试：
+```
+
+## 常见失败类型
+
+- 越权执行。
+- 忽略项目事实。
+- 编造行业条文。
+- 输出不可验证计划。
+- 把可选建议当阻断项。
+

package/prompts/prompt-registry.md

@@ -0,0 +1,24 @@
+# Prompt Registry
+
+## 目标
+
+Prompt 必须作为可评估资产维护，而不是散落文本。
+
+## 登记字段
+
+```text
+名称：
+版本：
+适用场景：
+输入：
+输出：
+禁止场景：
+评估集：
+最近验证：
+负责人：
+```
+
+## 维护规则
+
+Prompt 修改必须记录原因、预期行为变化和评估结果。
+

package/rag/README.md

@@ -0,0 +1,12 @@
+# RAG
+
+`rag/` 保存 RAG / GraphRAG 管线设计和实验记录。
+
+推荐内容：
+
+- [chunk 策略](chunking-policy.md)
+- embedding 策略
+- rerank 策略
+- [retrieval evaluation](evaluation-policy.md)
+- GraphRAG pipeline
+- 知识库更新流程

package/rag/chunking-policy.md

@@ -0,0 +1,19 @@
+# RAG Chunking Policy
+
+## 目标
+
+Chunk 策略必须服务可追溯回答，而不是只追求召回率。
+
+## 规则
+
+- 规范条文按条、款、项保留层级。
+- BIM / IFC 文档按实体、属性集、关系和示例拆分。
+- 招采和合同文档按业务对象和约束条件拆分。
+- 每个 chunk 保留来源、版本、页码或章节。
+
+## 禁止事项
+
+- 不混合不同版本标准。
+- 不把 AI 摘要当作原始来源。
+- 不丢失适用条件和例外条件。
+

package/rag/evaluation-policy.md

@@ -0,0 +1,16 @@
+# RAG Evaluation Policy
+
+## 评估维度
+
+| 维度 | 说明 |
+| --- | --- |
+| 引用准确性 | 回答是否引用正确来源 |
+| 条件完整性 | 是否保留适用条件和例外 |
+| 幻觉率 | 是否编造不存在条文 |
+| 可复现性 | 同一问题是否能稳定检索 |
+| 风险标注 | 不确定内容是否标注待核验 |
+
+## 最小评估集
+
+每个知识域至少维护 10 个代表性问题，覆盖普通问答、边界条件、冲突条文和无法回答场景。
+

package/runtime/README.md

@@ -0,0 +1,22 @@
+# Runtime
+
+`runtime/` 保存运行治理配置与说明。AIOS 的核心能力不依赖某个具体运行平台；Hermes、OpenClaw、飞书、Gateway、Codex、Claude Code、Gemini 等都只是可选 Runtime / Adapter。
+
+推荐内容：
+
+- [Agent Routing](agent-routing.md)
+- [Skill Routing](skill-routing.md)
+- [Hermes 运行线](hermes/)（可选企业适配器）
+- 权限边界
+- 工具调用策略
+- 飞书或其他协作入口集成
+- 定时任务
+- 记忆策略
+- 成本控制
+
+## 适配原则
+
+- 通用角色、Skill、Workflow 保持平台无关。
+- 运行时 Adapter 只负责入口、调度、权限和回传证据。
+- 项目工作区中的代码、测试、构建和 `.ai/` 上下文始终是工程事实来源。
+- 不得因为启用了某个 Adapter，就把 Hermes、飞书或建筑行业背景写成所有项目的默认事实。