@archsight/aios 1.0.0

package/delivery/README.md

@@ -0,0 +1,13 @@
+# Delivery
+
+`delivery/` 保存受控交付体系。
+
+推荐内容：
+
+- [发布清单](release-checklist.md)
+- [AI 生成代码检查](ai-generated-code-checklist.md)
+- [回滚策略](rollback-policy.md)
+- 自动测试
+- 自动修复
+- 人工确认
+- 风险控制

package/delivery/ai-generated-code-checklist.md

@@ -0,0 +1,15 @@
+# AI Generated Code Checklist
+
+## 必查项
+
+- [ ] 每个改动都对应明确需求。
+- [ ] 没有无关重构或格式化。
+- [ ] 没有新增未请求依赖。
+- [ ] 没有扩大权限、文件范围或网络访问。
+- [ ] 关键路径有测试或人工验证。
+- [ ] 错误处理没有吞掉真实失败。
+
+## Review 关注
+
+AI 生成内容优先检查边界、正确性、安全和测试缺口。风格建议只能作为 P3，不得阻断交付。
+

package/delivery/release-checklist.md

@@ -0,0 +1,23 @@
+# Release Checklist
+
+## 发布前
+
+- [ ] 发布范围已冻结。
+- [ ] 变更摘要已写清。
+- [ ] `npm test` 或项目等价测试已通过。
+- [ ] `doctor` / `smoke` 等治理检查已通过。
+- [ ] 如涉及 UAT、试运行确认、领导演示或客户验收，已完成 `quality-readiness` QA 准入检查。
+- [ ] Review 无 P0 / P1。
+- [ ] 回滚路径已确认。
+
+## 发布中
+
+- [ ] 使用受控命令执行发布。
+- [ ] 不手工修改未记录配置。
+- [ ] 记录版本号、commit、操作者和时间。
+
+## 发布后
+
+- [ ] 执行冒烟验证。
+- [ ] 记录已知风险。
+- [ ] 如失败，按 `rollback-policy.md` 回退。

package/delivery/rollback-policy.md

@@ -0,0 +1,26 @@
+# Rollback Policy
+
+## 目标
+
+每次交付都必须知道如何撤回。回滚策略是发布条件，不是事故后补救。
+
+## 回滚方式
+
+| 类型 | 推荐方式 |
+| --- | --- |
+| 文档 / Prompt / Workflow | Git revert |
+| CLI / 脚本 | 回退版本或撤回发布 |
+| 配置 | 恢复上一版配置并记录差异 |
+| 数据迁移 | 使用预先验证的反向迁移或备份恢复 |
+
+## 记录字段
+
+```text
+变更：
+版本 / commit：
+触发条件：
+回滚命令：
+验证方式：
+负责人：
+```
+

package/docs/ai-engineering-squad-plan.md

