@archsight/aios 1.0.1 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (60) hide show
  1. package/.claude-plugin/marketplace.json +60 -0
  2. package/.claude-plugin/plugin.json +36 -0
  3. package/CHANGELOG.md +74 -2
  4. package/LICENSE +184 -21
  5. package/README.md +90 -39
  6. package/RELEASE_NOTES.md +27 -0
  7. package/adapters/README.md +7 -0
  8. package/adapters/workbuddy/README.md +43 -0
  9. package/agents/README.md +2 -1
  10. package/agents/euclid/constraints.md +2 -1
  11. package/agents/euclid/responsibilities.md +1 -1
  12. package/agents/euclid/role.md +1 -1
  13. package/agents/euclid/system-prompt.md +5 -2
  14. package/agents/euclid/workflow.md +3 -3
  15. package/bin/archsight-aios.mjs +489 -11
  16. package/docs/PUBLIC_DISCOVERY.md +193 -0
  17. package/docs/quickstart.md +2 -1
  18. package/gemini-extension.json +6 -0
  19. package/governance/README.md +3 -0
  20. package/governance/arbitration-protocol.md +153 -0
  21. package/package.json +52 -31
  22. package/runtime/README.md +7 -0
  23. package/runtime/agent-routing.md +41 -17
  24. package/runtime/archsight-aios.manifest.json +166 -61
  25. package/runtime/capability-adapters.json +27 -0
  26. package/runtime/capability-registry.json +468 -0
  27. package/runtime/capability-registry.schema.json +135 -0
  28. package/runtime/skill-routing.md +26 -13
  29. package/scripts/validate-skills.mjs +134 -0
  30. package/skills/README.md +25 -9
  31. package/skills/aios-arch/SKILL.md +62 -24
  32. package/skills/aios-ceo/SKILL.md +11 -8
  33. package/skills/aios-commercial-contract/SKILL.md +89 -0
  34. package/skills/aios-commercial-contract/agents/openai.yaml +4 -0
  35. package/skills/aios-commercial-tender/SKILL.md +89 -0
  36. package/skills/aios-commercial-tender/agents/openai.yaml +4 -0
  37. package/skills/aios-commercial-variation/SKILL.md +88 -0
  38. package/skills/aios-commercial-variation/agents/openai.yaml +4 -0
  39. package/skills/aios-construction-daily/SKILL.md +86 -0
  40. package/skills/aios-construction-daily/agents/openai.yaml +4 -0
  41. package/skills/aios-construction-meeting/SKILL.md +86 -0
  42. package/skills/aios-construction-meeting/agents/openai.yaml +4 -0
  43. package/skills/aios-construction-scheme/SKILL.md +79 -0
  44. package/skills/aios-construction-scheme/agents/openai.yaml +4 -0
  45. package/skills/aios-exec/SKILL.md +11 -8
  46. package/skills/aios-knowledge/SKILL.md +12 -9
  47. package/skills/aios-plan/SKILL.md +38 -28
  48. package/skills/aios-review/SKILL.md +12 -9
  49. package/skills/aios-runtime/SKILL.md +14 -11
  50. package/skills/aios-structural/SKILL.md +67 -0
  51. package/skills/aios-structural/agents/openai.yaml +4 -0
  52. package/templates/project-ai/.ai/ARCHSIGHT_AIOS_RULES.md +13 -10
  53. package/templates/project-ai/.ai/agent-routing.md +17 -12
  54. package/templates/project-ai/.ai/skills.md +28 -11
  55. package/templates/project-ai/.ai/workflows.md +13 -9
  56. package/workflows/README.md +5 -0
  57. package/workflows/architecture-review.md +44 -22
  58. package/workflows/feature-development.md +25 -19
  59. package/workflows/rag-pipeline.md +9 -5
  60. package/workflows/site-daily-loop.md +101 -0
@@ -15,16 +15,18 @@
15
15
  | 类型 | 含义 |
16
16
  | --- | --- |
17
17
  | Agent | 谁来做 |
18
- | Skill | 怎么做 |
19
- | Workflow | 什么时候做、按什么顺序做 |
20
- | Runtime | 在哪里运行 |
18
+ | Skill | 怎么做 |
19
+ | Workflow | 什么时候做、按什么顺序做 |
20
+ | Runtime | 在哪里运行 |
21
+ | Capability | 用什么确定性工具或结构化知识提供证据 |
21
22
 
22
23
  ## 泛化边界
23
24
 
24
25
  - 当前项目事实优先于 AIOS 通用角色说明。
25
26
  - Hermes、飞书、OpenClaw、Codex、Claude、Gemini 等都是可选运行入口;未启用时不得写入项目假设。
