ArchSight AIOS

ArchSight AIOS 是面向建筑行业的开源 AI 技能包与工程知识治理工具包。它让 WorkBuddy、Codex、Claude Code、OpenCode、Gemini、Antigravity 等 AI 工具可以使用同一组建筑行业 Skills、Workflows、Templates 和 Runtime 规则。

AIOS 不是从研发工具转成业务资料工具,而是在保留建筑 AI / 软件研发治理能力的基础上,扩展到建筑行业知识工作从业者。现在它同时覆盖两套并列能力:

  • 建筑工程资料与知识工作技能包:处理工程资料、技术标、合同履约、施工日报、工程会议、变更签证、专项施工方案、规范摘录和知识包治理。
  • 建筑 AI / 软件研发治理技能包:支持一把手评审、架构评审、产品与界面方案评审、交付规划、代码审查、Runtime 设计、RAG / GraphRAG、MCP / Tool Calling、Capability 证据仲裁和受控执行。

AIOS 的目标不是让 AI 替代专业人员做最终判断,而是帮助使用者把工程资料和行业知识整理成可复核的清单、台账、初稿、证据链、Knowledge Pack 和人工复核事项。它强调资料来源、版本、页码、章节、适用条件、风险提示和人工复核岗位,避免把模型推断误当成工程结论。

v1.5.0 开始,AIOS 的主线从“能写工程文档”推进到“能治理工程知识”:除了标书、方案、日报、会议纪要等写作与复核型 Skill,也提供 Knowledge Pack 工作台和本地 Reference Runtime,把规范摘录、企业标准、项目资料、历史审查口径和人工复核记录治理为可编译、可查询、可评估的工程知识资产。

设计目标

AIOS 的设计目标有五个:

  1. 让建筑 AI / 软件研发更有边界:把产品定位、架构、界面方案、交付计划、代码审查和 Runtime 设计放进可复核的工作流。
  2. 让研发团队有可验证的 Runtime 路径:涉及规范、结构计算、RAG / GraphRAG、Tool Calling 和多 Agent 协作时,优先回到项目事实、结构化知识和确定性工具证据。
  3. 让建筑行业资料工作更可复核:把标书、合同、日报、会议、变更签证和施工方案整理成有来源、有缺口、有风险、有复核岗位的工作底稿。
  4. 让工程知识可以治理:把规范摘录、企业标准、审查口径和项目经验沉淀为 Knowledge Pack,而不是散落在聊天记录和临时 Prompt 中。
  5. 让多种 AI 工具保持一致边界:同一套 Skill、Workflow 和项目规则可安装到 WorkBuddy、Codex、Claude Code、OpenCode、Gemini、Antigravity 等工具。

AIOS 是建筑行业增强层,不是通用任务替代器。普通非建筑任务不应被强行套用 BIM、IFC、规范、审图或工程证据链假设;涉及法务、造价、财务、监理、安全、项目经理、总工、专家或注册人员签审时,AIOS 只做资料整理、风险标注和人工复核分流。

适合谁

AIOS 现在面向两类用户。第一类是建筑 AI / 软件研发团队,负责把行业能力做成可信系统;第二类是建筑行业知识工作从业者,负责把真实工程资料和经验转成可复核的工作底稿和知识资产。

建筑 AI / 软件研发治理

角色 可以用它做什么
建筑行业软件 / AI 产品负责人 aios-ceoaios-designaios-plan 评估产品定位、行业专业性、工作台体验、交付路线和停损信号。
架构师 / 后端 / AI 工程师 aios-archaios-runtimeaios-structuralaios-exec 评估服务边界、数据链路、Runtime、RAG / GraphRAG、结构计算工具链和受控执行。
代码审查 / 质量负责人 aios-review 审查 diff、PR、AI 生成代码、安全敏感改动、Prompt / Tool / Runtime 变更、测试缺口和发布准备度。
建筑数字化 / AI 应用团队 把行业知识、评估样例、RAG / GraphRAG、Tool Calling 和多 Agent 流程纳入可验证的工程链路。
企业负责人 / 研发负责人 统一多工具、多模型、多 Agent 的研发边界和交付检查方式,评估 AIOS 在团队中的使用范围、投入顺序和风险边界。

