{
  "markdown": "# ArchSight AIOS\n\nArchSight AIOS 是面向建筑行业的开源 AI 技能包与工程知识治理工具包。它让 WorkBuddy、Codex、Claude Code、OpenCode、Gemini、Antigravity 等 AI 工具可以使用同一组建筑行业 Skills、Workflows、Templates 和 Runtime 规则。\n\nAIOS 不是从研发工具转成业务资料工具，而是在保留建筑 AI / 软件研发治理能力的基础上，扩展到建筑行业知识工作从业者。现在它同时覆盖两套并列能力：\n\n- **建筑工程资料与知识工作技能包**：处理工程资料、技术标、合同履约、施工日报、工程会议、变更签证、专项施工方案、规范摘录和知识包治理。\n- **建筑 AI / 软件研发治理技能包**：支持一把手评审、产品经理评审、架构评审、产品与界面方案评审、交付规划、代码审查、Runtime 设计、RAG / GraphRAG、MCP / Tool Calling、Capability 证据仲裁和受控执行。\n\nAIOS 的目标不是让 AI 替代专业人员做最终判断，而是帮助使用者把工程资料和行业知识整理成可复核的清单、台账、初稿、证据链、Knowledge Pack 和人工复核事项。它强调资料来源、版本、页码、章节、适用条件、风险提示和人工复核岗位，避免把模型推断误当成工程结论。\n\nv1.5.0 开始，AIOS 的主线从“能写工程文档”推进到“能治理工程知识”：除了标书、方案、日报、会议纪要等写作与复核型 Skill，也提供 Knowledge Pack 工作台和本地 Reference Runtime，把规范摘录、企业标准、项目资料、历史审查口径和人工复核记录治理为可编译、可查询、可评估的工程知识资产。\n\n## 设计目标\n\nAIOS 的设计目标有五个：\n\n1. 让建筑 AI / 软件研发更有边界：把产品定位、版本产品契约、架构、界面方案、交付计划、代码审查和 Runtime 设计放进可复核的工作流。\n2. 让研发团队有可验证的 Runtime 路径：涉及规范、结构计算、RAG / GraphRAG、Tool Calling 和多 Agent 协作时，优先回到项目事实、结构化知识和确定性工具证据。\n3. 让建筑行业资料工作更可复核：把标书、合同、日报、会议、变更签证和施工方案整理成有来源、有缺口、有风险、有复核岗位的工作底稿。\n4. 让工程知识可以治理：把规范摘录、企业标准、审查口径和项目经验沉淀为 Knowledge Pack，而不是散落在聊天记录和临时 Prompt 中。\n5. 让多种 AI 工具保持一致边界：同一套 Skill、Workflow 和项目规则可安装到 WorkBuddy、Codex、Claude Code、OpenCode、Gemini、Antigravity 等工具。\n\nAIOS 是建筑行业增强层，不是通用任务替代器。普通非建筑任务不应被强行套用 BIM、IFC、规范、审图或工程证据链假设；涉及法务、造价、财务、监理、安全、项目经理、总工、专家或注册人员签审时，AIOS 只做资料整理、风险标注和人工复核分流。\n\n## 适合谁\n\nAIOS 现在面向两类用户。第一类是建筑 AI / 软件研发团队，负责把行业能力做成可信系统；第二类是建筑行业知识工作从业者，负责把真实工程资料和经验转成可复核的工作底稿和知识资产。\n\n### 建筑 AI / 软件研发治理\n\n| 角色 | 可以用它做什么 |\n| --- | --- |\n| 建筑行业软件 / AI 产品负责人 | 用 `aios-ceo` 判断定位和阶段边界，用 `aios-product` 形成版本范围、PRD、指标和试点闭环，再交给 `aios-design`、`aios-arch` 和 `aios-plan`。 |\n| 架构师 / 后端 / AI 工程师 | 用 `aios-arch-health` 核验复杂度、依赖、测试证据来源和受保护约束，再用 `aios-arch`、`aios-runtime`、`aios-structural` 和 `aios-exec` 评估服务边界、数据链路、Runtime、RAG / GraphRAG、结构计算工具链和受控执行。 |\n| 代码审查 / 质量负责人 | 用 `aios-review` 审查 diff、PR、AI 生成代码、安全敏感改动、Prompt / Tool / Runtime 变更、测试缺口和发布准备度。 |\n| 建筑数字化 / AI 应用团队 | 把行业知识、评估样例、RAG / GraphRAG、Tool Calling 和多 Agent 流程纳入可验证的工程链路。 |\n| 企业负责人 / 研发负责人 | 统一多工具、多模型、多 Agent 的研发边界和交付检查方式，评估 AIOS 在团队中的使用范围、投入顺序和风险边界。 |\n\n### 建筑工程资料与知识工作\n\n| 角色 | 可以用它做什么 |\n| --- | --- |\n| 投标 / 技术标人员 | 复核招标文件、评分办法、资格条件和技术标要求，生成响应矩阵、资料缺口、废标风险和技术标章节初稿。 |\n| 方案编制人员 / 技术负责人 | 复核专项施工方案、危险源、交底要点、专家意见和计算书缺口，生成方案章节或交底材料草稿。 |\n| 项目资料员 / 项目管理人员 | 整理施工日报、工程会议纪要、待办闭环、现场问题和可追踪台账。 |\n| 合同履约 / 商务人员 | 整理合同条款、履约节点、付款条件、变更签证资料链和责任边界线索。 |\n| 业务专家 / 企业标准维护者 | 沉淀规范摘录、企业标准、审查口径、工程术语、样例和人工复核点，形成 Knowledge Pack。 |\n\n## 解决什么问题\n\n- AI 输出只有泛泛总结，缺少资料来源、页码、章节、条款位置和人工复核岗位。\n- 标书、方案、合同、日报、会议纪要和变更签证资料散落，难以形成可继续工作的矩阵、清单、台账和初稿。\n- 规范摘录、企业标准、历史审查口径和项目经验沉淀在个人经验或临时文档里，难以查询、评估和复用。\n- 不同 AI 工具各读各的规则，导致输出格式、风险边界和交付检查方式不一致。\n- 建筑行业任务容易把模型推断误当成工程结论，需要默认保留“需核验 / 转人工复核 / 不得下结论”的边界。\n- 建筑 AI / 软件团队在做产品定位、架构设计、BIM / IFC、智能审图、RAG / GraphRAG、结构计算或 Runtime 接入时，缺少统一的评审、证据仲裁和发布验证路径。\n\n## 快速开始\n\n### 只想先试用技能包\n\n如果只是想在 WorkBuddy 中试用标书、合同、日报、会议纪要或施工方案相关技能，优先使用：\n\n```bash\nnpx @archsight/aios@latest install --target workbuddy --scope user\n```\n\n安装后可检查：\n\n```bash\nnpx @archsight/aios@latest doctor\n```\n\n打开 WorkBuddy 后，可以先试下面几类指令：\n\n研发治理类：\n\n```text\n$aios-ceo 请从一把手视角评估这个建筑行业 AI 产品的定位、行业专业性、工程可信度、证据链、商业验证、阶段路线和停损信号。\n```\n\n```text\n$aios-product 请从产品经理视角体检当前项目，把已确认方向转成下一版用户问题、版本范围、非目标、用户故事、验收指标、试点 / UAT 和研发交接。\n```\n\n```text\n$aios-arch 请评审以下建筑 AI 系统方案的服务边界、数据链路、模型 / Runtime 边界、GraphRAG 架构、Agent 工作流治理和长期复杂度风险。\n```\n\n`aios-ceo` 与 `aios-arch` 可以直接联合使用，不必为了凑齐流程强制加入产品经理：\n\n```text\n$aios-ceo $aios-arch 请共同评审这个项目。CEO 判断定位、商业证据、阶段路线和停损边界；架构师独立判断技术可信度、服务边界、失败模式和长期代价；最后汇总一致项、冲突项和处理建议。只有结论需要进入下一版 PRD、验收或试点时，再调用 $aios-product。\n```\n\n重大版本需要三者同时参与时，默认顺序是 CEO 定战略门槛、Product 定版本契约、Arch 校验技术边界，再由 Product 回写范围和验收。\n\n```text\n$aios-review 请审查以下 diff 或 PR，重点看 AI 生成代码风险、安全敏感改动、Prompt / Tool / Runtime 变更、测试缺口和发布准备度。\n```\n\n工程资料类：\n\n```text\n$aios-tender-audit 请复核以下技术标资料，输出评分点响应矩阵、废标风险、资料缺口和人工复核岗位。\n```\n\n```text\n$aios-scheme-audit 请复核以下专项施工方案，输出危险源、交底要点、计算书缺口、专家意见回查和人工复核岗位。\n```\n\n```text\n$aios-daily-write 请基于以下现场口述、项目群记录或照片说明，生成施工日报 Markdown 草稿，并保留资料来源、待补资料和审核门禁。\n```\n\n面向建筑行业业务人员的完整自助说明见 [建筑行业技能包自助试用指南](docs/industry-user-trial-guide.md)。\n\n### 需要安装到多个 AI 工具\n\n```bash\nnpx @archsight/aios@latest install --target all --scope user\nnpx @archsight/aios@latest doctor\n```\n\n这会把 AIOS 的 Skills、Workflows、Runtime 和模板安装到当前用户目录，让 Codex、Claude Code、OpenCode、Gemini、Antigravity、WorkBuddy 等工具可以读取。\n\n### 需要给项目接入 AIOS 治理\n\n```bash\ncd /path/to/your-project\nnpx @archsight/aios@latest init\n```\n\n执行后，当前业务项目会获得统一的 AI 入口文件和 `.ai/` 项目治理目录。已有 `AGENTS.md`、`CLAUDE.md`、`GEMINI.md`、`OPENCODE.md` 或 `AI_CODING_RULES.md` 的项目不会被覆盖；CLI 会补充缺失文件，并在合适的位置追加 ArchSight AIOS 引用。\n\n`init` 默认会读取项目名、README、package / pyproject 和浅层文件名，自动生成 `.ai/profile-detection.md`，并在首次创建 `.ai/project-context.md` 时预填项目名、技术栈、常用命令、代码结构和候选 AIOS 能力。用户不需要先理解 profile，也不需要手动合并 AI 规则文件。\n\n如果你需要一步一步安装和验证，可以看 [快速上手](docs/quickstart.md)。\n\n## 核心能力\n\n| 能力 | 说明 |\n| --- | --- |\n| 工程资料技能包 | 覆盖招投标、合同履约、施工日报、工程会议、变更签证和专项施工方案，输出清单、矩阵、台账、初稿和人工复核事项。 |\n| 工程文档写作工作台 | 用 Markdown 工作母版组织标书、技术标和施工方案的资料来源、历史素材、写作 brief、草稿、复核记录和人工定稿。 |\n| Knowledge Pack | 把规范摘录、企业标准、项目资料、审查口径和复核记录治理为可编译、可查询、可评估的工程知识资产。 |\n| 本地 Reference Runtime | 通过 `knowledge.norm_lookup` 查询编译后的 Knowledge Pack，返回引用、版本、适用性、冲突和仲裁状态。 |\n| 建筑 AI / 软件研发治理 | 覆盖 `aios-ceo`、`aios-product`、`aios-arch-health`、`aios-arch`、`aios-design`、`aios-plan`、`aios-review`、`aios-runtime`、`aios-exec` 等研发评审和执行入口。 |\n| 多工具安装与公共发现 | 支持 WorkBuddy、Codex、Claude Code、OpenCode、Gemini、Antigravity、`npx skills` 等工具发现和安装。 |\n| Capability 证据仲裁 | 对规范、结构计算、工具调用和多 Agent 冲突保留 `Claim / Evidence / Tool Result / Decision`，避免无证据结论。 |\n| Git 提交治理 | 用同一校验器约束中文 Conventional + Lore Commit，并在 commit-msg、pre-push 与 CI 三层复核共享历史。 |\n\n## 常用技能入口\n\n### 工程资料与知识工作\n\n| 场景 | 推荐入口 |\n| --- | --- |\n| 招投标未区分写作或审核 | `aios-tender` |\n| 技术标 / 招标文件复核 | `aios-tender-audit`，已培训旧命令的团队可继续使用 `aios-commercial-tender` |\n| 技术标章节生成或改写 | `aios-tender-write` |\n| 合同履约复核 | `aios-contract-audit`，已培训旧命令的团队可继续使用 `aios-commercial-contract` |\n| 合同条款、补充协议或履约函件草拟 | `aios-contract-draft` |\n| 施工日报未区分生成或复核 | `aios-daily` |\n| 施工日报生成 | `aios-daily-write` |\n| 施工日报复核和问题台账 | `aios-construction-daily` |\n| 工程会议未区分生成或复核 | `aios-meeting` |\n| 工程会议纪要生成 | `aios-meeting-write` |\n| 工程会议纪要复核和待办闭环 | `aios-construction-meeting` |\n| 专项施工方案未区分写作或审核 | `aios-scheme` |\n| 专项施工方案复核 | `aios-scheme-audit`，已培训旧命令的团队可继续使用 `aios-construction-scheme` |\n| 专项施工方案生成或改写 | `aios-scheme-write` |\n| 规范、企业标准和知识包治理 | `aios-knowledge` |\n\n`aios-commercial-*` 和 `aios-construction-*` 系列继续保留原有领域型入口含义，适合已经在团队培训和内部流程中使用这些命令的场景；`aios-tender*`、`aios-contract-*`、`aios-daily*`、`aios-meeting*` 和 `aios-scheme*` 是更短的任务型入口，适合新用户自助试用。\n\n### 建筑 AI / 软件研发治理\n\n| 场景 | 推荐入口 |\n| --- | --- |\n| 企业负责人 / 一把手深度评审 | `aios-ceo` |\n| 产品体检、用户问题、版本范围、PRD、产品优先级、验收指标和试点 / UAT | `aios-product` |\n| 复杂度、依赖方向、测试证据来源、受保护约束、架构债基线和棘轮门禁 | `aios-arch-health` |\n| 架构、服务边界、数据 / 模型 / Runtime 边界和长期复杂度 | `aios-arch` |\n| 建筑行业平台界面、审图工作台、BIM Viewer、规范检索和报告复核体验 | `aios-design` |\n| 功能、bug、架构决策、PR / 发布顺序和 CI/CD 交付拆解 | `aios-plan` |\n| diff、PR、AI 生成代码、安全敏感改动、依赖更新和发布准备度 | `aios-review` |\n| Prompt、Context、Memory、MCP 权限、RAG / GraphRAG、Embedding 和多 Agent 编排 | `aios-runtime` |\n| BIM、IFC、建筑规范、审图规则、领域实体和知识图谱 schema | `aios-knowledge` |\n| 结构力学、荷载、边界条件、FEM 输入输出和确定性求解链路 | `aios-structural` |\n| 明确范围内的代码、文档、脚本、测试和验证执行 | `aios-exec` |\n| 两份文档、两个版本或两个 AI 输出的专业度对比 | `aios-compare` |\n| 内部 Prompt / Skill 回归、weak/basic/runtime 三栏评测 | `aios-prompt-compare` |\n\n## 自动行业识别\n\nAIOS 默认内置所有行业 profile 模板。`init` 默认使用 `--profile auto`，根据当前项目和资料线索自动识别是否启用 profile：\n\n```bash\nnpx @archsight/aios init\n```\n\n如果需要人工覆盖，也可以显式指定：\n\n```bash\nnpx @archsight/aios init --profile auto\nnpx @archsight/aios init --profile none\nnpx @archsight/aios init --profile all\nnpx @archsight/aios init --profile bim-platform\nnpx @archsight/aios init --profile construction-vision\nnpx @archsight/aios init --profile rag-knowledge\n```\n\n| Profile | 适用项目 |\n| --- | --- |\n| `bim-platform` | 工程模型轴：BIM / IFC / Revit / CAD / 建模平台 / 模型质检。 |\n| `construction-vision` | 现场感知轴：YOLO、图像分割、Segment Anything、深度估计、焊缝 / 裂缝检测、施工巡检。 |\n| `rag-knowledge` | 知识规则轴：建筑规范知识库、RAG、GraphRAG、知识图谱、审图规则。 |\n\n## 项目会生成什么\n\n| 文件 / 目录 | 作用 |\n| --- | --- |\n| `AGENTS.md` | Codex 等 Agent 工具读取的项目入口。 |\n| `CLAUDE.md` | Claude Code 读取的项目入口。 |\n| `GEMINI.md` | Gemini 读取的项目入口。 |\n| `OPENCODE.md` | OpenCode 读取的项目入口。 |\n| `AI_CODING_RULES.md` | 项目通用 AI 编码规则。 |\n| `.ai/ARCHSIGHT_AIOS_RULES.md` | ArchSight AIOS 补充规则。 |\n| `.ai/project-context.md` | 项目事实、业务背景和边界。 |\n| `.ai/profile-detection.md` | 自动识别的 profile / Skill 候选、命中证据和人工复核边界。 |\n| `.ai/agent-routing.md` | 不同任务该交给哪个 Agent / Skill。 |\n| `.ai/skills.md` | 当前项目可用的 ArchSight Skills。 |\n| `.ai/workflows.md` | 当前项目可用的 Workflow 和验收路径。 |\n\n## Capability 与冲突仲裁\n\nAIOS 的多 Agent 协作不应停留在 Prompt 角色扮演。Agent 提出架构、交付、规范、结构计算或安全判断时，必须尽量回到项目事实、结构化知识和确定性工具证据。\n\n- `governance/arbitration-protocol.md` 定义证据优先级、Claim 契约、阻断规则和人工升级条件。\n- `runtime/capability-registry.json` 定义最小 Capability 接口，例如测试 runner、规范查询、梁挠度、梁挠度限值校核、框架位移和桁架杆力求解器接口。\n- `runtime/capability-adapters.json` 定义本地 stdio MCP Adapter 映射；AIOS 先按 Agent / Skill 权限校验，再调用 `archsight-solver` MCP Tool，并把结构化结果交给仲裁规则。\n- `aios-structural` 提供 Euclid 结构力学评审入口，要求关键数值来自求解器、项目计算书或可复验脚本，而不是 LLM 口算。\n\n## 常用命令\n\n| 命令 | 用途 |\n| --- | --- |\n| `help` | 查看 CLI 帮助、可用命令和示例。 |\n| `install` | 安装 ArchSight AIOS 用户级资产到 Codex、Claude Code、OpenCode、Antigravity 2.0、Gemini、WorkBuddy 和共享目录。 |\n| `doctor` | 检查仓库资产、manifest、用户级安装、Skill 和 Workflow 是否一致。 |\n| `init` | 给具体业务项目接入 AI 规则、`.ai/` 治理目录、自动 profile 识别和项目上下文草稿。 |\n| `writing:init` | 在业务项目中创建标书 / 方案写作 Markdown 工作台，用于写作型 Skill 生成和审核门禁交接。 |\n| `writing:validate` | 检查写作工作台的文件链、来源、复用、待补、审核门禁和人工定稿边界。 |\n| `knowledge:init` | 创建工程知识治理工作台，用于沉淀 Knowledge Pack。 |\n| `knowledge:validate` | 检查知识包文件链、来源、标准、条文、图谱、查询规则和评估问题。 |\n| `knowledge:compile` | 将工作台编译为 `archsight-aios.knowledge-pack` Runtime 资产。 |\n| `knowledge:lookup` | 使用本地 Reference Runtime 查询编译后的 Knowledge Pack。 |\n| `knowledge:eval` | 执行知识包评估问题，检查引用、版本、拒答、冲突和适用性。 |\n| `validate` | 验证项目接入模板能否生成并引用当前登记的 Skills / Workflows。 |\n| `validate:skills` | 校验公共 skill 发现入口、frontmatter、跨 host manifest 和 npm metadata 是否一致。 |\n| `capability:call` | 按 Capability Registry 权限边界调用本地 MCP Adapter，并输出 Tool Result 与仲裁 Decision。 |\n\n本地调用 `archsight-solver` 示例：\n\n```powershell\n$env:ARCHSIGHT_SOLVER_HOME = \"<archsight-solver 本地仓库绝对路径>\"\nnpx @archsight/aios capability:call --capability solver.beam_deflection --agent euclid --skill aios-structural --input beam-input.json\nnpx @archsight/aios capability:call --capability solver.beam_deflection_serviceability_check --agent euclid --skill aios-structural --input beam-serviceability-input.json\n```\n\n如果 `archsight-aios` 和 `archsight-solver` 是同级目录，CLI 会默认尝试使用相邻的 `../archsight-solver`，通常无需设置 `ARCHSIGHT_SOLVER_HOME`。\n\n## 工程文档写作工作台\n\nv1.4.0 开始，AIOS 提供写作型 Skill 和 Markdown 工作母版，用于标书、技术标、专项施工方案和交底材料的生成 / 改写。Markdown 是 AIOS 工作母版，Word / PDF / PPT 只作为后续交付格式。\n\n在项目目录创建工作台：\n\n```bash\nnpx @archsight/aios writing:init --type tender\nnpx @archsight/aios writing:init --type scheme --name scheme-workbench\nnpx @archsight/aios writing:init --type tender --sample --name tender-sample\n```\n\n生成目录默认包含：\n\n- `source-normalized.md`：归一化输入资料和来源链。\n- `material-index.md`：历史素材、复用级别和不可套用原因。\n- `writing-brief.md`：写作任务、目标章节、禁止结论和人工复核岗位。\n- `draft.md`：AI 生成或改写的章节草稿。\n- `review-notes.md`：交给审核 Skill 后的复核记录。\n- `final.md`：人工确认后的最终 Markdown 母版。\n\n检查工作台完整性：\n\n```bash\nnpx @archsight/aios writing:validate --name document-writing\n```\n\n推荐路由：\n\n- 招投标通用入口：新用户优先使用 `aios-tender`；只做复核时使用 `aios-tender-audit`，写作时使用 `aios-tender-write`。\n- 合同通用入口：只做合同履约复核时使用 `aios-contract-audit`；草拟补充协议、条款改写、履约通知或函件时使用 `aios-contract-draft`。\n- 施工日报通用入口：新用户优先使用 `aios-daily`；从口述、项目群记录或照片说明生成日报时使用 `aios-daily-write`，复核已有日报和问题台账时使用 `aios-construction-daily`。\n- 工程会议通用入口：新用户优先使用 `aios-meeting`；从录音转写、会议笔记或群聊摘要生成纪要时使用 `aios-meeting-write`，复核已有纪要和待办闭环时使用 `aios-construction-meeting`。\n- 专项施工方案通用入口：新用户优先使用 `aios-scheme`；只做复核时使用 `aios-scheme-audit`，写作时使用 `aios-scheme-write`。\n- 标书 / 技术标写作：先用 `aios-tender-write`，再交给 `aios-tender-audit` 审核门禁；已使用 `aios-commercial-tender` 的团队可继续使用原领域型入口。\n- 合同草拟：先用 `aios-contract-draft`，再交给 `aios-contract-audit` 审核门禁；已使用 `aios-commercial-contract` 的团队可继续使用原领域型入口。\n- 日报 / 会议纪要写作：先用 `aios-daily-write` 或 `aios-meeting-write`，再分别交给 `aios-construction-daily` 或 `aios-construction-meeting` 做证据链和闭环复核。\n- 专项施工方案写作：先用 `aios-scheme-write`，再交给 `aios-scheme-audit` 审核门禁；已使用 `aios-construction-scheme` 的团队可继续使用原领域型入口。\n\n`writing:init` 只创建缺失文件，重复执行不会覆盖已有工作台内容。\n\n## Knowledge Pack 与本地 Reference Runtime\n\nv1.5.0 开始，AIOS 提供工程知识治理能力：把规范摘录、企业标准、项目资料、历史审查口径和人工复核记录治理为可编译、可查询、可评估的 `Knowledge Pack`。\n\n创建合成样板：\n\n```bash\nnpx @archsight/aios knowledge:init --sample --name scheme-review\nnpx @archsight/aios knowledge:validate --name scheme-review\nnpx @archsight/aios knowledge:compile --name scheme-review\n```\n\n查询编译产物：\n\n```bash\nnpx @archsight/aios knowledge:lookup --pack scheme-review/compiled/knowledge-pack.json --query \"高支模方案是否应检查计算书\"\nnpx @archsight/aios knowledge:eval --name scheme-review\n```\n\n`knowledge.norm_lookup` 现在有本地 stdio MCP Reference Runtime，可通过 `capability:call` 走同一套权限、证据和仲裁规则：\n\n```bash\nnpx @archsight/aios capability:call --capability knowledge.norm_lookup --agent vitruvius --skill aios-knowledge --input lookup-input.json\n```\n\n`lookup-input.json` 至少包含：\n\n```json\n{\n  \"knowledgePackPath\": \"scheme-review/compiled/knowledge-pack.json\",\n  \"query\": \"高支模方案是否应检查计算书\"\n}\n```\n\nKnowledge Pack 不是生产级规范数据库，也不替代法务、总工、专家、审图或注册人员签审。缺来源、缺版本、缺项目条件或存在冲突时，Reference Runtime 必须返回 `need_context`、`not_found`、`conflict` 或 `inapplicable`。\n\n## 安装位置\n\n`install --target all --scope user` 会写入当前用户目录：\n\n- Codex：`~/.codex/skills/`、`~/.codex/workflows/aios/`\n- Claude Code：`~/.claude/skills/`\n- OpenCode：`~/.opencode/skills/`\n- Gemini：`~/.gemini/GEMINI.md`、`~/.gemini/archsight-aios/`\n- Antigravity 2.0：`~/.gemini/config/plugins/archsight-aios/`\n- Antigravity 1.x legacy：仅当已存在 `~/.gemini/antigravity/` 时，写入 `~/.gemini/antigravity/skills/`；如果同时检测到 Antigravity 2.0 配置，也会额外写入 2.0 plugin 目录。\n- WorkBuddy：`~/.workbuddy/skills/`\n\n`~/.agents/skills/` 和 `~/.agents/workflows/aios/` 是可选的通用 Agent 共享目录，不是所有 AI Agent 都会自动读取。需要这类兼容目录时，单独执行：\n\n```bash\nnpx @archsight/aios install --target agents --scope user\n```\n\nWorkBuddy 固定读取个人 skills 目录，可单独安装：\n\n```bash\nnpx @archsight/aios install --target workbuddy --scope user\n```\n\nClaude Code 和 OpenCode 也可以按需单独写入个人 skills 目录：\n\n```bash\nnpx @archsight/aios install --target claude-code --scope user\nnpx @archsight/aios install --target opencode --scope user\n```\n\n## 公共发现\n\nAIOS 保留标准 `skills/` 目录作为公共发现入口，供 `skills.sh`、`npx skills`、Antigravity / agy、Gemini CLI extension、Claude Code plugin marketplace、OpenCode、WorkBuddy 和第三方索引器扫描。\n\n```powershell\nnpx skills add ArchSightLabs/archsight-aios --list\nnpx skills add ArchSightLabs/archsight-aios --skill aios-arch --global\n```\n\n跨 host 发现元数据包括根目录 `gemini-extension.json`、`.claude-plugin/plugin.json`、`.claude-plugin/marketplace.json` 和 `package.json` 的 `agent-skills` / `skills-sh` / `gemini-cli` 等关键词。公共发现、GitHub topics、索引请求和发布前检查见 [公共发现与上架清单](docs/PUBLIC_DISCOVERY.md)。\n\n## init 默认行为\n\n`init` 默认使用 `--mode auto`：\n\n- 新项目或没有 AI 工具入口文件时，创建 `AGENTS.md`、`AI_CODING_RULES.md`、`CLAUDE.md`、`GEMINI.md`、`OPENCODE.md` 和 `.ai/` 模板文件。\n- 已存在 `AGENTS.md`、`AI_CODING_RULES.md`、`CLAUDE.md`、`GEMINI.md` 或 `OPENCODE.md` 时，创建缺失的 `.ai/` 文件，并在 `AGENTS.md`、`CLAUDE.md`、`GEMINI.md`、`OPENCODE.md` 中追加或刷新 ArchSight AIOS 托管引用块。\n- 默认使用 `--profile auto`：根据项目名、README、package / pyproject、浅层目录和资料文件名生成 `.ai/profile-detection.md`，并自动复制高置信度命中的 profile。\n- 首次创建 `.ai/project-context.md` 时，会自动预填项目名、技术栈、常用命令、代码结构和候选 Skills；重复执行不会覆盖人工修订后的项目上下文。\n- 重复执行不会重复追加托管块，也不会覆盖已有项目规则。\n- 自动模式不修改已有 `AI_CODING_RULES.md` 正文。\n\n## 行业边界\n\n建筑行业能力通过 `.ai/profile-detection.md`、显式 `--profile` 或明确任务触发。未启用相关 profile 的项目，不应默认加载 BIM、IFC、GraphRAG、审图或建筑规范假设。\n\n如需覆盖自动识别：\n\n```bash\nnpx @archsight/aios init --profile none\nnpx @archsight/aios init --profile all\nnpx @archsight/aios init --profile bim-platform\n```\n\n前端应用、后端服务、CLI 工具、数据管道等工程形态优先由 Workflow / Skill / Agent 路由处理，不默认扩展为 profile。只有当某类项目存在稳定的行业语义、证据链、评估集或人工复核差异时，才应考虑新增 profile。\n\n如需强制指定模式：\n\n```bash\nnpx @archsight/aios init --mode full\nnpx @archsight/aios init --mode linked\nnpx @archsight/aios init --mode ai-only\n```\n\n## 本地开发验证\n\n如果是从源码仓库运行，而不是通过 npm 包运行：\n\n```bash\nnpm run install:user\nnpm run doctor\nnpm run smoke:project\nnpm run validate:skills\nnpx skills add . --list\nnpm test\n```\n\n## 核心材料\n\n- [架构健康扫描与棘轮治理](docs/architecture-health.md)\n- [快速上手](docs/quickstart.md)\n- [建筑行业技能包自助试用指南](docs/industry-user-trial-guide.md)\n- [业务专家指南](docs/business-expert-guide.md)\n- [术语表](docs/glossary.md)\n- [AI 编码规范](AI_CODING_RULES.md)\n- [Git 提交治理](governance/git-commit-policy.md)\n- [Agents](agents/README.md)\n- [Skills](skills/README.md)\n- [Workflows](workflows/README.md)\n- [Templates](templates/README.md)\n- [Runtime 路由](runtime/agent-routing.md)\n- [WorkBuddy 适配说明](adapters/workbuddy/README.md)\n- [v1.4.0 写作工作流快速使用](docs/v1.4.0-writing-workflow-quickstart.md)\n- [v1.4.0 写作能力边界](docs/v1.4.0-writing-boundary.md)\n- [公共发现与上架清单](docs/PUBLIC_DISCOVERY.md)\n\n## 开源协作\n\n- 许可证：[Apache-2.0](LICENSE)\n- 贡献说明：[CONTRIBUTING.md](CONTRIBUTING.md)\n- 安全问题：[SECURITY.md](SECURITY.md)\n- 行为准则：[CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)\n- 变更记录：[CHANGELOG.md](CHANGELOG.md)\n\n### 商业边界\n\n- Apache-2.0 允许商业使用、修改、分发和私有部署；分发时需保留版权声明、许可证文本和必要 NOTICE，并遵守 Apache-2.0 的专利与免责声明条款。\n- 许可证只覆盖本仓库开源内容，不授权 ArchSightLabs / ArchSight 商标、品牌资产、托管服务、专有数据集、客户案例、商业支持、SLA 或任何第三方受限素材。\n- 基于 AIOS 提供商业产品、咨询或二次分发时，不得暗示官方认证、代理、合作或背书；工程结论、合规责任和客户交付责任由使用方自行承担。\n",
  "bytes": 17140,
  "sha": "5dec1ed90e69b9d12eddd1ae69ffd9010e25ceb95e056838f1ed0a09c1adf085",
  "repo_slug": "archsightlabs/archsight-aios",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_archsightlabs_archsight_aios_a986e926/readme"
}