26
- - 建筑、BIM、IFC、规范、审图和 RAG / GraphRAG 知识工程能力通过 profile 或明确任务触发;普通项目不默认启用这些语义。
27
- - AIOS 是建筑行业增强层;普通非建筑任务优先使用宿主工具的通用能力,不因为安装了 AIOS 就强制套用 `aios-*` Skill。
27
+ - 建筑、BIM、IFC、规范、审图和 RAG / GraphRAG 知识工程能力通过 profile 或明确任务触发;普通项目不默认启用这些语义。
28
+ - AIOS 是建筑行业增强层;普通非建筑任务优先使用宿主工具的通用能力,不因为安装了 AIOS 就强制套用 `aios-*` Skill。
29
+ - 冲突仲裁按证据等级处理:人类硬约束、确定性工具、项目事实、结构化知识优先于 Agent 自然语言判断。
28
30
 
29
31
  ## 默认任务路由
30
32
 
@@ -34,10 +36,11 @@
34
36
  | 建筑行业平台 UI / UX 设计方案、工作台体验、前端实现交接 | Janus | 产品策略官 |
35
37
  | 建筑行业项目架构评审、技术选型、服务边界 | Atlas | 总架构师 |
36
38
  | 建筑行业项目任务拆解、交付顺序、CI/CD | Mason | 工程总工 |
37
- | 建筑行业项目 Code Review、安全、性能、技术债 | Argus | 代码审查官 |
38
- | BIM、IFC、建筑规范、审图逻辑 | Vitruvius | 建筑数字化专家 |
39
- | 建筑行业 RAG、GraphRAG、MCP、Memory、Tool Calling | Daedalus | AI 研发工程师 |
40
- | 建筑行业项目代码修改、脚本执行、测试、文档生成 | Hephaestus | 受控执行官 |
39
+ | 建筑行业项目 Code Review、安全、性能、技术债 | Argus | 代码审查官 |
40
+ | BIM、IFC、建筑规范、审图逻辑 | Vitruvius | 建筑数字化专家 |
41
+ | 结构力学、荷载、FEM、结构计算工具链 | Euclid | 结构力学专家 |
42
+ | 建筑行业 RAG、GraphRAG、MCP、Memory、Tool Calling | Daedalus | AI 研发工程师 |
43
+ | 建筑行业项目代码修改、脚本执行、测试、文档生成 | Hephaestus | 受控执行官 |
41
44
 
42
45
  ## 升级规则
43
46
 
@@ -46,6 +49,8 @@
46
49
  - 涉及页面方案、工作台体验、交互状态和前端实现交接:升级给 Janus,并使用 `aios-design`。
47
50
  - 涉及多模块交付、任务依赖、发布顺序:升级给 Mason。
48
51
  - 涉及权限、安全、生产发布、AI 生成代码:升级给 Argus。
49
- - 涉及行业规范、BIM / IFC、审图语义:升级给 Vitruvius。
50
- - 涉及 RAG、GraphRAG、MCP、Memory、Tool:升级给 Daedalus
51
- - 具体实现和验证:交给 Hephaestus
52
+ - 涉及行业规范、BIM / IFC、审图语义:升级给 Vitruvius。
53
+ - 涉及结构力学、荷载、边界条件、FEM 或结构计算工具链:升级给 Euclid
54
+ - 涉及 RAG、GraphRAG、MCP、Memory、Tool:升级给 Daedalus
55
+ - 具体实现和验证:交给 Hephaestus。
56
+ - Capability 返回阻断结果、证据缺失或工具不可用:停止执行并输出 `Claim / Evidence / Tool Result / Decision`。
@@ -16,10 +16,17 @@ AIOS 是建筑行业增强层,不是通用任务替代器。只有当前项目
16
16
  | 建筑行业平台 UI / UX 设计方案 / 工作台体验 | `aios-design` | Janus |
17
17
  | 建筑行业项目架构评审 | `aios-arch` | Atlas |
18
18
  | 建筑行业项目交付计划 | `aios-plan` | Mason |