@@ -0,0 +1,506 @@
+# AI Engineering Squad 计划
+
+> 面向建筑行业数字化、AI 研发平台与行业知识工程的多智能体协同体系设计
+
+状态：规划基线  
+版本：0.1  
+日期：2026-05-07  
+维护方：ArchSightLabs
+
+相关文档：
+
+- [AI Team OS 仓库架构](ai-team-os-repository-architecture.md)
+
+---
+
+## 文档定位
+
+本文件定义 ArchSight AIOS 的 AI Engineering Squad 角色体系。该体系由 ArchSightLabs 发起，但角色契约应能被其他接入项目复用。
+
+它回答的问题是：
+
+- 应该有哪些核心 Agent。
+- 每个 Agent 负责什么、不负责什么。
+- Agent 之间如何分层协作。
+- 哪些角色属于第一阶段核心马队，哪些属于第二阶段扩展角色。
+
+本文件不负责规定仓库目录、runtime 配置、prompt 存放方式和治理目录结构。这些内容以 [AI Team OS 仓库架构](ai-team-os-repository-architecture.md) 为准。
+
+---
+
+## 一、总体定位
+
+当前目标并不是构建“聊天机器人集合”。
+
+而是：
+
+> 一个面向建筑行业数字化与 AI 工程研发的多智能体协同组织（AI Engineering Squad）。
+
+核心方向包括：
+
+- 建筑行业平台研发
+- BIM / IFC 标准体系
+- ArchSight 行业知识平台
+- GraphRAG / 行业知识图谱
+- AI Coding 工作流
+- 多模型协同研发
+- Agent 工程体系
+- 规范审查与智能审图
+- 结构力学求解器
+- 企业级 AI 研发平台
+
+---
+
+## 二、整体组织结构
+
+建议将 Hermes / OpenClaw Agent 体系划分为四层：
+
+| 层级 | 职责定位 | 是否核心 |
+| --- | --- | --- |
+| 战略层 | 架构、路线、治理、评审 | 核心 |
+| 产品层 | 行业知识、业务抽象、规范体系 | 核心 |
+| 工程层 | 开发、测试、交付、自动化 | 核心 |
+| 知识层 | BIM / IFC / GraphRAG / 标准体系 | 极核心 |
+
+---
+
+## 三、核心马队（第一阶段）
+
+这是建议优先长期保留的六个核心 Agent。
+
+它们共同构成：
+
+> 一个最小可运行的 AI 软件研发组织。
+
+### 1. Atlas（总架构师）
+
+中文定位：总架构师 / 技术战略官
+
+核心职责：
+
+- 系统架构设计
+- 服务边界划分
+- 技术选型
+- 平台演进路线
+- 多 Agent 协同治理
+- 技术债控制
+- 长期复杂度治理
+
+角色特征：
+
+> CTO 型 Agent
+
+重点不是写代码，而是审方案、做 tradeoff、控复杂度、规划长期演进。
+
+适用场景：
+
+- ArchSight 服务拆分
+- GraphRAG 架构设计
+- Neo4j 是否合理
+- pgvector + FTS 协同方案
+- React / Vue 技术路线
+- Agent Workflow 治理
+- BIM 标准模块边界
+
+### 2. Mason（工程总工）
+
+中文定位：工程总工 / 研发负责人
+
+核心职责：
+
+- 研发任务拆解
+- Sprint 管理
+- 模块依赖治理
+- Monorepo 管理
+- 工程目录结构
+- CI/CD 设计
+- 开发规范
+- PR Review 流程
+
+角色特征：
+
+> 工程组织型 Agent
+
+Atlas 决定是否应该做，Mason 决定如何组织团队做完。
+
+重点能力：
+
+- Monorepo
+- Workspace
+- Docker
+- API Boundary
+- Gateway
+- DevContainer
+- Frontend / Backend Split
+- AI Coding Workflow
+
+### 3. Argus（代码审查官）
+
+中文定位：代码审查官 / 质量卫士
+
+核心职责：
+
+- Code Review
+- 安全审计
+- 性能问题识别
+- 架构反模式分析
+- Prompt 注入风险
+- 依赖风险
+- Agent 失控风险
+- 重复代码识别
+
+角色特征：
+
+> AI 时代的质量守门员
+
+重点不是生产代码，而是阻止 AI 制造大型技术债。
+
+适用场景：
+
+- Codex
+- Gemini
+- Claude Code
+- OpenCode
+- Kimi
+- DeepSeek
+- 其他多模型协同研发环境
+
+### 4. Vitruvius（建筑数字化专家）
+
+中文定位：建筑数字化专家
+
+来源：Vitruvius
+
+核心职责：
+
+- BIM
+- IFC
+- 建筑规范
+- 行业术语
+- 工程数据体系
+- 招采业务
+- 交付标准
+- 审图逻辑
+
+角色特征：
+
+> 行业知识编译器（Knowledge Compiler）
+
+重点能力：
+
+- 规范结构化
+- 条文抽取
+- 规则约束
+- 知识关联
+- 冲突检测
+- 审查逻辑构建
+
+长期方向：
+
+- BIM 审查 Agent
+- 规范合规审查 Agent
+- 招投标审查 Agent
+- IFC 数据校验 Agent
+
+### 5. Daedalus（AI 研发工程师）
+
+中文定位：AI 研发工程师
+
+核心职责：
+
+- Prompt Engineering
+- Context Engineering
+- Agent Workflow
+- RAG / GraphRAG
+- Embedding
+- MCP
+- Tool Calling
+- Multi-Agent Orchestration
+
+角色特征：
+
+> AI Runtime 工程专家
+
+Atlas 负责系统整体架构，Daedalus 负责 AI Runtime 体系。
+
+重点方向：
+
+- Hermes / OpenClaw 协同
+- Context 裁剪
+- Memory 管理
+- Skill 编排
+- Tool 治理
+- 上下文防爆炸
+- Agent 状态治理
+
+### 6. Hephaestus（受控执行官）
+
+中文定位：受控执行官 / 自动化工匠
+
+核心职责：
+
+- 自动生成代码
+- 自动修复问题
+- 自动改 UI
+- 自动生成文档
+- 自动执行脚本
+- 自动部署
+- 自动测试
+
+角色特征：
+
+> 真正干活的执行型 Agent
+
+类似 Codex、Claude Code、OpenHands、Devin 这一类执行型 AI。
+
+---
+
+## 四、核心体系覆盖能力
+
+| 能力方向 | Agent |
+| --- | --- |
+| 架构治理 | Atlas |
+| 工程管理 | Mason |
+| 质量控制 | Argus |
+| 行业知识 | Vitruvius |
+| AI 系统工程 | Daedalus |
+| 自动执行 | Hephaestus |
+
+---
+
+## 五、第二阶段扩展 Agent
+
+在核心马队稳定后，再逐步扩展专业兵种。
+
+### 1. Euclid（结构力学专家）
+
+中文定位：结构分析专家
+
+方向：
+
+- 梁系分析
+- 桁架分析
+- FEM
+- 刚度矩阵
+- 荷载分析
+- 数值求解
+
+长期目标：
+
+- ArchSight Solver
+- 结构力学求解器
+- Web FEM 平台
+
+### 2. Athena（知识治理官）
+
+中文定位：知识治理官
+
+方向：
+
+- 标准体系治理
+- 文档结构
+- 版本管理
+- 知识图谱治理
+- 数据血缘
+- 条文差异分析
+
+适用方向：
+
+- BIM 标准体系
+- IFC 标准治理
+- 规范修订管理
+
+### 3. Mercury（AI 情报官）
+
+中文定位：AI 情报官
+
+方向：
+
+- AI 行业资讯
+- GitHub 趋势
+- MCP 生态
+- Agent 工程生态
+- 开源项目分析
+- 模型能力跟踪
+
+适用方向：
+
+- 每日 AI 情报推送
+- 技术趋势分析
+- 新工具评估
+
+### 4. Janus（产品策略官）
+
+中文定位：产品策略官
+
+方向：
+
+- SaaS 架构
+- 商业模式
+- MVP 边界
+- 用户分层
+- 平台路线
+- 行业化路径
+
+适用方向：
+
+- 工程猿平台
+- ArchSight 商业化
+- AI 平台产品化
+
+---
+
+## 六、建议避免的问题
+
+### 1. 避免人格秀
+
+不要构建：
+
+- 苏格拉底
+- 爱因斯坦
+- 马斯克
+- 孙悟空
+
+这类人格化聊天机器人。
+
+原因：
+
+> 缺乏工程生产力。
+
+### 2. 避免角色重叠
+
+不要同时存在：
+
+- CTO
+- 技术总监
+- 架构专家 A
+- 架构专家 B
+
+这会导致：
+
+- 上下文冲突
+- 职责模糊
+- Agent 内耗
+
+### 3. 避免所有 Agent 都写代码
+
+否则：
+
+- 无治理
+- 无评审
+- 无边界
+- 无质量控制
+
+最终会让 AI 生成大型技术债。
+
+---
+
+## 七、长期方向
+
+当前探索的并不是：
+
+> “AI 辅助写代码”
+
+而是：
+
+> “AI 工程组织系统”
+
+即：
+
+> AI Team Operating System
+
+---
+
+## 八、长期核心能力
+
+当前已经具备的方向包括：
+
+- Skills
+- OMX / OMCC
+- Spec Kit
+- gstack
+- 多模型协同
+- Hermes / OpenClaw
+- GraphRAG
+- 受控交付
+- Agent Workflow
+- Context Engineering
+
+这些共同指向：
+
+> AI 时代的软件研发组织形态。
+
+---
+
+## 九、当前仓库落地结构
+
+当前已采用 `archsight-aios` 作为 AI Team OS 仓库，不再建议为第一阶段核心马队另建一个只保存 prompt 的独立仓库。
+
+Agent 角色资产采用三层管理：
+
+| 层 | 内容 | 作用 |
+| --- | --- | --- |
+| Source | `role.md` / `responsibilities.md` / `constraints.md` / `workflow.md` | 长期维护、沉淀角色资产 |
+| Runtime | `system-prompt.md` | Hermes 创建 Agent 时直接使用 |
+| Instance | Hermes / 飞书机器人 | 实际对话入口 |
+
+第一阶段核心 Agent 在仓库中的结构为：
+
+```text
+archsight-aios/
+├── agents/
+│   ├── atlas/
+│   │   ├── role.md
+│   │   ├── responsibilities.md
+│   │   ├── constraints.md
+│   │   ├── workflow.md
+│   │   └── system-prompt.md
+│   ├── mason/
+│   ├── argus/
+│   ├── vitruvius/
+│   ├── daedalus/
+│   └── hephaestus/
+├── workflows/
+├── runtime/
+├── governance/
+├── knowledge/
+└── docs/
+```
+
+---
+
+## 十、推荐仓库名称
+
+建议优先考虑：
+
+- `ai-engineering-squad`
+- `archsight-agents`
+- `archsight-ai-team`
+- `archsight-agent-system`
+- `ai-team-os`
+- `archsight-runtime`
+- `archsight-labs-agents`
+
+其中最推荐：
+
+> `archsight-ai-team`
+
+原因：
+
+- 兼顾品牌
+- 兼顾行业
+- 兼顾 Agent
+- 兼顾未来组织化方向
+- 不局限于单一工具链
+
+---
+
+## 十一、维护原则
+
+这份文档作为 AI 马队建设的初始规划基线。后续修改应遵循：
+
+- 先更新职责边界，再扩展 Agent 数量。
+- 先沉淀工作流，再固化 Prompt 或 Skill。
+- 先验证核心六人组，再引入第二阶段扩展角色。
+- 每个 Agent 都应有清晰职责、输入输出、适用场景和禁止事项。
+- 避免以人格魅力替代工程生产力。