建筑工程资料与知识工作

角色 可以用它做什么
投标 / 技术标人员 复核招标文件、评分办法、资格条件和技术标要求,生成响应矩阵、资料缺口、废标风险和技术标章节初稿。
方案编制人员 / 技术负责人 复核专项施工方案、危险源、交底要点、专家意见和计算书缺口,生成方案章节或交底材料草稿。
项目资料员 / 项目管理人员 整理施工日报、工程会议纪要、待办闭环、现场问题和可追踪台账。
合同履约 / 商务人员 整理合同条款、履约节点、付款条件、变更签证资料链和责任边界线索。
业务专家 / 企业标准维护者 沉淀规范摘录、企业标准、审查口径、工程术语、样例和人工复核点,形成 Knowledge Pack。

解决什么问题

  • AI 输出只有泛泛总结,缺少资料来源、页码、章节、条款位置和人工复核岗位。
  • 标书、方案、合同、日报、会议纪要和变更签证资料散落,难以形成可继续工作的矩阵、清单、台账和初稿。
  • 规范摘录、企业标准、历史审查口径和项目经验沉淀在个人经验或临时文档里,难以查询、评估和复用。
  • 不同 AI 工具各读各的规则,导致输出格式、风险边界和交付检查方式不一致。
  • 建筑行业任务容易把模型推断误当成工程结论,需要默认保留“需核验 / 转人工复核 / 不得下结论”的边界。
  • 建筑 AI / 软件团队在做产品定位、架构设计、BIM / IFC、智能审图、RAG / GraphRAG、结构计算或 Runtime 接入时,缺少统一的评审、证据仲裁和发布验证路径。

快速开始

只想先试用技能包

如果只是想在 WorkBuddy 中试用标书、合同、日报、会议纪要或施工方案相关技能,优先使用:

npx @archsight/aios@latest install --target workbuddy --scope user

安装后可检查:

npx @archsight/aios@latest doctor

打开 WorkBuddy 后,可以先试下面几类指令:

研发治理类:

$aios-ceo 请从一把手视角评估这个建筑行业 AI 产品的定位、行业专业性、工程可信度、证据链、商业验证、阶段路线和停损信号。
$aios-arch 请评审以下建筑 AI 系统方案的服务边界、数据链路、模型 / Runtime 边界、GraphRAG 架构、Agent 工作流治理和长期复杂度风险。
$aios-review 请审查以下 diff 或 PR,重点看 AI 生成代码风险、安全敏感改动、Prompt / Tool / Runtime 变更、测试缺口和发布准备度。

工程资料类:

$aios-tender-audit 请复核以下技术标资料,输出评分点响应矩阵、废标风险、资料缺口和人工复核岗位。
$aios-scheme-audit 请复核以下专项施工方案,输出危险源、交底要点、计算书缺口、专家意见回查和人工复核岗位。
$aios-daily-write 请基于以下现场口述、项目群记录或照片说明,生成施工日报 Markdown 草稿,并保留资料来源、待补资料和审核门禁。

面向建筑行业业务人员的完整自助说明见 建筑行业技能包自助试用指南

需要安装到多个 AI 工具

npx @archsight/aios@latest install --target all --scope user
npx @archsight/aios@latest doctor

这会把 AIOS 的 Skills、Workflows、Runtime 和模板安装到当前用户目录,让 Codex、Claude Code、OpenCode、Gemini、Antigravity、WorkBuddy 等工具可以读取。

需要给项目接入 AIOS 治理

cd /path/to/your-project
npx @archsight/aios@latest init

执行后,当前业务项目会获得统一的 AI 入口文件和 .ai/ 项目治理目录。已有 AGENTS.mdCLAUDE.mdGEMINI.mdOPENCODE.mdAI_CODING_RULES.md 的项目不会被覆盖;CLI 会补充缺失文件,并在合适的位置追加 ArchSight AIOS 引用。