19
- | 建筑行业项目代码审查 | `aios-review` | Argus |
20
- | BIM / IFC / 建筑知识建模 | `aios-knowledge` | Vitruvius |
21
- | 建筑行业 AI Runtime / RAG / MCP / Memory | `aios-runtime` | Daedalus |
22
- | 建筑行业项目受控实现 / 测试 / 文档 / 脚本 | `aios-exec` | Hephaestus |
19
+ | 建筑行业项目代码审查 | `aios-review` | Argus |
20
+ | BIM / IFC / 建筑知识建模 | `aios-knowledge` | Vitruvius |
21
+ | 结构力学 / 荷载 / FEM / 确定性求解链路 | `aios-structural` | Euclid |
22
+ | 建筑行业 AI Runtime / RAG / MCP / Memory | `aios-runtime` | Daedalus |
23
+ | 建筑行业项目受控实现 / 测试 / 文档 / 脚本 | `aios-exec` | Hephaestus |
24
+ | 工程招投标响应 / 评分点 / 废标风险 / 技术标资料矩阵 | `aios-commercial-tender` | Mason |
25
+ | 工程合同履约节点 / 付款条件 / 责任边界 / 资料缺口 | `aios-commercial-contract` | Argus |
26
+ | 施工日报 / 现场异常 / 项目群记录 / 问题追踪台账 | `aios-construction-daily` | Mason |
27
+ | 工程会议纪要 / 待办闭环 / 遗留争议 / 下次追踪 | `aios-construction-meeting` | Mason |
28
+ | 工程变更签证资料链 / 联系单 / 图纸变更 / 索赔线索 | `aios-commercial-variation` | Argus |
29
+ | 专项施工方案 / 危险源 / 交底要点 / 规范和计算书复核 | `aios-construction-scheme` | Vitruvius |
23
30
 
24
31
  ## 本项目启用的 Skills
25
32
 
@@ -27,16 +34,26 @@ AIOS 是建筑行业增强层,不是通用任务替代器。只有当前项目
27
34
  - [ ] `aios-ceo`
28
35
  - [ ] `aios-design`
29
36
  - [ ] `aios-plan`
30
- - [ ] `aios-review`
31
- - [ ] `aios-knowledge`
32
- - [ ] `aios-runtime`
33
- - [ ] `aios-exec`
37
+ - [ ] `aios-review`
38
+ - [ ] `aios-knowledge`
39
+ - [ ] `aios-structural`
40
+ - [ ] `aios-runtime`
41
+ - [ ] `aios-exec`
42
+ - [ ] `aios-commercial-tender`
43
+ - [ ] `aios-commercial-contract`
44
+ - [ ] `aios-construction-daily`
45
+ - [ ] `aios-construction-meeting`
46
+ - [ ] `aios-commercial-variation`
47
+ - [ ] `aios-construction-scheme`
34
48
 
35
49
  ## 启用规则
36
50
 
37
51
  - 只勾选当前项目真实安装或可访问的 Skill。
38
52
  - 涉及建筑行业软件 / 系统评价、项目立项、产品定位、商业目标、范围取舍或阶段路线时,优先启用 `aios-ceo`。
39
53
  - 涉及建筑行业平台 UI / UX 方案、工作台体验、交互状态、响应式或前端实现交接时,优先启用 `aios-design`。
40
- - 只有启用建筑、BIM、IFC、规范知识库、GraphRAG 或智能审图 profile 时,才默认启用 `aios-knowledge`。
41
- - 当前任务不涉及建筑行业语义时,不要为了“已安装 AIOS”而强制使用 `aios-*` Skill。
42
- - Skill 来源、安装位置或同步方式无法确认,应标注待核验,不要假设已经启用。
54
+ - 只有启用建筑、BIM、IFC、规范知识库、GraphRAG 或智能审图 profile 时,才默认启用 `aios-knowledge`。
55
+ - 涉及结构力学、荷载、FEM、结构计算工具链或工程安全风险时,启用 `aios-structural`;关键数值必须来自确定性求解器或项目已有计算书。
56
+ - 涉及工程招投标、合同履约、施工日报、工程会议、变更签证或专项施工方案时,可按资料类型启用工程业务管理 Skill;这些 Skill 只做证据链整理和人工复核分流,不替代正式签审。
57
+ - 涉及规范、制度、结构计算、质量安全、金额、工期索赔或责任归属时,必须保留 `Claim / Evidence / Tool Result / Decision`;没有工具或人工证据时标注 `Need verify` 或 `Hold for human`。
58
+ - 当前任务不涉及建筑行业语义时,不要为了“已安装 AIOS”而强制使用 `aios-*` Skill。
59
+ - 如 Skill 来源、安装位置或同步方式无法确认,应标注待核验,不要假设已经启用。
@@ -19,18 +19,21 @@ AIOS Workflow 是建筑行业项目的增强路径,不是普通工程任务的
19
19
  | 建筑行业平台 UI / UX 方案评审 | `design-review` |
20
20
  | UAT / 试运行确认 / 演示前质量门禁 | `quality-readiness` |
21
21
  | RAG / GraphRAG 知识链路 | `rag-pipeline` |
