@archsight/aios 1.0.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 (158) hide show
  1. package/AGENTS.md +24 -0
  2. package/AI_CODING_RULES.md +117 -0
  3. package/CHANGELOG.md +17 -0
  4. package/CLAUDE.md +23 -0
  5. package/CODE_OF_CONDUCT.md +23 -0
  6. package/CONTRIBUTING.md +60 -0
  7. package/GEMINI.md +24 -0
  8. package/LICENSE +21 -0
  9. package/README.md +154 -0
  10. package/SECURITY.md +32 -0
  11. package/agents/README.md +68 -0
  12. package/agents/argus/constraints.md +37 -0
  13. package/agents/argus/responsibilities.md +29 -0
  14. package/agents/argus/role.md +35 -0
  15. package/agents/argus/system-prompt.md +69 -0
  16. package/agents/argus/workflow.md +60 -0
  17. package/agents/athena/constraints.md +7 -0
  18. package/agents/athena/responsibilities.md +7 -0
  19. package/agents/athena/role.md +13 -0
  20. package/agents/athena/system-prompt.md +23 -0
  21. package/agents/athena/workflow.md +8 -0
  22. package/agents/atlas/constraints.md +40 -0
  23. package/agents/atlas/responsibilities.md +37 -0
  24. package/agents/atlas/role.md +37 -0
  25. package/agents/atlas/system-prompt.md +80 -0
  26. package/agents/atlas/workflow.md +82 -0
  27. package/agents/daedalus/constraints.md +37 -0
  28. package/agents/daedalus/responsibilities.md +29 -0
  29. package/agents/daedalus/role.md +36 -0
  30. package/agents/daedalus/system-prompt.md +67 -0
  31. package/agents/daedalus/workflow.md +63 -0
  32. package/agents/euclid/constraints.md +8 -0
  33. package/agents/euclid/responsibilities.md +8 -0
  34. package/agents/euclid/role.md +13 -0
  35. package/agents/euclid/system-prompt.md +23 -0
  36. package/agents/euclid/workflow.md +8 -0
  37. package/agents/hephaestus/constraints.md +39 -0
  38. package/agents/hephaestus/responsibilities.md +29 -0
  39. package/agents/hephaestus/role.md +35 -0
  40. package/agents/hephaestus/system-prompt.md +70 -0
  41. package/agents/hephaestus/workflow.md +62 -0
  42. package/agents/janus/constraints.md +7 -0
  43. package/agents/janus/responsibilities.md +7 -0
  44. package/agents/janus/role.md +13 -0
  45. package/agents/janus/system-prompt.md +23 -0
  46. package/agents/janus/workflow.md +8 -0
  47. package/agents/mason/constraints.md +37 -0
  48. package/agents/mason/responsibilities.md +33 -0
  49. package/agents/mason/role.md +35 -0
  50. package/agents/mason/system-prompt.md +69 -0
  51. package/agents/mason/workflow.md +83 -0
  52. package/agents/mercury/constraints.md +7 -0
  53. package/agents/mercury/responsibilities.md +7 -0
  54. package/agents/mercury/role.md +13 -0
  55. package/agents/mercury/system-prompt.md +23 -0
  56. package/agents/mercury/workflow.md +8 -0
  57. package/agents/vitruvius/constraints.md +37 -0
  58. package/agents/vitruvius/responsibilities.md +28 -0
  59. package/agents/vitruvius/role.md +35 -0
  60. package/agents/vitruvius/system-prompt.md +66 -0
  61. package/agents/vitruvius/workflow.md +59 -0
  62. package/bin/archsight-aios.mjs +959 -0
  63. package/delivery/README.md +13 -0
  64. package/delivery/ai-generated-code-checklist.md +15 -0
  65. package/delivery/release-checklist.md +23 -0
  66. package/delivery/rollback-policy.md +26 -0
  67. package/docs/ai-engineering-squad-plan.md +506 -0
  68. package/docs/ai-team-os-repository-architecture.md +459 -0
  69. package/docs/business-expert-guide.md +67 -0
  70. package/docs/glossary.md +65 -0
  71. package/docs/quickstart.md +88 -0
  72. package/governance/README.md +15 -0
  73. package/governance/agent-boundary.md +27 -0
  74. package/governance/ai-review-policy.md +27 -0
  75. package/governance/coding-rules.md +9 -0
  76. package/governance/context-policy.md +24 -0
  77. package/governance/delivery-policy.md +21 -0
  78. package/governance/memory-policy.md +25 -0
  79. package/governance/security-policy.md +25 -0
  80. package/graph/README.md +12 -0
  81. package/graph/quality-policy.md +14 -0
  82. package/graph/schema.md +28 -0
  83. package/infra/README.md +21 -0
  84. package/infra/environment-policy.md +21 -0
  85. package/infra/permissions.md +21 -0
  86. package/infra/service-boundaries.md +18 -0
  87. package/knowledge/README.md +20 -0
  88. package/knowledge/domain-taxonomy.md +19 -0
  89. package/knowledge/source-register.md +23 -0
  90. package/memory/README.md +12 -0
  91. package/memory/cleanup-policy.md +15 -0
  92. package/memory/decision-records.md +26 -0
  93. package/memory/project-memory-policy.md +18 -0
  94. package/package.json +69 -0
  95. package/prompts/README.md +13 -0
  96. package/prompts/evaluation-policy.md +18 -0
  97. package/prompts/failure-cases.md +23 -0
  98. package/prompts/prompt-registry.md +24 -0
  99. package/rag/README.md +12 -0
  100. package/rag/chunking-policy.md +19 -0
  101. package/rag/evaluation-policy.md +16 -0
  102. package/runtime/README.md +22 -0
  103. package/runtime/agent-routing.md +92 -0
  104. package/runtime/archsight-aios.manifest.json +326 -0
  105. package/runtime/hermes/agent-registry.md +58 -0
  106. package/runtime/hermes/feishu-routing.md +60 -0
  107. package/runtime/hermes/sync-from-agents.md +48 -0
  108. package/runtime/hermes/sync-policy.md +20 -0
  109. package/runtime/hermes/sync-record-template.md +18 -0
  110. package/runtime/hermes/workspace-binding.md +55 -0
  111. package/runtime/skill-routing.md +63 -0
  112. package/skills/README.md +38 -0
  113. package/skills/aios-arch/SKILL.md +175 -0
  114. package/skills/aios-arch/agents/openai.yaml +4 -0
  115. package/skills/aios-ceo/SKILL.md +89 -0
  116. package/skills/aios-ceo/agents/openai.yaml +4 -0
  117. package/skills/aios-design/SKILL.md +99 -0
  118. package/skills/aios-design/agents/openai.yaml +4 -0
  119. package/skills/aios-exec/SKILL.md +62 -0
  120. package/skills/aios-exec/agents/openai.yaml +4 -0
  121. package/skills/aios-knowledge/SKILL.md +61 -0
  122. package/skills/aios-knowledge/agents/openai.yaml +4 -0
  123. package/skills/aios-plan/SKILL.md +96 -0
  124. package/skills/aios-plan/agents/openai.yaml +4 -0
  125. package/skills/aios-review/SKILL.md +66 -0
  126. package/skills/aios-review/agents/openai.yaml +4 -0
  127. package/skills/aios-runtime/SKILL.md +65 -0
  128. package/skills/aios-runtime/agents/openai.yaml +4 -0
  129. package/standards/README.md +16 -0
  130. package/standards/standard-register.md +23 -0
  131. package/templates/README.md +29 -0
  132. package/templates/project-ai/.ai/ARCHSIGHT_AIOS_RULES.md +35 -0
  133. package/templates/project-ai/.ai/agent-routing.md +50 -0
  134. package/templates/project-ai/.ai/project-context.md +47 -0
  135. package/templates/project-ai/.ai/skills.md +39 -0
  136. package/templates/project-ai/.ai/workflows.md +40 -0
  137. package/templates/project-ai/AGENTS.md +25 -0
  138. package/templates/project-ai/AI_CODING_RULES.md +118 -0
  139. package/templates/project-ai/CLAUDE.md +25 -0
  140. package/templates/project-ai/GEMINI.md +25 -0
  141. package/templates/project-bim-platform/.ai/profiles/bim-platform.md +39 -0
  142. package/templates/project-construction-vision/.ai/profiles/construction-vision.md +39 -0
  143. package/templates/project-rag-knowledge/.ai/profiles/rag-knowledge.md +40 -0
  144. package/templates/template-expansion-backlog.md +29 -0
  145. package/vision/README.md +15 -0
  146. package/vision/roadmap.md +29 -0
  147. package/vision/strategy-principles.md +16 -0
  148. package/workflows/README.md +19 -0
  149. package/workflows/architecture-review.md +98 -0
  150. package/workflows/bug-fixing.md +62 -0
  151. package/workflows/code-review.md +54 -0
  152. package/workflows/design-review.md +68 -0
  153. package/workflows/feature-development.md +72 -0
  154. package/workflows/frontend-generation.md +60 -0
  155. package/workflows/quality-readiness.md +74 -0
  156. package/workflows/rag-pipeline.md +57 -0
  157. package/workflows/release.md +58 -0
  158. package/workflows/review.md +70 -0