init 默认会读取项目名、README、package / pyproject 和浅层文件名,自动生成 .ai/profile-detection.md,并在首次创建 .ai/project-context.md 时预填项目名、技术栈、常用命令、代码结构和候选 AIOS 能力。用户不需要先理解 profile,也不需要手动合并 AI 规则文件。

如果你需要一步一步安装和验证,可以看 快速上手

核心能力

能力 说明
工程资料技能包 覆盖招投标、合同履约、施工日报、工程会议、变更签证和专项施工方案,输出清单、矩阵、台账、初稿和人工复核事项。
工程文档写作工作台 用 Markdown 工作母版组织标书、技术标和施工方案的资料来源、历史素材、写作 brief、草稿、复核记录和人工定稿。
Knowledge Pack 把规范摘录、企业标准、项目资料、审查口径和复核记录治理为可编译、可查询、可评估的工程知识资产。
本地 Reference Runtime 通过 knowledge.norm_lookup 查询编译后的 Knowledge Pack,返回引用、版本、适用性、冲突和仲裁状态。
建筑 AI / 软件研发治理 覆盖 aios-ceoaios-archaios-designaios-planaios-reviewaios-runtimeaios-exec 等研发评审和执行入口。
多工具安装与公共发现 支持 WorkBuddy、Codex、Claude Code、OpenCode、Gemini、Antigravity、npx skills 等工具发现和安装。
Capability 证据仲裁 对规范、结构计算、工具调用和多 Agent 冲突保留 Claim / Evidence / Tool Result / Decision,避免无证据结论。

常用技能入口

工程资料与知识工作

场景 推荐入口
招投标未区分写作或审核 aios-tender
技术标 / 招标文件复核 aios-tender-audit,已培训旧命令的团队可继续使用 aios-commercial-tender
技术标章节生成或改写 aios-tender-write
合同履约复核 aios-contract-audit,已培训旧命令的团队可继续使用 aios-commercial-contract
合同条款、补充协议或履约函件草拟 aios-contract-draft
施工日报未区分生成或复核 aios-daily
施工日报生成 aios-daily-write
施工日报复核和问题台账 aios-construction-daily
工程会议未区分生成或复核 aios-meeting
工程会议纪要生成 aios-meeting-write
工程会议纪要复核和待办闭环 aios-construction-meeting
专项施工方案未区分写作或审核 aios-scheme
专项施工方案复核 aios-scheme-audit,已培训旧命令的团队可继续使用 aios-construction-scheme
专项施工方案生成或改写 aios-scheme-write
规范、企业标准和知识包治理 aios-knowledge

aios-commercial-*aios-construction-* 系列继续保留原有领域型入口含义,适合已经在团队培训和内部流程中使用这些命令的场景;aios-tender*aios-contract-*aios-daily*aios-meeting*aios-scheme* 是更短的任务型入口,适合新用户自助试用。

建筑 AI / 软件研发治理

场景 推荐入口
企业负责人 / 一把手深度评审 aios-ceo
架构、服务边界、数据 / 模型 / Runtime 边界和长期复杂度 aios-arch
建筑行业平台界面、审图工作台、BIM Viewer、规范检索和报告复核体验 aios-design
功能、bug、架构决策、PR / 发布顺序和 CI/CD 交付拆解 aios-plan
diff、PR、AI 生成代码、安全敏感改动、依赖更新和发布准备度 aios-review
Prompt、Context、Memory、MCP 权限、RAG / GraphRAG、Embedding 和多 Agent 编排 aios-runtime
BIM、IFC、建筑规范、审图规则、领域实体和知识图谱 schema aios-knowledge
结构力学、荷载、边界条件、FEM 输入输出和确定性求解链路 aios-structural
明确范围内的代码、文档、脚本、测试和验证执行 aios-exec
两份文档、两个版本或两个 AI 输出的专业度对比 aios-compare
内部 Prompt / Skill 回归、weak/basic/runtime 三栏评测 aios-prompt-compare

自动行业识别

AIOS 默认内置所有行业 profile 模板。init 默认使用 --profile auto,根据当前项目和资料线索自动识别是否启用 profile:

npx @archsight/aios init