22
- | 发布前检查 | `release` |
23
- | 前端生成 | `frontend-generation` |
22
+ | 发布前检查 | `release` |
23
+ | 前端生成 | `frontend-generation` |
24
+ | 施工日报、工程会议、现场异常和变更签证线索每日闭环 | `site-daily-loop` |
24
25
 
25
26
  ## 执行要求
26
27
 
27
28
  - 先明确输入和验收标准。
28
29
  - 再选择 Workflow。
29
- - 再调用对应 Skill。
30
- - 最后用测试、构建、lint、typecheck 或人工检查验证。
31
- - 涉及建筑行业、BIM、IFC、规范、审图或 RAG / GraphRAG 时,先确认项目是否启用对应 profile。
32
-
33
- ## 本项目默认流程
30
+ - 再调用对应 Skill。
31
+ - 最后用测试、构建、lint、typecheck 或人工检查验证。
32
+ - 涉及建筑行业、BIM、IFC、规范、审图或 RAG / GraphRAG 时,先确认项目是否启用对应 profile。
33
+ - 涉及规范检查、结构计算、安全扫描、测试门禁或 Agent 冲突时,输出 `Claim / Evidence / Tool Result / Decision`;工具证据缺失时不得标记为已验证。
34
+ - 涉及施工日报、会议纪要、联系单或变更签证线索时,使用 `site-daily-loop` 并保留 Source Map、Evidence 和人工复核结论。
35
+
36
+ ## 本项目默认流程
34
37
 
35
38
  待填写:
36
39
 
@@ -38,5 +41,6 @@ AIOS Workflow 是建筑行业项目的增强路径,不是普通工程任务的
38
41
  - Bug:
39
42
  - Review:
40
43
  - Quality readiness / UAT / 试运行确认:
41
- - Release:
42
- - RAG / GraphRAG:
44
+ - Release:
45
+ - RAG / GraphRAG:
46
+ - Site daily loop:
@@ -16,4 +16,9 @@
16
16
  - [RAG / GraphRAG pipeline](rag-pipeline.md)
17
17
  - spec driven development
18
18
 
19
+ **工程业务管理 (Business Execution):**
20
+ - [现场协同与日常管理闭环](site-daily-loop.md)
21
+
19
22
  每个 workflow 应明确参与角色、输入、输出、执行顺序、验收标准和回滚策略。
23
+
24
+ 涉及多 Agent 冲突、规范证据、结构计算、安全扫描、测试门禁或 Runtime 权限时,Workflow 还应输出 `Claim / Evidence / Tool Result / Decision`,并按 [Capability-Backed Arbitration Protocol](../governance/arbitration-protocol.md) 仲裁。
@@ -18,19 +18,21 @@
18
18
  | 阶段 | 主 Agent | Skill |
19
19
  | --- | --- | --- |
20
20
  | 架构判断 | Atlas | `aios-arch` |
21
- | 工程拆解 | Mason | `aios-plan` |
22
- | Runtime 设计 | Daedalus | `aios-runtime` |
23
- | 行业语义 | Vitruvius | `aios-knowledge` |
24
- | 风险审查 | Argus | `aios-review` |
21
+ | 工程拆解 | Mason | `aios-plan` |
22
+ | Runtime 设计 | Daedalus | `aios-runtime` |
23
+ | 行业语义 | Vitruvius | `aios-knowledge` |
24
+ | 结构力学 / 求解链路 | Euclid | `aios-structural` |
25
+ | 风险审查 | Argus | `aios-review` |
25
26
 
26
27
  ## 输入
27
28
 
28
29
  - 背景和目标。
29
30
  - 当前架构、目录、模块和数据结构。
30
31
  - 现有代码、配置、接口契约、测试、脚本、部署入口和运行方式。
31
- - 候选方案。
32
- - 约束:成本、时间、团队、运行环境、权限、数据规模。
33
- - 已知风险和历史决策。
32
+ - 候选方案。
33
+ - 约束:成本、时间、团队、运行环境、权限、数据规模。
34
+ - 已知风险和历史决策。
35
+ - 可用 Capability、工具返回值、测试 / 构建 / 规范查询 / 求解器证据。
34
36
 
35
37
  ## 执行顺序
36
38
 
@@ -40,11 +42,14 @@
40
42
  4. Atlas 盘点已有能力,确认应复用的模块、契约、测试和脚本。
41
43
  5. Atlas 做端到端链路抽样:对关键用户输入、配置字段、领域元数据、版本关系、审计关系或跨存储关系,至少追踪一条从 UI / API / CLI 入口到领域模型、后台任务、存储、检索/消费端和测试的完整路径。
42
44
  6. Atlas 对候选方案做 tradeoff,识别复杂度、技术债、生产失效方式和长期迁移成本。
