AlpacaLabsLLC/skills-for-architects

Arch Studio – 面向建筑事务所的 AI 辅助工作流框架

它是什么

• 一个本地优先的插件（名为 as），为 OpenAI Codex 或 Anthropic Claude Code 环境添加了治理层和持久化的工作室/项目记忆。
• 为常见的建筑-工程-施工（AEC）任务（如分区分析、可持续性检查、FF&E 规范、项目记录管理）提供现成的“技能”（AI 驱动的程序）和“代理”（专家档案）目录。
• 事务所可以在私有工作空间中保留自己的自定义技能，在事务所内共享，或将其贡献回开源仓库。

核心概念

支柱	职责
工作室	账户/访问控制、配置、标准、保障 – 事务所 AI 辅助工作流的控制平面。
工具	实际的技能、专家代理和集成；宿主（Codex/Claude）执行它们。
知识	权威源材料（规范、标准、产品数据）的链接和来源追踪。
记忆	存储在本地工作室/项目文件中的持久事实、决策、偏好和证据。

组织结构

• corpus/ – 源代码导航和功能发现。
• tools/ – 维护者工具。
• skills/ – 捆绑的参考技能（例如 spec-writer、product-cut-sheet）。
• agents/ – 专家代理定义（现场规划师、分区专家、可持续性专家等）。
• studio/ – 用户拥有的工作空间，包含企业级（.agents/skills/）和项目级（<project>/.agents/skills/）自定义技能。

安装与首次使用

• Codex：添加 Git 市场，安装 as@skills-for-architects，然后运行 codex 并调用 $studio。
• Claude Code：通过 Claude 市场安装，然后运行 /as:studio。
• 插件在用户批准目标目录之前不会创建任何文件，从而确保设置完全本地化并受事务所控制。

典型工作流

1. 启动工作室（$studio / /as:studio）以配置账户、标准和默认策略。
2. 让代理执行任务（例如 Norma）：/as:norma task chair, mesh back, under $800。
3. 直接调用技能（如果愿意）：$environmental-analysis 123 Main St（Codex）或 /as:environmental-analysis 123 Main St（Claude）。
4. 创建自定义技能（/as:skill-maker）；工具会根据事务所的治理策略进行验证，并将技能写入相应的工作空间层。
5. 持久化记录 – 工作室会自动创建 CSV 文件（DOCUMENTS.csv、TASKS.csv、INVOICES.csv 等）用于项目簿记。

捆绑的代理和技能

• 代理：现场规划师、纽约市分区专家、工作场所策略师、产品和材料研究员、FF&E 设计师、可持续性专家、品牌经理，以及可选的协调员“Norma”。
• 技能组涵盖事务所运营（调度员、学习）、项目管理（记录、工作计划、发票）、专业实践（AIA 词汇、CSI/NCS 参考）和设计任务（尽职调查、分区、规划、规范、可持续性、FF&E、演示）。
• 技能入口点示例：spec-writer、product-cut-sheet、ffe-spec-book、epd-to-spec。

可扩展性

• 工作室级技能位于 studio/.agents/skills/（Claude 为 .claude/skills/），代表事务所级标准。
• 项目级技能位于每个项目的 .agents/skills/ 目录下，用于特定客户流程。
• 可以向上游提交贡献以丰富共享目录。

为何重要

• 弥合了大型语言模型助手与高度监管、文档密集型建筑领域之间的差距。
• 将所有数据保留在本地，满足无法将专有图纸或合同暴露给云服务的事务所。
• 提供了一种可重用的开源模式，用于构建 AI 增强的 AEC 管道，而无需为每个任务编写自定义代码。

---

TL;DR：Arch Studio 是一个开源插件，让建筑事务所能够将 Codex 或 Claude Code 作为智能助手运行，提供现成的 AI 技能和专家代理库、本地治理层，以及一种简单的方法来创建事务所特定的工作流，同时将所有数据置于事务所的控制之下。