如果需要人工覆盖,也可以显式指定:

npx @archsight/aios init --profile auto
npx @archsight/aios init --profile none
npx @archsight/aios init --profile all
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 读取的项目入口。
OPENCODE.md OpenCode 读取的项目入口。
AI_CODING_RULES.md 项目通用 AI 编码规则。
.ai/ARCHSIGHT_AIOS_RULES.md ArchSight AIOS 补充规则。
.ai/project-context.md 项目事实、业务背景和边界。
.ai/profile-detection.md 自动识别的 profile / Skill 候选、命中证据和人工复核边界。
.ai/agent-routing.md 不同任务该交给哪个 Agent / Skill。
.ai/skills.md 当前项目可用的 ArchSight Skills。
.ai/workflows.md 当前项目可用的 Workflow 和验收路径。

Capability 与冲突仲裁

AIOS 的多 Agent 协作不应停留在 Prompt 角色扮演。Agent 提出架构、交付、规范、结构计算或安全判断时,必须尽量回到项目事实、结构化知识和确定性工具证据。

  • governance/arbitration-protocol.md 定义证据优先级、Claim 契约、阻断规则和人工升级条件。
  • runtime/capability-registry.json 定义最小 Capability 接口,例如测试 runner、规范查询、梁挠度、梁挠度限值校核、框架位移和桁架杆力求解器接口。
  • runtime/capability-adapters.json 定义本地 stdio MCP Adapter 映射;AIOS 先按 Agent / Skill 权限校验,再调用 archsight-solver MCP Tool,并把结构化结果交给仲裁规则。
  • aios-structural 提供 Euclid 结构力学评审入口,要求关键数值来自求解器、项目计算书或可复验脚本,而不是 LLM 口算。

常用命令

命令 用途
help 查看 CLI 帮助、可用命令和示例。
install 安装 ArchSight AIOS 用户级资产到 Codex、Claude Code、OpenCode、Antigravity 2.0、Gemini、WorkBuddy 和共享目录。
doctor 检查仓库资产、manifest、用户级安装、Skill 和 Workflow 是否一致。
init 给具体业务项目接入 AI 规则、.ai/ 治理目录、自动 profile 识别和项目上下文草稿。
writing:init 在业务项目中创建标书 / 方案写作 Markdown 工作台,用于写作型 Skill 生成和审核门禁交接。
writing:validate 检查写作工作台的文件链、来源、复用、待补、审核门禁和人工定稿边界。
knowledge:init 创建工程知识治理工作台,用于沉淀 Knowledge Pack。
knowledge:validate 检查知识包文件链、来源、标准、条文、图谱、查询规则和评估问题。
knowledge:compile 将工作台编译为 archsight-aios.knowledge-pack Runtime 资产。
knowledge:lookup 使用本地 Reference Runtime 查询编译后的 Knowledge Pack。
knowledge:eval 执行知识包评估问题,检查引用、版本、拒答、冲突和适用性。
validate 验证项目接入模板能否生成并引用当前登记的 Skills / Workflows。
validate:skills 校验公共 skill 发现入口、frontmatter、跨 host manifest 和 npm metadata 是否一致。
capability:call 按 Capability Registry 权限边界调用本地 MCP Adapter,并输出 Tool Result 与仲裁 Decision。

本地调用 archsight-solver 示例:

$env:ARCHSIGHT_SOLVER_HOME = "<archsight-solver 本地仓库绝对路径>"
npx @archsight/aios capability:call --capability solver.beam_deflection --agent euclid --skill aios-structural --input beam-input.json
npx @archsight/aios capability:call --capability solver.beam_deflection_serviceability_check --agent euclid --skill aios-structural --input beam-serviceability-input.json

如果 archsight-aiosarchsight-solver 是同级目录,CLI 会默认尝试使用相邻的 ../archsight-solver,通常无需设置 ARCHSIGHT_SOLVER_HOME

工程文档写作工作台

v1.4.0 开始,AIOS 提供写作型 Skill 和 Markdown 工作母版,用于标书、技术标、专项施工方案和交底材料的生成 / 改写。Markdown 是 AIOS 工作母版,Word / PDF / PPT 只作为后续交付格式。