43
- 7. Atlas 用 P0/P1/P2 或等效等级标注风险优先级,形成架构依据。
44
- 8. Daedalus 评审 AI Runtime / RAG / Tool / Memory 相关设计。
45
- 9. Vitruvius 评审 BIM / IFC / 建筑规范相关语义。
46
- 10. Argus 评审安全、权限、Prompt 注入、依赖和发布风险。
47
- 11. Mason 将通过评审的方案拆成可执行任务,并纳入 Failure Modes、测试缺口、并行 workstream 和冲突点。
45
+ 7. Atlas 用 P0/P1/P2 或等效等级标注风险优先级,形成架构依据。
46
+ 8. Daedalus 评审 AI Runtime / RAG / Tool / Memory 相关设计。
47
+ 9. Vitruvius 评审 BIM / IFC / 建筑规范相关语义。
48
+ 10. Euclid 评审结构力学、荷载、边界条件、FEM 或求解器接口相关问题;关键数值必须来自确定性求解器或标记 `Need verify`。
49
+ 11. Argus 评审安全、权限、Prompt 注入、依赖和发布风险。
50
+ 12. 对 Agent 冲突输出 `Claim / Evidence / Tool Result / Decision`,按 `governance/arbitration-protocol.md` 仲裁。
51
+ 13. Atlas 做交付审查增强:列出本次事实刷新、历史报告过期判断、与既有报告 diff、领域风险 / 工程风险分类,以及每个高优先级发现的文件落点和验证方式。
52
+ 14. Mason 将通过评审的方案拆成可执行任务,并纳入 Failure Modes、测试缺口、并行 workstream 和冲突点。
48
53
 
49
54
  ## 输出
50
55
 
@@ -52,10 +57,14 @@
52
57
  2. 架构判断
53
58
  3. 风险与边界
54
59
  4. 推荐方案
55
- 5. Rejected 方案
56
- 6. Assumption / Need verify
57
- 7. Failure Modes
58
- 8. 后续执行任务
60
+ 5. Rejected 方案
61
+ 6. Assumption / Need verify
62
+ 7. Failure Modes
63
+ 8. Claim / Evidence / Tool Result / Decision
64
+ 9. 后续执行任务
65
+ 10. 本次事实刷新
66
+ 11. 已过期判断 / 与既有报告 diff
67
+ 12. 第一小步建议
59
68
 
60
69
  ## 文档与补充检查
61
70
 
@@ -67,9 +76,21 @@
67
76
  - 工程计划优先采纳 Failure Modes、测试缺口、并行 workstream、冲突标记和回归命令。
68
77
  - 纠正文档中的细节错误,例如 Assumption 与 Need verify 数量混淆。
69
78
  - 对“未覆盖”的判断要谨慎:如果已有评审已触及某风险但未形成完整策略,应写成“已触及但未系统展开”。
70
- - 如果本次是“全新独立评审”,仍应建立历史高优先级发现的回归清单;清单只用于防止漏检,不要求继承旧报告结论。
71
- - 抽象发现不能吞掉具体断链。若某字段、关系或元数据已经被纳入更大的 P1/P2 主题,还必须说明是否完成端到端贯通;未贯通时应保留独立风险或验收项。
72
- - 对 RAG / GraphRAG、规范知识库和审计系统,重点抽查 `source_version`、适用地区、专业、生效状态、复核状态、版本替代关系、证据引用和缓存/索引版本是否从摄取入口贯通到消费端。
79
+ - 如果本次是“全新独立评审”,仍应建立历史高优先级发现的回归清单;清单只用于防止漏检,不要求继承旧报告结论。
80
+ - 抽象发现不能吞掉具体断链。若某字段、关系或元数据已经被纳入更大的 P1/P2 主题,还必须说明是否完成端到端贯通;未贯通时应保留独立风险或验收项。
81
+ - 对 RAG / GraphRAG、规范知识库和审计系统,重点抽查 `source_version`、适用地区、专业、生效状态、复核状态、版本替代关系、证据引用和缓存/索引版本是否从摄取入口贯通到消费端。
82
+ - 每个 P0/P1/P2 发现必须标注为 `领域风险`、`工程风险` 或 `混合风险`,并说明文件 / 模块、最小改动范围和验证命令;无法定位时标为 `Need verify`。
83
+ - 最终必须给出“现在最该做的一件小事”,优先选择低风险、可验证、能消除静默错误或关键漂移的动作。
84
+
85
+ ## 仲裁门禁
86
+
87
+ 当 Atlas、Mason、Vitruvius、Euclid、Daedalus 或 Argus 的判断冲突时:
88
+
89
+ - 先把意见转成 Claim,不直接用自然语言争论结论。
90
+ - 优先采纳确定性工具、项目事实和结构化知识证据。
91
+ - 工具结果缺少输入、版本、适用条件或执行状态时,标为 `Need verify`。
92
+ - L1 工具失败、规范适用性冲突、安全权限失败或结构输入无效时,阻断进入 Mason 拆解或 Hephaestus 执行。
93
+ - 涉及生产授权、法规合规最终判断、结构安全结论或商业范围取舍时,升级给人类负责人。
73
94
 