@@ -0,0 +1,92 @@
1
+ # Agent Routing
2
+
3
+ 状态:治理基线
4
+ 适用范围:ArchSight AIOS 的多 Agent / 多模型调度
5
+
6
+ ---
7
+
8
+ ## 一、目标
9
+
10
+ 统一 Agent 到模型、工具和任务类型的路由,控制成本、上下文、权限和输出质量。
11
+
12
+ 没有统一路由会导致:
13
+
14
+ - 成本失控。
15
+ - 上下文失控。
16
+ - 多 Agent 职责重叠。
17
+ - 模型能力与任务不匹配。
18
+ - 执行型 Agent 越权修改。
19
+
20
+ ---
21
+
22
+ ## 二、默认路由表
23
+
24
+ | Agent | 中文定位 | 默认模型族 | 主要任务 | 禁止事项 |
25
+ | --- | --- | --- | --- | --- |
26
+ | Atlas | 总架构师 | GPT | 架构设计、技术路线、边界治理、复杂 tradeoff | 不直接大规模写代码 |
27
+ | Mason | 工程总工 | Gemini / GPT | 任务拆解、工程组织、CI/CD、交付计划 | 不越过审查直接发布 |
28
+ | Argus | 代码审查官 | Claude / GPT | Code Review、安全、性能、技术债、Prompt 注入风险 | 不做无关风格挑刺 |
29
+ | Vitruvius | 建筑数字化专家 | GPT / 行业知识模型 | BIM、IFC、规范、审图、行业知识结构化 | 不替代结构计算求解 |
30
+ | Daedalus | AI 研发工程师 | GPT / Codex | RAG、GraphRAG、MCP、Tool Calling、Agent Runtime | 不擅自扩大工具权限 |
31
+ | Hephaestus | 受控执行官 | Codex | 代码修改、脚本执行、自动化测试、文档生成 | 不擅自加功能或重构 |
32
+ | Euclid | 结构力学专家 | GPT / 数值计算模型 | 梁系、桁架、FEM、刚度矩阵、荷载分析 | 不在未验证公式时输出工程结论 |
33
+ | Athena | 知识治理官 | GPT | 标准治理、版本管理、知识图谱治理、条文差异 | 不直接改运行系统 |
34
+ | Mercury | AI 情报官 | DeepSeek / 搜索增强模型 | AI 情报、GitHub 趋势、MCP 生态、开源分析 | 不把未验证资讯当事实 |
35
+ | Janus | 产品策略官 | GPT / Gemini | MVP、SaaS、用户分层、商业化路径 | 不替代工程验收 |
36
+
37
+ ---
38
+
39
+ ## 三、路由原则
40
+
41
+ - 架构问题先走 Atlas。
42
+ - 立项、定位、商业目标和范围取舍先走 Janus。
43
+ - 工程拆解和交付组织先走 Mason。
44
+ - 代码质量、安全和风险审查先走 Argus。
45
+ - 建筑行业知识问题先走 Vitruvius。
46
+ - RAG、MCP、Agent Runtime 问题先走 Daedalus。
47
+ - 具体代码执行和脚本执行先走 Hephaestus。
48
+ - AI 行业情报和开源趋势先走 Mercury。
49
+ - 产品范围、MVP 和商业化路径先走 Janus。
50
+
51
+ ---
52
+
53
+ ## 四、成本控制
54
+
55
+ - 简单分类、摘要、文档整理优先低成本模型。
56
+ - 架构、审查、安全、复杂调试使用高能力模型。
57
+ - 大上下文任务必须先压缩输入,再路由给高成本模型。
58
+ - 执行型任务必须限制工具权限和改动范围。
59
+
60
+ ---
61
+
62
+ ## 五、上下文控制
63
+
64
+ - 每个 Agent 只接收完成任务所需的最小上下文。
65
+ - 不把完整仓库、完整聊天记录或无关文档直接塞给执行型 Agent。
66
+ - 长期记忆必须经过整理后进入任务上下文。
67
+ - 路由决策和关键取舍应写入 memory 或决策记录。
68
+
69
+ ---
70
+
71
+ ## 六、升级规则
72
+
73
+ 需要升级到 Atlas:
74
+
75
+ - 涉及服务边界。
76
+ - 涉及数据模型。
77
+ - 涉及长期架构。
78
+ - 涉及模型或 runtime 重大调整。
79
+
80
+ 需要升级到 Argus:
81
+
82
+ - 涉及权限、安全、Prompt 注入。
83
+ - 涉及生产发布。
84
+ - 涉及依赖升级。
85
+ - 涉及 AI 自动生成大段代码。
86
+
87
+ 需要升级到 Mason:
88
+
89
+ - 涉及多模块协同。
90
+ - 涉及 CI/CD。
91
+ - 涉及交付顺序。
92
+ - 涉及团队 workflow。
@@ -0,0 +1,326 @@
1
+ {
2
+ "schema": 1,
3
+ "name": "archsight-aios",
4
+ "version": "0.1.0",
5
+ "description": "ArchSight AIOS agent, skill, workflow, runtime, and project-template registry.",
6
+ "agents": [
7
+ {
8
+ "id": "atlas",
9
+ "displayName": "Atlas",
10
+ "role": "总架构师",
11
+ "sourcePath": "agents/atlas",
12
+ "runtimePromptPath": "agents/atlas/system-prompt.md"
13
+ },
14
+ {
15
+ "id": "mason",
16
+ "displayName": "Mason",
17
+ "role": "工程总工",
18
+ "sourcePath": "agents/mason",
19
+ "runtimePromptPath": "agents/mason/system-prompt.md"
20
+ },
21
+ {
22
+ "id": "argus",
23
+ "displayName": "Argus",
24
+ "role": "代码审查官",
25
+ "sourcePath": "agents/argus",
26
+ "runtimePromptPath": "agents/argus/system-prompt.md"
27
+ },
28
+ {
29
+ "id": "vitruvius",
30
+ "displayName": "Vitruvius",
31
+ "role": "建筑数字化专家",
32
+ "sourcePath": "agents/vitruvius",
33
+ "runtimePromptPath": "agents/vitruvius/system-prompt.md"
34
+ },
35
+ {
36
+ "id": "daedalus",
37
+ "displayName": "Daedalus",
38
+ "role": "AI 研发工程师",
39
+ "sourcePath": "agents/daedalus",
40
+ "runtimePromptPath": "agents/daedalus/system-prompt.md"
41
+ },
42
+ {
43
+ "id": "hephaestus",
44
+ "displayName": "Hephaestus",
45
+ "role": "受控执行官",
46
+ "sourcePath": "agents/hephaestus",
47
+ "runtimePromptPath": "agents/hephaestus/system-prompt.md"
48
+ },
49
+ {
50
+ "id": "euclid",
51
+ "displayName": "Euclid",
52
+ "role": "结构力学专家",
53
+ "sourcePath": "agents/euclid",
54
+ "runtimePromptPath": "agents/euclid/system-prompt.md"
55
+ },
56
+ {
57
+ "id": "athena",
58
+ "displayName": "Athena",
59
+ "role": "知识治理官",
60
+ "sourcePath": "agents/athena",
61
+ "runtimePromptPath": "agents/athena/system-prompt.md"
62
+ },
63
+ {
64
+ "id": "mercury",
65
+ "displayName": "Mercury",
66
+ "role": "AI 情报官",
67
+ "sourcePath": "agents/mercury",
68
+ "runtimePromptPath": "agents/mercury/system-prompt.md"
69
+ },
70
+ {
71
+ "id": "janus",
72
+ "displayName": "Janus",
73
+ "role": "产品策略官",
74
+ "sourcePath": "agents/janus",
75
+ "runtimePromptPath": "agents/janus/system-prompt.md"
76
+ }
77
+ ],
78
+ "skills": [
79
+ {
80
+ "id": "aios-ceo",
81
+ "primaryAgent": "janus",
82
+ "defaultWorkflow": "review",
83
+ "path": "skills/aios-ceo/SKILL.md",
84
+ "openaiConfigPath": "skills/aios-ceo/agents/openai.yaml"
85
+ },
86
+ {
87
+ "id": "aios-design",
88
+ "primaryAgent": "janus",
89
+ "defaultWorkflow": "design-review",
90
+ "path": "skills/aios-design/SKILL.md",
91
+ "openaiConfigPath": "skills/aios-design/agents/openai.yaml"
92
+ },
93
+ {
94
+ "id": "aios-arch",
95
+ "primaryAgent": "atlas",
96
+ "defaultWorkflow": "architecture-review",
97
+ "path": "skills/aios-arch/SKILL.md",
98
+ "openaiConfigPath": "skills/aios-arch/agents/openai.yaml"
99
+ },
100
+ {
101
+ "id": "aios-plan",
102
+ "primaryAgent": "mason",
103
+ "defaultWorkflow": "feature-development",
104
+ "path": "skills/aios-plan/SKILL.md",
105
+ "openaiConfigPath": "skills/aios-plan/agents/openai.yaml"
106
+ },
107
+ {
108
+ "id": "aios-review",
109
+ "primaryAgent": "argus",
110
+ "defaultWorkflow": "code-review",
111
+ "path": "skills/aios-review/SKILL.md",
112
+ "openaiConfigPath": "skills/aios-review/agents/openai.yaml"
113
+ },
114
+ {
115
+ "id": "aios-knowledge",
116
+ "primaryAgent": "vitruvius",
117
+ "defaultWorkflow": "rag-pipeline",
118
+ "path": "skills/aios-knowledge/SKILL.md",
119
+ "openaiConfigPath": "skills/aios-knowledge/agents/openai.yaml"
120
+ },
121
+ {
122
+ "id": "aios-runtime",
123
+ "primaryAgent": "daedalus",
124
+ "defaultWorkflow": "rag-pipeline",
125
+ "path": "skills/aios-runtime/SKILL.md",
126
+ "openaiConfigPath": "skills/aios-runtime/agents/openai.yaml"
127
+ },
128
+ {
129
+ "id": "aios-exec",
130
+ "primaryAgent": "hephaestus",
131
+ "defaultWorkflow": "feature-development",
132
+ "path": "skills/aios-exec/SKILL.md",
133
+ "openaiConfigPath": "skills/aios-exec/agents/openai.yaml"
134
+ }
135
+ ],
136
+ "workflows": [
137
+ {
138
+ "id": "architecture-review",
139
+ "path": "workflows/architecture-review.md"
140
+ },
141
+ {
142
+ "id": "feature-development",
143
+ "path": "workflows/feature-development.md"
144
+ },
145
+ {
146
+ "id": "bug-fixing",
147
+ "path": "workflows/bug-fixing.md"
148
+ },
149
+ {
150
+ "id": "code-review",
151
+ "path": "workflows/code-review.md"
152
+ },
153
+ {
154
+ "id": "review",
155
+ "path": "workflows/review.md"
156
+ },
157
+ {
158
+ "id": "design-review",
159
+ "path": "workflows/design-review.md"
160
+ },
161
+ {
162
+ "id": "quality-readiness",
163
+ "path": "workflows/quality-readiness.md"
164
+ },
165
+ {
166
+ "id": "release",
167
+ "path": "workflows/release.md"
168
+ },
169
+ {
170
+ "id": "frontend-generation",
171
+ "path": "workflows/frontend-generation.md"
172
+ },
173
+ {
174
+ "id": "rag-pipeline",
175
+ "path": "workflows/rag-pipeline.md"
176
+ }
177
+ ],
178
+ "routes": [
179
+ {
180
+ "taskType": "项目立项、产品定位、商业目标、范围取舍",
181
+ "skill": "aios-ceo",
182
+ "agent": "janus",
183
+ "workflow": "review"
184
+ },
185
+ {
186
+ "taskType": "建筑行业平台界面方案、工作台体验、复核追溯和前端实现交接",
187
+ "skill": "aios-design",
188
+ "agent": "janus",
189
+ "workflow": "design-review"
190
+ },
191
+ {
192
+ "taskType": "架构评审、技术选型、服务边界",
193
+ "skill": "aios-arch",
194
+ "agent": "atlas",
195
+ "workflow": "architecture-review"
196
+ },
197
+ {
198
+ "taskType": "Feature 拆解、交付计划、任务依赖",
199
+ "skill": "aios-plan",
200
+ "agent": "mason",
201
+ "workflow": "feature-development"
202
+ },
203
+ {
204
+ "taskType": "PR / diff / AI 生成代码审查",
205
+ "skill": "aios-review",
206
+ "agent": "argus",
207
+ "workflow": "code-review"
208
+ },
209
+ {
210
+ "taskType": "Bug 修复、测试失败、构建失败",
211
+ "skill": "aios-exec",
212
+ "agent": "hephaestus",
213
+ "workflow": "bug-fixing"
214
+ },
215
+ {
216
+ "taskType": "BIM / IFC / 建筑规范 / 审图规则",
217
+ "skill": "aios-knowledge",
218
+ "agent": "vitruvius",
219
+ "workflow": "rag-pipeline"
220
+ },
221
+ {
222
+ "taskType": "Prompt / Context / Memory / MCP / Tool",
223
+ "skill": "aios-runtime",
224
+ "agent": "daedalus",
225
+ "workflow": "architecture-review"
226
+ },
227
+ {
228
+ "taskType": "RAG / GraphRAG Pipeline",
229
+ "skill": "aios-runtime",
230
+ "agent": "daedalus",
231
+ "workflow": "rag-pipeline"
232
+ },
233
+ {
234
+ "taskType": "受控代码修改、文档、脚本、测试",
235
+ "skill": "aios-exec",
236
+ "agent": "hephaestus",
237
+ "workflow": "feature-development"
238
+ }
239
+ ],
240
+ "projectTemplate": {
241
+ "path": "templates/project-ai",
242
+ "requiredFiles": [
243
+ "AGENTS.md",
244
+ "AI_CODING_RULES.md",
245
+ "CLAUDE.md",
246
+ "GEMINI.md",
247
+ ".ai/ARCHSIGHT_AIOS_RULES.md",
248
+ ".ai/project-context.md",
249
+ ".ai/agent-routing.md",
250
+ ".ai/skills.md",
251
+ ".ai/workflows.md"
252
+ ]
253
+ },
254
+ "projectProfiles": [
255
+ {
256
+ "id": "bim-platform",
257
+ "path": "templates/project-bim-platform",
258
+ "description": "BIM / IFC / Revit / CAD / modeling platform project profile.",
259
+ "requiredFiles": [
260
+ ".ai/profiles/bim-platform.md"
261
+ ]
262
+ },
263
+ {
264
+ "id": "construction-vision",
265
+ "path": "templates/project-construction-vision",
266
+ "description": "Construction vision AI, detection, segmentation, and depth-estimation project profile.",
267
+ "requiredFiles": [
268
+ ".ai/profiles/construction-vision.md"
269
+ ]
270
+ },
271
+ {
272
+ "id": "rag-knowledge",
273
+ "path": "templates/project-rag-knowledge",
274
+ "description": "Building-code knowledge base, RAG, GraphRAG, and knowledge-graph project profile.",
275
+ "requiredFiles": [
276
+ ".ai/profiles/rag-knowledge.md"
277
+ ]
278
+ }
279
+ ],
280
+ "installTargets": {
281
+ "codexSkills": "~/.codex/skills",
282
+ "codexWorkflows": "~/.codex/workflows/aios",
283
+ "sharedAgentSkills": "~/.agents/skills",
284
+ "sharedAgentWorkflows": "~/.agents/workflows/aios",
285
+ "geminiInstructions": "~/.gemini/GEMINI.md",
286
+ "antigravityPlugin": "~/.gemini/config/plugins/archsight-aios",
287
+ "antigravityLegacySkills": "~/.gemini/antigravity/skills",
288
+ "geminiSupportAssets": "~/.gemini/archsight-aios"
289
+ },
290
+ "hermes": {
291
+ "registryPath": "runtime/hermes/agent-registry.md",
292
+ "syncPolicyPath": "runtime/hermes/sync-policy.md",
293
+ "syncRecordTemplatePath": "runtime/hermes/sync-record-template.md"
294
+ },
295
+ "requiredAssets": [
296
+ "governance/ai-review-policy.md",
297
+ "governance/security-policy.md",
298
+ "governance/agent-boundary.md",
299
+ "governance/context-policy.md",
300
+ "governance/memory-policy.md",
301
+ "governance/delivery-policy.md",
302
+ "delivery/release-checklist.md",
303
+ "delivery/ai-generated-code-checklist.md",
304
+ "delivery/rollback-policy.md",
305
+ "memory/decision-records.md",
306
+ "memory/project-memory-policy.md",
307
+ "memory/cleanup-policy.md",
308
+ "knowledge/domain-taxonomy.md",
309
+ "knowledge/source-register.md",
310
+ "standards/standard-register.md",
311
+ "rag/chunking-policy.md",
312
+ "rag/evaluation-policy.md",
313
+ "graph/schema.md",
314
+ "graph/quality-policy.md",
315
+ "vision/roadmap.md",
316
+ "vision/strategy-principles.md",
317
+ "prompts/prompt-registry.md",
318
+ "prompts/evaluation-policy.md",
319
+ "prompts/failure-cases.md",
320
+ "infra/environment-policy.md",
321
+ "infra/permissions.md",
322
+ "infra/service-boundaries.md",
323
+ "runtime/hermes/sync-policy.md",
324
+ "runtime/hermes/sync-record-template.md"
325
+ ]
326
+ }
@@ -0,0 +1,58 @@
1
+ # Hermes Agent Registry
2
+
3
+ ## 定位
4
+
5
+ 本文件定义可选 Hermes Adapter 中应创建哪些 Agent,以及它们从仓库哪里同步运行时 System Prompt。
6
+
7
+ Hermes Agent 是部署实例,不是角色资产源;未使用 Hermes 的项目仍可直接使用 AIOS 的规则、Skill、Workflow 和项目模板。
8
+
9
+ ## Source / Runtime / Instance
10
+
11
+ | 层 | 内容 | 位置 |
12
+ | --- | --- | --- |
13
+ | Source | 角色资产包 | `agents/{agent}/` |
14
+ | Runtime | Hermes 使用的系统提示词 | `agents/{agent}/system-prompt.md` |
15
+ | Instance | Hermes Agent / 飞书机器人 | Hermes 控制台或运行配置,仅在项目启用该 Adapter 时需要 |
16
+
17
+ ## 第一阶段核心 Agent
18
+
19
+ | Hermes Agent | Source | Runtime Prompt |
20
+ | --- | --- | --- |
21
+ | Atlas | `agents/atlas/` | `agents/atlas/system-prompt.md` |
22
+ | Mason | `agents/mason/` | `agents/mason/system-prompt.md` |
23
+ | Argus | `agents/argus/` | `agents/argus/system-prompt.md` |
24
+ | Vitruvius | `agents/vitruvius/` | `agents/vitruvius/system-prompt.md` |
25
+ | Daedalus | `agents/daedalus/` | `agents/daedalus/system-prompt.md` |
26
+ | Hephaestus | `agents/hephaestus/` | `agents/hephaestus/system-prompt.md` |
27
+
28
+ ## 第二阶段最小入口 Agent
29
+
30
+ 第二阶段 Agent 当前只登记 Source 和 Runtime Prompt,不自动进入执行链路;没有经过验证的 Skill 前,不为它们创建自动化 Skill。
31
+
32
+ | Hermes Agent | Source | Runtime Prompt |
33
+ | --- | --- | --- |
34
+ | Euclid | `agents/euclid/` | `agents/euclid/system-prompt.md` |
35
+ | Athena | `agents/athena/` | `agents/athena/system-prompt.md` |
36
+ | Mercury | `agents/mercury/` | `agents/mercury/system-prompt.md` |
37
+ | Janus | `agents/janus/` | `agents/janus/system-prompt.md` |
38
+
39
+ ## 创建规则
40
+
41
+ - Hermes 创建 Agent 时只复制 `system-prompt.md`。
42
+ - 不让 Hermes 自由读取整个角色文件夹。
43
+ - 修改角色时,先改仓库 Source,再同步 Runtime Prompt。
44
+ - 飞书机器人只绑定 Hermes Agent,不承载复杂角色定义。
45
+
46
+ ## 变更记录
47
+
48
+ 每次同步 Hermes Agent,应记录:
49
+
50
+ ```text
51
+ Agent:
52
+ Source commit:
53
+ Prompt path:
54
+ 同步时间:
55
+ 同步人:
56
+ 变更摘要:
57
+ 回滚方式:
58
+ ```
@@ -0,0 +1,60 @@
1
+ # Feishu Routing
2
+
3
+ ## 定位
4
+
5
+ 飞书是可选协作入口、通知入口和异步任务入口,不是 AIOS 必需组件,也不是工程验证主战场。
6
+
7
+ 本地项目工作目录仍然负责:
8
+
9
+ - 读取代码。
10
+ - 修改文件。
11
+ - 运行测试。
12
+ - 构建验证。
13
+ - 生成 PR 或交付物。
14
+
15
+ ## 默认绑定
16
+
17
+ | 飞书入口 | Hermes Agent | 典型任务 |
18
+ | --- | --- | --- |
19
+ | 架构咨询 | Atlas | 架构评审、技术选型、边界判断 |
20
+ | 工程计划 | Mason | 任务拆解、发布计划、交付顺序 |
21
+ | 质量审查 | Argus | PR 风险、安全、技术债 |
22
+ | 建筑知识 | Vitruvius | BIM、IFC、规范、审图语义 |
23
+ | AI Runtime | Daedalus | RAG、MCP、Memory、Tool |
24
+ | 受控执行 | Hephaestus | 需要绑定项目工作区后执行 |
25
+ | 结构力学 | Euclid | 结构分析、荷载、FEM 建模建议 |
26
+ | 知识治理 | Athena | 标准版本、知识源、图谱治理 |
27
+ | AI 情报 | Mercury | 工具生态、模型能力、开源趋势 |
28
+ | 产品策略 | Janus | MVP、用户场景、商业化路径 |
29
+
30
+ ## 飞书任务分类
31
+
32
+ ### 可直接在飞书处理
33
+
34
+ - 轻量问答。
35
+ - 方案初评。
36
+ - 任务分派。
37
+ - 日报 / 周报 / 进度同步。
38
+ - 文档摘要。
39
+
40
+ ### 必须绑定项目工作区
41
+
42
+ - 修改代码。
43
+ - 跑测试。
44
+ - 构建或部署。
45
+ - 读取私有仓库结构。
46
+ - 生成 PR。
47
+ - 访问项目密钥、数据库或生产系统。
48
+
49
+ ## 路由规则
50
+
51
+ 1. 飞书收到任务后,先判断是否需要项目工作区。
52
+ 2. 不需要工作区的,直接路由到 Hermes Agent。
53
+ 3. 需要工作区的,必须绑定具体项目,再由本地 Codex / Gemini / OpenClaw 执行。
54
+ 4. 执行结果回传飞书,但验证证据必须来自项目工作区。
55
+
56
+ ## 风险控制
57
+
58
+ - 飞书消息不应包含密钥、生产凭据和敏感数据。
59
+ - 未绑定项目工作区时,不允许声称已修改代码或完成测试。
60
+ - Hephaestus 类执行任务必须有明确范围和验证命令。
@@ -0,0 +1,48 @@
1
+ # Sync From Agents
2
+
3
+ ## 定位
4
+
5
+ 本文件定义从仓库 Agent 资产同步到 Hermes Runtime Prompt 的规则。
6
+
7
+ 目标是避免 Hermes 中的 prompt 与仓库源文件漂移。
8
+
9
+ ## 同步来源
10
+
11
+ | Agent | Source | Runtime Prompt |
12
+ | --- | --- | --- |
13
+ | Atlas | `agents/atlas/` | `agents/atlas/system-prompt.md` |
14
+ | Mason | `agents/mason/` | `agents/mason/system-prompt.md` |
15
+ | Argus | `agents/argus/` | `agents/argus/system-prompt.md` |
16
+ | Vitruvius | `agents/vitruvius/` | `agents/vitruvius/system-prompt.md` |
17
+ | Daedalus | `agents/daedalus/` | `agents/daedalus/system-prompt.md` |
18
+ | Hephaestus | `agents/hephaestus/` | `agents/hephaestus/system-prompt.md` |
19
+ | Euclid | `agents/euclid/` | `agents/euclid/system-prompt.md` |
20
+ | Athena | `agents/athena/` | `agents/athena/system-prompt.md` |
21
+ | Mercury | `agents/mercury/` | `agents/mercury/system-prompt.md` |
22
+ | Janus | `agents/janus/` | `agents/janus/system-prompt.md` |
23
+
24
+ ## 同步步骤
25
+
26
+ 1. 修改 `agents/{agent}/` 下的 Source 文件。
27
+ 2. 更新 `agents/{agent}/system-prompt.md`。
28
+ 3. 评审角色边界是否仍然清晰。
29
+ 4. 将 `system-prompt.md` 复制到 Hermes Agent。
30
+ 5. 记录 Source commit、同步时间和回滚方式。
31
+
32
+ ## 同步检查清单
33
+
34
+ - [ ] Runtime Prompt 没有依赖完整角色文件夹。
35
+ - [ ] Boundaries 明确。
36
+ - [ ] Input / Output 明确。
37
+ - [ ] Collaboration 升级路径明确。
38
+ - [ ] 没有把 Skill 逻辑硬塞进 Agent 身份。
39
+ - [ ] 没有把项目私有信息写入通用 Agent Prompt。
40
+
41
+ ## 回滚
42
+
43
+ 如果 Hermes Agent 表现漂移:
44
+
45
+ 1. 找到最近一次同步记录。
46
+ 2. 回滚到上一版 `system-prompt.md`。
47
+ 3. 在仓库中记录失败原因。
48
+ 4. 必要时调整 Agent Source 或相关 Skill。
@@ -0,0 +1,20 @@
1
+ # Hermes Sync Policy
2
+
3
+ ## 目标
4
+
5
+ 启用 Hermes Adapter 时,Hermes Agent 的运行时 Prompt 必须从仓库受控资产同步,避免控制台漂移。
6
+
7
+ 未启用 Hermes 的项目不需要执行本流程;它们仍应通过本地项目入口、`.ai/` 上下文、Skill、Workflow 和验证命令完成治理闭环。
8
+
9
+ ## 本地流程
10
+
11
+ 1. 修改 `agents/{agent}/` Source 文件。
12
+ 2. 更新 `agents/{agent}/system-prompt.md`。
13
+ 3. 运行 `archsight-aios hermes:validate`。
14
+ 4. 运行 `archsight-aios hermes:sync-dry-run`。
15
+ 5. 人工或外部集成执行真实同步。
16
+ 6. 按 `sync-record-template.md` 记录同步结果。
17
+
18
+ ## 漂移检测
19
+
20
+ 本地 `hermes:detect-drift` 只检查仓库内 Source / Runtime Prompt 的可同步状态。真实 Hermes 控制台漂移检测需要未来接入 API 后补充。
@@ -0,0 +1,18 @@
1
+ # Hermes Sync Record Template
2
+
3
+ ```text
4
+ Agent:
5
+ Source commit:
6
+ Prompt path:
7
+ Prompt hash:
8
+ 同步时间:
9
+ 同步人:
10
+ 目标环境:
11
+ 变更摘要:
12
+ 验证命令:
13
+ 回滚方式:
14
+ 结果:
15
+ ```
16
+
17
+ 同步记录应保存到项目决策记录或团队运行日志中,不应包含密钥、私有数据或完整用户对话。
18
+
@@ -0,0 +1,55 @@
1
+ # Workspace Binding
2
+
3
+ ## 定位
4
+
5
+ Workspace Binding 定义启用 Hermes / 飞书 Adapter 时,任务如何绑定到具体项目工作区。
6
+
7
+ 没有绑定工作区时,Hermes 只能做咨询、计划和摘要;不能执行代码修改、测试或部署。
8
+
9
+ ## 绑定信息
10
+
11
+ 每个项目至少需要:
12
+
13
+ ```text
14
+ 项目名称:
15
+ 仓库路径:
16
+ 默认分支:
17
+ 项目入口文档:
18
+ 常用命令:
19
+ 可用 Skills:
20
+ 可用 Workflows:
21
+ 权限边界:
22
+ 人工确认人:
23
+ ```
24
+
25
+ ## 推荐项目结构
26
+
27
+ 业务项目应复制:
28
+
29
+ ```text
30
+ templates/project-ai/
31
+ ├── AGENTS.md
32
+ ├── GEMINI.md
33
+ └── .ai/
34
+ ├── project-context.md
35
+ ├── agent-routing.md
36
+ ├── skills.md
37
+ └── workflows.md
38
+ ```
39
+
40
+ ## 执行流程
41
+
42
+ 1. 飞书或 Hermes 接收任务。
43
+ 2. 判断是否需要项目工作区。
44
+ 3. 读取项目 `.ai/project-context.md`。
45
+ 4. 选择 Workflow 和 Skill。
46
+ 5. 在项目工作区执行。
47
+ 6. 运行验证。
48
+ 7. 回传结果和证据。
49
+
50
+ ## 禁止事项
51
+
52
+ - 不在未绑定项目时执行代码任务。
53
+ - 不把 AIOS 仓库误当成业务项目仓库。
54
+ - 不把飞书聊天记录当作完整项目上下文。
55
+ - 不跳过项目本地测试和构建。