在项目目录创建工作台:

npx @archsight/aios writing:init --type tender
npx @archsight/aios writing:init --type scheme --name scheme-workbench
npx @archsight/aios writing:init --type tender --sample --name tender-sample

生成目录默认包含:

  • source-normalized.md:归一化输入资料和来源链。
  • material-index.md:历史素材、复用级别和不可套用原因。
  • writing-brief.md:写作任务、目标章节、禁止结论和人工复核岗位。
  • draft.md:AI 生成或改写的章节草稿。
  • review-notes.md:交给审核 Skill 后的复核记录。
  • final.md:人工确认后的最终 Markdown 母版。

检查工作台完整性:

npx @archsight/aios writing:validate --name document-writing

推荐路由:

  • 招投标通用入口:新用户优先使用 aios-tender;只做复核时使用 aios-tender-audit,写作时使用 aios-tender-write
  • 合同通用入口:只做合同履约复核时使用 aios-contract-audit;草拟补充协议、条款改写、履约通知或函件时使用 aios-contract-draft
  • 施工日报通用入口:新用户优先使用 aios-daily;从口述、项目群记录或照片说明生成日报时使用 aios-daily-write,复核已有日报和问题台账时使用 aios-construction-daily
  • 工程会议通用入口:新用户优先使用 aios-meeting;从录音转写、会议笔记或群聊摘要生成纪要时使用 aios-meeting-write,复核已有纪要和待办闭环时使用 aios-construction-meeting
  • 专项施工方案通用入口:新用户优先使用 aios-scheme;只做复核时使用 aios-scheme-audit,写作时使用 aios-scheme-write
  • 标书 / 技术标写作:先用 aios-tender-write,再交给 aios-tender-audit 审核门禁;已使用 aios-commercial-tender 的团队可继续使用原领域型入口。
  • 合同草拟:先用 aios-contract-draft,再交给 aios-contract-audit 审核门禁;已使用 aios-commercial-contract 的团队可继续使用原领域型入口。
  • 日报 / 会议纪要写作:先用 aios-daily-writeaios-meeting-write,再分别交给 aios-construction-dailyaios-construction-meeting 做证据链和闭环复核。
  • 专项施工方案写作:先用 aios-scheme-write,再交给 aios-scheme-audit 审核门禁;已使用 aios-construction-scheme 的团队可继续使用原领域型入口。

writing:init 只创建缺失文件,重复执行不会覆盖已有工作台内容。

Knowledge Pack 与本地 Reference Runtime

v1.5.0 开始,AIOS 提供工程知识治理能力:把规范摘录、企业标准、项目资料、历史审查口径和人工复核记录治理为可编译、可查询、可评估的 Knowledge Pack

创建合成样板:

npx @archsight/aios knowledge:init --sample --name scheme-review
npx @archsight/aios knowledge:validate --name scheme-review
npx @archsight/aios knowledge:compile --name scheme-review

查询编译产物:

npx @archsight/aios knowledge:lookup --pack scheme-review/compiled/knowledge-pack.json --query "高支模方案是否应检查计算书"
npx @archsight/aios knowledge:eval --name scheme-review

knowledge.norm_lookup 现在有本地 stdio MCP Reference Runtime,可通过 capability:call 走同一套权限、证据和仲裁规则:

npx @archsight/aios capability:call --capability knowledge.norm_lookup --agent vitruvius --skill aios-knowledge --input lookup-input.json

lookup-input.json 至少包含:

{
  "knowledgePackPath": "scheme-review/compiled/knowledge-pack.json",
  "query": "高支模方案是否应检查计算书"
}

Knowledge Pack 不是生产级规范数据库,也不替代法务、总工、专家、审图或注册人员签审。缺来源、缺版本、缺项目条件或存在冲突时,Reference Runtime 必须返回 need_contextnot_foundconflictinapplicable

安装位置

install --target all --scope user 会写入当前用户目录:

  • Codex:~/.codex/skills/~/.codex/workflows/aios/
  • Claude Code:~/.claude/skills/
  • OpenCode:~/.opencode/skills/
  • 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 目录。
  • WorkBuddy:~/.workbuddy/skills/