74
95
  ## 端到端链路抽样清单
75
96
 
@@ -88,9 +109,10 @@
88
109
 
89
110
  - 核心技术栈替换。
90
111
  - 生产数据模型迁移。
91
- - Runtime 权限扩大。
92
- - 自动执行权限放开。
93
- - 影响长期平台路线的服务边界调整。
112
+ - Runtime 权限扩大。
113
+ - 自动执行权限放开。
114
+ - 影响长期平台路线的服务边界调整。
115
+ - 法规合规最终判定和结构安全结论。
94
116
 
95
117
  ## 验收标准
96
118
 
@@ -20,9 +20,10 @@
20
20
  | 架构边界 | Atlas | `aios-arch` |
21
21
  | 任务拆解 | Mason | `aios-plan` |
22
22
  | 受控实现 | Hephaestus | `aios-exec` |
23
- | 质量审查 | Argus | `aios-review` |
24
- | AI Runtime 相关 | Daedalus | `aios-runtime` |
25
- | BIM / IFC / 行业语义相关 | Vitruvius | `aios-knowledge` |
23
+ | 质量审查 | Argus | `aios-review` |
24
+ | AI Runtime 相关 | Daedalus | `aios-runtime` |
25
+ | BIM / IFC / 行业语义相关 | Vitruvius | `aios-knowledge` |
26
+ | 结构力学 / 求解链路相关 | Euclid | `aios-structural` |
26
27
 
27
28
  ## 输入
28
29
 
@@ -33,36 +34,41 @@
33
34
 
34
35
  ## 执行顺序
35
36
 
36
- 1. Atlas 判断需求是否涉及架构边界、数据模型、Runtime 或长期复杂度。
37
- 2. Mason 将需求拆成任务、依赖、验收标准和执行顺序。
38
- 3. Hephaestus Mason 的任务执行最小改动。
39
- 4. Argus 审查 diff、测试缺口、安全和技术债风险。
40
- 5. Mason 汇总交付状态、剩余风险和发布条件。
37
+ 1. Atlas 判断需求是否涉及架构边界、数据模型、Runtime 或长期复杂度。
38
+ 2. Mason 将需求拆成任务、依赖、验收标准和执行顺序。
39
+ 3. 如涉及规范、结构计算、安全或 Runtime 权限,先按 Capability 证据和仲裁协议确认是否可进入执行。
40
+ 4. Hephaestus Mason 的任务执行最小改动。
41
+ 5. Argus 审查 diff、测试缺口、安全和技术债风险。
42
+ 6. Mason 汇总交付状态、剩余风险和发布条件。
41
43
 
42
44
  ## 升级规则
43
45
 
44
46
  - 涉及服务边界、数据模型、核心技术栈:升级给 Atlas。
45
- - 涉及权限、安全、Prompt 注入、生产发布:升级给 Argus。
46
- - 涉及 RAG、GraphRAG、MCP、Memory、Tool Calling:升级给 Daedalus。
47
- - 涉及 BIM、IFC、规范、审图逻辑:升级给 Vitruvius。
48
- - 任务拆解不清、依赖复杂或交付顺序冲突:升级给 Mason
47
+ - 涉及权限、安全、Prompt 注入、生产发布:升级给 Argus。
48
+ - 涉及 RAG、GraphRAG、MCP、Memory、Tool Calling:升级给 Daedalus。
49
+ - 涉及 BIM、IFC、规范、审图逻辑:升级给 Vitruvius。
50
+ - 涉及结构力学、荷载、边界条件、FEM 或结构计算工具链:升级给 Euclid
51
+ - 任务拆解不清、依赖复杂或交付顺序冲突:升级给 Mason。
52
+ - Capability 返回阻断结果或证据缺失:按 `governance/arbitration-protocol.md` 回到对应 Agent 重评。
49
53
 
50
54
  ## 输出
51
55
 
52
56
  - 架构判断。
53
57
  - 任务拆解。
54
- - 实现变更。
55
- - Review 结果。
56
- - 验证证据。
57
- - 剩余风险和发布建议。
58
+ - 实现变更。
59
+ - Review 结果。
60
+ - 验证证据。
61
+ - Claim / Evidence / Tool Result / Decision。
62
+ - 剩余风险和发布建议。
58
63
 
59
64
  ## 验收标准
60
65
 
61
66
  - 每个任务有明确输入、输出和验证方式。
62
67
  - 实现只触碰必要范围。
63
- - 关键路径经过测试、构建、lint 或人工检查。
64
- - Argus 无阻断问题。
65
- - 未验证项被明确记录。
68
+ - 关键路径经过测试、构建、lint 或人工检查。
69
+ - Argus 无阻断问题。
70
+ - Capability 阻断项已清零,或已明确人工升级。
71
+ - 未验证项被明确记录。
66
72
 
67
73
  ## 回滚与恢复
68
74
 
@@ -28,15 +28,18 @@
28
28
  - 目标问题和用户场景。
29
29
  - 数据规模、更新频率、版本和来源。
30
30
  - 期望引用、追溯和评估方式。
31
+ - 可用 Capability,例如 `knowledge.norm_lookup`、测试 / eval runner、GraphRAG 构建检查。
31
32
 
32
33
  ## 执行顺序
33
34
 
34
35
  1. Vitruvius 拆解领域对象、术语、条文条件和待核验项。
35
36
  2. Daedalus 设计 chunk、抽取、embedding、索引、检索、重排、引用和评估。
36
- 3. Atlas 判断知识层、平台层和 Runtime 层边界。
37
- 4. Mason 拆解实现任务和验证路径。
38
- 5. Hephaestus 执行受控实现或文档落地。
39
- 6. Argus 审查数据污染、Prompt 注入、工具权限和发布风险。
37
+ 3. 使用或要求 `knowledge.norm_lookup` Capability 证据校验规范版本、适用条件、来源页码和冲突关系。
38
+ 4. Atlas 判断知识层、平台层和 Runtime 层边界。
39
+ 5. Mason 拆解实现任务和验证路径。
40
+ 6. Hephaestus 执行受控实现或文档落地。
41
+ 7. Argus 审查数据污染、Prompt 注入、工具权限和发布风险。
42
+ 8. 对冲突条文、适用性不明或工具失败输出 `Claim / Evidence / Tool Result / Decision`。
40
43
 
41
44
  ## 输出
42
45
 
@@ -45,6 +48,7 @@
45
48
  - 检索和生成链路。
46
49
  - 评估指标。
47
50
  - 风险与待核验项。
51
+ - Capability 证据和仲裁结论。
48
52
  - 后续任务。
49
53
 
50
54
  ## 验收标准
@@ -54,4 +58,4 @@
54
58
  - RAG / GraphRAG 有评估方式。
55
59
  - 不能自动判断的行业问题被标注。
56
60
  - 权限、数据污染和 Prompt 注入风险已审查。