~/.agents/skills/~/.agents/workflows/aios/ 是可选的通用 Agent 共享目录,不是所有 AI Agent 都会自动读取。需要这类兼容目录时,单独执行:

npx @archsight/aios install --target agents --scope user

WorkBuddy 固定读取个人 skills 目录,可单独安装:

npx @archsight/aios install --target workbuddy --scope user

Claude Code 和 OpenCode 也可以按需单独写入个人 skills 目录:

npx @archsight/aios install --target claude-code --scope user
npx @archsight/aios install --target opencode --scope user

公共发现

AIOS 保留标准 skills/ 目录作为公共发现入口,供 skills.shnpx skills、Antigravity / agy、Gemini CLI extension、Claude Code plugin marketplace、OpenCode、WorkBuddy 和第三方索引器扫描。

npx skills add ArchSightLabs/archsight-aios --list
npx skills add ArchSightLabs/archsight-aios --skill aios-arch --global

跨 host 发现元数据包括根目录 gemini-extension.json.claude-plugin/plugin.json.claude-plugin/marketplace.jsonpackage.jsonagent-skills / skills-sh / gemini-cli 等关键词。公共发现、GitHub topics、索引请求和发布前检查见 公共发现与上架清单

init 默认行为

init 默认使用 --mode auto

  • 新项目或没有 AI 工具入口文件时,创建 AGENTS.mdAI_CODING_RULES.mdCLAUDE.mdGEMINI.mdOPENCODE.md.ai/ 模板文件。
  • 已存在 AGENTS.mdAI_CODING_RULES.mdCLAUDE.mdGEMINI.mdOPENCODE.md 时,创建缺失的 .ai/ 文件,并在 AGENTS.mdCLAUDE.mdGEMINI.mdOPENCODE.md 中追加或刷新 ArchSight AIOS 托管引用块。
  • 默认使用 --profile auto:根据项目名、README、package / pyproject、浅层目录和资料文件名生成 .ai/profile-detection.md,并自动复制高置信度命中的 profile。
  • 首次创建 .ai/project-context.md 时,会自动预填项目名、技术栈、常用命令、代码结构和候选 Skills;重复执行不会覆盖人工修订后的项目上下文。
  • 重复执行不会重复追加托管块,也不会覆盖已有项目规则。
  • 自动模式不修改已有 AI_CODING_RULES.md 正文。

行业边界

建筑行业能力通过 .ai/profile-detection.md、显式 --profile 或明确任务触发。未启用相关 profile 的项目,不应默认加载 BIM、IFC、GraphRAG、审图或建筑规范假设。

如需覆盖自动识别:

npx @archsight/aios init --profile none
npx @archsight/aios init --profile all
npx @archsight/aios init --profile bim-platform

前端应用、后端服务、CLI 工具、数据管道等工程形态优先由 Workflow / Skill / Agent 路由处理,不默认扩展为 profile。只有当某类项目存在稳定的行业语义、证据链、评估集或人工复核差异时,才应考虑新增 profile。

如需强制指定模式:

npx @archsight/aios init --mode full
npx @archsight/aios init --mode linked
npx @archsight/aios init --mode ai-only

本地开发验证

如果是从源码仓库运行,而不是通过 npm 包运行:

npm run install:user
npm run doctor
npm run smoke:project
npm run validate:skills
npx skills add . --list
npm test

核心材料

开源协作

商业边界

  • Apache-2.0 允许商业使用、修改、分发和私有部署;分发时需保留版权声明、许可证文本和必要 NOTICE,并遵守 Apache-2.0 的专利与免责声明条款。
  • 许可证只覆盖本仓库开源内容,不授权 ArchSightLabs / ArchSight 商标、品牌资产、托管服务、专有数据集、客户案例、商业支持、SLA 或任何第三方受限素材。
  • 基于 AIOS 提供商业产品、咨询或二次分发时,不得暗示官方认证、代理、合作或背书;工程结论、合规责任和客户交付责任由使用方自行承担。