57
-
61
+ - 规范或知识结论缺少版本、来源、适用条件时不得标记为已验证。
@@ -0,0 +1,101 @@
1
+ # 现场协同与日常管理闭环 Workflow
2
+
3
+ 状态:工程业务管理增强流程
4
+ 适用场景:施工日报整理、工程会议待办闭环、现场异常复盘、变更签证线索预警
5
+
6
+ ---
7
+
8
+ ## 目标
9
+
10
+ 把碎片化的施工日报、项目群记录、工程会议纪要、联系单和现场往来函件整理为可追踪的管理简报、问题台账、待办闭环和潜在变更签证线索。
11
+
12
+ 本 Workflow 只处理建筑工程现场管理资料的抽取、交叉比对和证据链整理,不替代项目经理、监理、业主、法务、商务、造价或安全管理人员的正式签审。
13
+
14
+ ## 触发场景
15
+
16
+ - 每日施工日志、项目群聊天和现场异常记录需要收口。
17
+ - 项目例会前需要汇总进度、问题、待办和签证线索。
18
+ - 新会议纪要、联系单或往来函件需要纳入追踪。
19
+ - 日报、会议和联系单之间存在事实不一致、责任不清或资料断点。
20
+
21
+ ## 参与角色与 Skill
22
+
23
+ | 阶段 | 主 Agent | Skill | 职责 |
24
+ | --- | --- | --- | --- |
25
+ | 协调与编排 | Mason | `aios-plan` | 冻结输入范围、分配资料类型、控制输出格式和汇总顺序。 |
26
+ | 日报摘要提取 | Mason | `aios-construction-daily` | 提取事实摘要、异常、问题台账、计划偏差和需补充确认事项。 |
27
+ | 会议待办闭环 | Mason | `aios-construction-meeting` | 提取会议结论、责任人、期限、争议点和下次追踪事项。 |
28
+ | 签证资料链审查 | Argus | `aios-commercial-variation` | 对高风险事项检查联系单、纪要、图纸、日志和合同流程资料链。 |
29
+ | 行业语义 / 规范核验 | Vitruvius / Athena | `aios-knowledge` / `knowledge.norm_lookup` | 对规范、制度或地方要求进行可追溯查询;缺工具时输出 `Need verify`。 |
30
+
31
+ ## 输入
32
+
33
+ - 当日或近期施工日报、项目群核心聊天记录、现场巡检记录。
34
+ - 相关协调会记录、交底纪要、专题会议纪要。
35
+ - 工程联系单、来往函件、图纸变更、监理通知或照片说明。
36
+ - 当前阶段里程碑计划、周计划或其他计划基线,如有。
37
+ - 资料来源定位:文件名、版本、日期、页码、章节、行号、消息时间、编号和签认状态。
38
+
39
+ ## 输出
40
+
41
+ 综合简报必须包含:
42
+
43
+ 1. 今日管理摘要。
44
+ 2. Source Map。
45
+ 3. 待办与问题追踪台账。
46
+ 4. 潜在签证 / 变更预警清单。
47
+ 5. 需人工复核与确认的盲区。
48
+ 6. Arbitration:关键风险的 `Claim / Evidence / Tool Result / Decision`。
49
+
50
+ ## 执行顺序
51
+
52
+ 1. Mason 冻结输入范围,建立 Source Map,并按资料类型分派。
53
+ 2. 并行调用:
54
+ - `aios-construction-daily` 输出事实摘要、问题台账和计划偏差。
55
+ - `aios-construction-meeting` 输出会议结论、待办闭环和遗留争议。
56
+ 3. Mason 合并台账,只合并带 `Evidence` 的事项;证据缺失项进入 `Need verify`。
57
+ 4. Mason 抽取高风险事项,例如工期延误、图纸争议、现场条件变化、质量安全异常、责任不清和资料断点。
58
+ 5. Argus 使用 `aios-commercial-variation` 对高风险事项进行资料链审查。
59
+ 6. 对涉及规范、制度或地方要求的事项,调用或要求 `knowledge.norm_lookup`;没有 Tool Result 时不得写成已验证。
60
+ 7. Mason 生成统一简报,保留每条关键结论的来源、子 skill 输出和当前 Decision。
61
+
62
+ ## 验收标准
63
+
64
+ - 输入资料已建立 Source Map,关键结论能追溯到原文或子 skill 输出。
65
+ - “已确认事实”“推断事项”“需确认事项”被明确区分。
66
+ - 待办台账具备责任人、期限、交付物、证据和当前 Decision。
67
+ - 潜在签证 / 变更预警只基于客观材料,不输出成立、责任或金额结论。
68
+ - 涉及规范、制度或地方要求的结论有 Tool Result;没有则标 `Need verify`。
69
+ - 最终简报可发送给项目管理团队,但不能替代正式纪要、签证、通知或审批文件。
70
+
71
+ ## Claim / Evidence / Tool Result / Decision
72
+
73
+ 关键风险条目必须使用以下格式:
74
+
75
+ ```text
76
+ Claim:
77
+ Evidence:
78
+ Tool Result:
79
+ Decision:Proceed / Need verify / Hold for human
80
+ 责任人:
81
+ 下一步:
82
+ ```
83
+
84
+ Decision 规则:
85
+
86
+ - `Proceed`:证据完整,且只需进入普通跟踪或执行。
87
+ - `Need verify`:缺计划基线、责任人、签认、图号、规范 Tool Result 或资料原文。
88
+ - `Hold for human`:涉及金额、责任归属、工期索赔、质量安全结论、合同法律意见或正式签审。
89
+
90
+ ## 降级与人工接入
91
+
92
+ - 如果输入资料极度残缺,流程停止在 Source Map 和待补充资料清单。
93
+ - 如果子 skill 输出没有 Evidence,Mason 不得纳入最终确定结论,只能作为待核验线索。
94
+ - 对金额、工期、质量安全、责任归属、合同争议和正式签认事项,必须交由专业岗位人工接入。
95
+ - 如果规范或制度查询工具不可用,相关结论降级为 `Need verify`。
96
+
97
+ ## 回滚策略
98
+
99
+ - 如果汇总简报发现引用错误或资料版本错误,撤回该版本简报,回到 Source Map 阶段重新绑定证据。
100
+ - 如果后续正式纪要、联系单或业主/监理签认推翻当前摘要,应保留旧版为历史记录,并发布修订版,标注被替换的 Claim。
101
+ - 如果误把推断写成事实,应将对应条目标为 `Need verify`,并通知下游台账或签证线索使用方停止引用该结论。