@archsight/aios 1.0.0 → 1.1.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 (54) hide show
  1. package/CHANGELOG.md +80 -8
  2. package/LICENSE +184 -21
  3. package/README.md +163 -135
  4. package/agents/README.md +2 -1
  5. package/agents/euclid/constraints.md +2 -1
  6. package/agents/euclid/responsibilities.md +1 -1
  7. package/agents/euclid/role.md +1 -1
  8. package/agents/euclid/system-prompt.md +5 -2
  9. package/agents/euclid/workflow.md +3 -3
  10. package/bin/archsight-aios.mjs +436 -1
  11. package/docs/quickstart.md +2 -1
  12. package/governance/README.md +3 -0
  13. package/governance/arbitration-protocol.md +153 -0
  14. package/package.json +68 -68
  15. package/runtime/README.md +7 -0
  16. package/runtime/agent-routing.md +98 -72
  17. package/runtime/archsight-aios.manifest.json +312 -290
  18. package/runtime/capability-adapters.json +27 -0
  19. package/runtime/capability-registry.json +458 -0
  20. package/runtime/capability-registry.schema.json +135 -0
  21. package/runtime/skill-routing.md +61 -55
  22. package/skills/README.md +54 -30
  23. package/skills/aios-arch/SKILL.md +195 -149
  24. package/skills/aios-arch/agents/openai.yaml +3 -3
  25. package/skills/aios-ceo/SKILL.md +180 -89
  26. package/skills/aios-ceo/agents/openai.yaml +4 -4
  27. package/skills/aios-design/SKILL.md +107 -99
  28. package/skills/aios-design/agents/openai.yaml +4 -4
  29. package/skills/aios-exec/SKILL.md +69 -58
  30. package/skills/aios-exec/agents/openai.yaml +3 -3
  31. package/skills/aios-knowledge/SKILL.md +65 -54
  32. package/skills/aios-knowledge/agents/openai.yaml +3 -3
  33. package/skills/aios-plan/SKILL.md +93 -75
  34. package/skills/aios-plan/agents/openai.yaml +3 -3
  35. package/skills/aios-review/SKILL.md +72 -61
  36. package/skills/aios-review/agents/openai.yaml +3 -3
  37. package/skills/aios-runtime/SKILL.md +69 -58
  38. package/skills/aios-runtime/agents/openai.yaml +3 -3
  39. package/skills/aios-structural/SKILL.md +67 -0
  40. package/skills/aios-structural/agents/openai.yaml +4 -0
  41. package/templates/project-ai/.ai/ARCHSIGHT_AIOS_RULES.md +30 -25
  42. package/templates/project-ai/.ai/agent-routing.md +48 -42
  43. package/templates/project-ai/.ai/skills.md +38 -32
  44. package/templates/project-ai/.ai/workflows.md +38 -35
  45. package/templates/project-ai/AGENTS.md +25 -25
  46. package/templates/project-ai/CLAUDE.md +25 -25
  47. package/templates/project-ai/GEMINI.md +25 -25
  48. package/workflows/README.md +2 -0
  49. package/workflows/architecture-review.md +103 -79
  50. package/workflows/bug-fixing.md +63 -62
  51. package/workflows/code-review.md +55 -54
  52. package/workflows/feature-development.md +64 -56
  53. package/workflows/rag-pipeline.md +9 -5
  54. package/workflows/review.md +74 -70
@@ -1,25 +1,25 @@
1
- # CLAUDE.md
2
-
3
- > 本文件供 Claude Code 在当前业务项目中读取项目 AI 规则。
4
- > 通用编码规则只维护在 `AI_CODING_RULES.md`,本文件不复制规则正文。
5
-
6
- ## 必读入口
7
-
8
- 开始任何工作前,先阅读:
9
-
10
- - `AI_CODING_RULES.md`
11
- - `.ai/ARCHSIGHT_AIOS_RULES.md`
12
- - `.ai/project-context.md`
13
- - `.ai/agent-routing.md`
14
- - `.ai/skills.md`
15
- - `.ai/workflows.md`
16
- - `.ai/profiles/*.md`(如当前项目启用了 profile)
17
- - 项目自身的 `README.md`、`Makefile`、`scripts/` 或其他工程入口。
18
-
19
- ## Claude Code 入口适配
20
-
21
- - 本文件只负责让 Claude Code 发现当前项目的公共规则和 `.ai/` 目录。
22
- - ArchSight AIOS 只在 Agent 路由、Skill 选择、Workflow、交付验证、AI Runtime、Code Review,以及项目明确启用的 BIM / IFC / 建筑行业 profile 等相关任务中作为补充治理层生效。
23
- - 接入本模板不代表当前项目属于 ArchSightLabs,也不要求使用 Hermes、飞书或其他特定运行平台。
24
- - 任务适合 ArchSight 技能包时,按 `.ai/skills.md` 选择对应 `aios-*` Skill;涉及流程协作时,按 `.ai/workflows.md` 选择 Workflow。
25
- - 无法确认的行业知识、规范条文或运行时配置,应标注待核验。
1
+ # CLAUDE.md
2
+
3
+ > 本文件供 Claude Code 在当前业务项目中读取项目 AI 规则。
4
+ > 通用编码规则只维护在 `AI_CODING_RULES.md`,本文件不复制规则正文。
5
+
6
+ ## 必读入口
7
+
8
+ 开始任何工作前,先阅读:
9
+
10
+ - `AI_CODING_RULES.md`
11
+ - `.ai/ARCHSIGHT_AIOS_RULES.md`
12
+ - `.ai/project-context.md`
13
+ - `.ai/agent-routing.md`
14
+ - `.ai/skills.md`
15
+ - `.ai/workflows.md`
16
+ - `.ai/profiles/*.md`(如当前项目启用了 profile)
17
+ - 项目自身的 `README.md`、`Makefile`、`scripts/` 或其他工程入口。
18
+
19
+ ## Claude Code 入口适配
20
+
21
+ - 本文件只负责让 Claude Code 发现当前项目的公共规则和 `.ai/` 目录。
22
+ - ArchSight AIOS 只在 Agent 路由、Skill 选择、Workflow、交付验证、AI Runtime、Code Review,以及项目明确启用的 BIM / IFC / 建筑行业 profile 等相关任务中作为补充治理层生效;普通非建筑任务不强制使用 `aios-*` Skill。
23
+ - 接入本模板不代表当前项目属于 ArchSightLabs,也不要求使用 Hermes、飞书或其他特定运行平台。
24
+ - 任务适合 ArchSight 技能包时,按 `.ai/skills.md` 选择对应 `aios-*` Skill;涉及流程协作时,按 `.ai/workflows.md` 选择 Workflow。
25
+ - 无法确认的行业知识、规范条文或运行时配置,应标注待核验。
@@ -1,25 +1,25 @@
1
- # GEMINI.md
2
-
3
- > 本文件供 Gemini 在当前业务项目中读取项目 AI 规则。
4
- > 通用编码规则只维护在 `AI_CODING_RULES.md`,本文件不复制规则正文。
5
-
6
- ## 必读入口
7
-
8
- 开始任何工作前,先阅读:
9
-
10
- - `AI_CODING_RULES.md`
11
- - `.ai/ARCHSIGHT_AIOS_RULES.md`
12
- - `.ai/project-context.md`
13
- - `.ai/agent-routing.md`
14
- - `.ai/skills.md`
15
- - `.ai/workflows.md`
16
- - `.ai/profiles/*.md`(如当前项目启用了 profile)
17
- - 项目自身的 `README.md`、`Makefile`、`scripts/` 或其他工程入口。
18
-
19
- ## Gemini 入口适配
20
-
21
- - 本文件只负责让 Gemini 发现当前项目的公共规则和 `.ai/` 目录。
22
- - ArchSight AIOS 只在 Agent 路由、Skill 选择、Workflow、交付验证、AI Runtime、Code Review,以及项目明确启用的 BIM / IFC / 建筑行业 profile 等相关任务中作为补充治理层生效。
23
- - 接入本模板不代表当前项目属于 ArchSightLabs,也不要求使用 Hermes、飞书或其他特定运行平台。
24
- - 任务适合 ArchSight 技能包时,按 `.ai/skills.md` 选择对应 `aios-*` Skill;涉及流程协作时,按 `.ai/workflows.md` 选择 Workflow。
25
- - 使用浏览器或外部工具前,先说明目的;操作后汇报结果。
1
+ # GEMINI.md
2
+
3
+ > 本文件供 Gemini 在当前业务项目中读取项目 AI 规则。
4
+ > 通用编码规则只维护在 `AI_CODING_RULES.md`,本文件不复制规则正文。
5
+
6
+ ## 必读入口
7
+
8
+ 开始任何工作前,先阅读:
9
+
10
+ - `AI_CODING_RULES.md`
11
+ - `.ai/ARCHSIGHT_AIOS_RULES.md`
12
+ - `.ai/project-context.md`
13
+ - `.ai/agent-routing.md`
14
+ - `.ai/skills.md`
15
+ - `.ai/workflows.md`
16
+ - `.ai/profiles/*.md`(如当前项目启用了 profile)
17
+ - 项目自身的 `README.md`、`Makefile`、`scripts/` 或其他工程入口。
18
+
19
+ ## Gemini 入口适配
20
+
21
+ - 本文件只负责让 Gemini 发现当前项目的公共规则和 `.ai/` 目录。
22
+ - ArchSight AIOS 只在 Agent 路由、Skill 选择、Workflow、交付验证、AI Runtime、Code Review,以及项目明确启用的 BIM / IFC / 建筑行业 profile 等相关任务中作为补充治理层生效;普通非建筑任务不强制使用 `aios-*` Skill。
23
+ - 接入本模板不代表当前项目属于 ArchSightLabs,也不要求使用 Hermes、飞书或其他特定运行平台。
24
+ - 任务适合 ArchSight 技能包时,按 `.ai/skills.md` 选择对应 `aios-*` Skill;涉及流程协作时,按 `.ai/workflows.md` 选择 Workflow。
25
+ - 使用浏览器或外部工具前,先说明目的;操作后汇报结果。
@@ -17,3 +17,5 @@
17
17
  - spec driven development
18
18
 
19
19
  每个 workflow 应明确参与角色、输入、输出、执行顺序、验收标准和回滚策略。
20
+
21
+ 涉及多 Agent 冲突、规范证据、结构计算、安全扫描、测试门禁或 Runtime 权限时,Workflow 还应输出 `Claim / Evidence / Tool Result / Decision`,并按 [Capability-Backed Arbitration Protocol](../governance/arbitration-protocol.md) 仲裁。
@@ -1,98 +1,122 @@
1
- # 架构评审 Workflow
2
-
3
- ## 定位
4
-
5
- 用于在实现前评估系统架构、服务边界、技术选型、数据模型、Runtime、RAG / GraphRAG 和长期复杂度。
6
-
7
- ## 触发场景
8
-
9
- - 新系统、新模块或核心服务设计。
10
- - 服务拆分、数据模型、存储组件或技术栈调整。
11
- - Hermes / OpenClaw / Agent Runtime 重大变化。
12
- - RAG / GraphRAG、知识图谱或 BIM / IFC 模块边界设计。
13
-
14
- ## 参与角色与 Skill
15
-
16
- | 阶段 | 主 Agent | Skill |
17
- | --- | --- | --- |
18
- | 架构判断 | Atlas | `aios-arch` |
1
+ # 架构评审 Workflow
2
+
3
+ ## 定位
4
+
5
+ 用于在实现前评估系统架构、服务边界、技术选型、数据模型、Runtime、RAG / GraphRAG 和长期复杂度。
6
+
7
+ Workflow 面向建筑行业项目的架构评审增强。普通非建筑架构评审优先使用宿主工具的通用架构能力;只有项目 profile、上下文或任务事实涉及建筑行业语义、工程知识、RAG / GraphRAG、审图、证据链、人工复核或审计留痕时,才启用 `aios-*` 行业增强。
8
+
9
+ ## 触发场景
10
+
11
+ - 新系统、新模块或核心服务设计。
12
+ - 服务拆分、数据模型、存储组件或技术栈调整。
13
+ - Hermes / OpenClaw / Agent Runtime 重大变化。
14
+ - RAG / GraphRAG、知识图谱或 BIM / IFC 模块边界设计。
15
+
16
+ ## 参与角色与 Skill
17
+
18
+ | 阶段 | Agent | Skill |
19
+ | --- | --- | --- |
20
+ | 架构判断 | Atlas | `aios-arch` |
19
21
  | 工程拆解 | Mason | `aios-plan` |
20
22
  | Runtime 设计 | Daedalus | `aios-runtime` |
21
23
  | 行业语义 | Vitruvius | `aios-knowledge` |
24
+ | 结构力学 / 求解链路 | Euclid | `aios-structural` |
22
25
  | 风险审查 | Argus | `aios-review` |
23
-
24
- ## 输入
25
-
26
- - 背景和目标。
27
- - 当前架构、目录、模块和数据结构。
28
- - 现有代码、配置、接口契约、测试、脚本、部署入口和运行方式。
26
+
27
+ ## 输入
28
+
29
+ - 背景和目标。
30
+ - 当前架构、目录、模块和数据结构。
31
+ - 现有代码、配置、接口契约、测试、脚本、部署入口和运行方式。
29
32
  - 候选方案。
30
33
  - 约束:成本、时间、团队、运行环境、权限、数据规模。
31
34
  - 已知风险和历史决策。
32
-
33
- ## 执行顺序
34
-
35
- 1. Atlas 明确问题类型和评审边界。
36
- 2. Atlas 基于现有代码、配置、契约、测试、脚本和部署入口核验事实;文档结论必须能回到项目事实。
37
- 3. Atlas 做范围挑战,明确当前评审接受的范围和不在范围内的扩展项。
38
- 4. Atlas 盘点已有能力,确认应复用的模块、契约、测试和脚本。
39
- 5. Atlas 做端到端链路抽样:对关键用户输入、配置字段、领域元数据、版本关系、审计关系或跨存储关系,至少追踪一条从 UI / API / CLI 入口到领域模型、后台任务、存储、检索/消费端和测试的完整路径。
40
- 6. Atlas 对候选方案做 tradeoff,识别复杂度、技术债、生产失效方式和长期迁移成本。
35
+ - 可用 Capability、工具返回值、测试 / 构建 / 规范查询 / 求解器证据。
36
+
37
+ ## 执行顺序
38
+
39
+ 1. Atlas 明确问题类型和评审边界。
40
+ 2. Atlas 基于现有代码、配置、契约、测试、脚本和部署入口核验事实;文档结论必须能回到项目事实。
41
+ 3. Atlas 做范围挑战,明确当前评审接受的范围和不在范围内的扩展项。
42
+ 4. Atlas 盘点已有能力,确认应复用的模块、契约、测试和脚本。
43
+ 5. Atlas 做端到端链路抽样:对关键用户输入、配置字段、领域元数据、版本关系、审计关系或跨存储关系,至少追踪一条从 UI / API / CLI 入口到领域模型、后台任务、存储、检索/消费端和测试的完整路径。
44
+ 6. Atlas 对候选方案做 tradeoff,识别复杂度、技术债、生产失效方式和长期迁移成本。
41
45
  7. Atlas 用 P0/P1/P2 或等效等级标注风险优先级,形成架构依据。
42
46
  8. Daedalus 评审 AI Runtime / RAG / Tool / Memory 相关设计。
43
47
  9. Vitruvius 评审 BIM / IFC / 建筑规范相关语义。
44
- 10. Argus 评审安全、权限、Prompt 注入、依赖和发布风险。
45
- 11. Mason 将通过评审的方案拆成可执行任务,并纳入 Failure Modes、测试缺口、并行 workstream 和冲突点。
46
-
47
- ## 输出
48
-
49
- 1. 结论
50
- 2. 架构判断
51
- 3. 风险与边界
52
- 4. 推荐方案
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 和冲突点。
53
+
54
+ ## 输出
55
+
56
+ 1. 结论
57
+ 2. 架构判断
58
+ 3. 风险与边界
59
+ 4. 推荐方案
53
60
  5. Rejected 方案
54
61
  6. Assumption / Need verify
55
62
  7. Failure Modes
56
- 8. 后续执行任务
57
-
58
- ## 文档与补充检查
59
-
60
- 当架构评审需要审阅设计文档、对比多份评审或整合补充检查项时:
61
-
62
- - 先回到现有代码、配置、接口契约、测试、脚本和部署入口核验事实。
63
- - 再判断各检查项的定位:架构依据、工程计划、代码审查、测试计划或风险清单。
64
- - 架构依据优先采纳边界判断、风险分级、长期演进和被拒绝方案。
65
- - 工程计划优先采纳 Failure Modes、测试缺口、并行 workstream、冲突标记和回归命令。
66
- - 纠正文档中的细节错误,例如 Assumption 与 Need verify 数量混淆。
67
- - 对“未覆盖”的判断要谨慎:如果已有评审已触及某风险但未形成完整策略,应写成“已触及但未系统展开”。
63
+ 8. Claim / Evidence / Tool Result / Decision
64
+ 9. 后续执行任务
65
+ 10. 本次事实刷新
66
+ 11. 已过期判断 / 与既有报告 diff
67
+ 12. 第一小步建议
68
+
69
+ ## 文档与补充检查
70
+
71
+ 当架构评审需要审阅设计文档、对比多份评审或整合补充检查项时:
72
+
73
+ - 先回到现有代码、配置、接口契约、测试、脚本和部署入口核验事实。
74
+ - 再判断各检查项的定位:架构依据、工程计划、代码审查、测试计划或风险清单。
75
+ - 架构依据优先采纳边界判断、风险分级、长期演进和被拒绝方案。
76
+ - 工程计划优先采纳 Failure Modes、测试缺口、并行 workstream、冲突标记和回归命令。
77
+ - 纠正文档中的细节错误,例如 Assumption 与 Need verify 数量混淆。
78
+ - 对“未覆盖”的判断要谨慎:如果已有评审已触及某风险但未形成完整策略,应写成“已触及但未系统展开”。
68
79
  - 如果本次是“全新独立评审”,仍应建立历史高优先级发现的回归清单;清单只用于防止漏检,不要求继承旧报告结论。
69
80
  - 抽象发现不能吞掉具体断链。若某字段、关系或元数据已经被纳入更大的 P1/P2 主题,还必须说明是否完成端到端贯通;未贯通时应保留独立风险或验收项。
70
81
  - 对 RAG / GraphRAG、规范知识库和审计系统,重点抽查 `source_version`、适用地区、专业、生效状态、复核状态、版本替代关系、证据引用和缓存/索引版本是否从摄取入口贯通到消费端。
71
-
72
- ## 端到端链路抽样清单
73
-
74
- 架构评审至少抽查以下一类链路;涉及知识、审计或合规结论时应优先抽查多类:
75
-
76
- - 用户提交字段:页面表单、前端 API 封装、后端 DTO / query / form 参数、后台任务、领域模型、持久化和回显。
77
- - 领域关系:版本替代、引用关系、父子层级、任务到报告、报告到复核、事件到 outbox。
78
- - 知识元数据:来源、版本、地区、专业、生效状态、来源哈希、页码范围、质量状态和人工复核状态。
79
- - 运行期边界:配置变更、缓存 key、索引版本、任务状态、多实例共享和重启恢复。
80
-
81
- 输出要求:若链路断在任一层,应写清断点、静默失败方式、用户可见影响和最小回归测试。
82
-
83
- ## 升级与人工确认
84
-
85
- 以下情况必须人工确认:
86
-
87
- - 核心技术栈替换。
88
- - 生产数据模型迁移。
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
+ - 涉及生产授权、法规合规最终判断、结构安全结论或商业范围取舍时,升级给人类负责人。
94
+
95
+ ## 端到端链路抽样清单
96
+
97
+ 架构评审至少抽查以下一类链路;涉及知识、审计或合规结论时应优先抽查多类:
98
+
99
+ - 用户提交字段:页面表单、前端 API 封装、后端 DTO / query / form 参数、后台任务、领域模型、持久化和回显。
100
+ - 领域关系:版本替代、引用关系、父子层级、任务到报告、报告到复核、事件到 outbox。
101
+ - 知识元数据:来源、版本、地区、专业、生效状态、来源哈希、页码范围、质量状态和人工复核状态。
102
+ - 运行期边界:配置变更、缓存 key、索引版本、任务状态、多实例共享和重启恢复。
103
+
104
+ 输出要求:若链路断在任一层,应写清断点、静默失败方式、用户可见影响和最小回归测试。
105
+
106
+ ## 升级与人工确认
107
+
108
+ 以下情况必须人工确认:
109
+
110
+ - 核心技术栈替换。
111
+ - 生产数据模型迁移。
89
112
  - Runtime 权限扩大。
90
113
  - 自动执行权限放开。
91
114
  - 影响长期平台路线的服务边界调整。
92
-
93
- ## 验收标准
94
-
95
- - 推荐方案有明确边界和取舍。
96
- - 被拒绝方案有原因。
97
- - 后续任务可被 Mason 拆解。
98
- - 不确定项和待验证项被显式记录。
115
+ - 法规合规最终判定和结构安全结论。
116
+
117
+ ## 验收标准
118
+
119
+ - 推荐方案有明确边界和取舍。
120
+ - 被拒绝方案有原因。
121
+ - 后续任务可被 Mason 拆解。
122
+ - 不确定项和待验证项被显式记录。
@@ -1,62 +1,63 @@
1
- # Bug 修复 Workflow
2
-
3
- ## 定位
4
-
5
- 用于处理缺陷、测试失败、构建失败和生产风险修复。目标是先复现或定位,再做最小修复,最后用证据验证。
6
-
7
- ## 触发场景
8
-
9
- - 用户报告 bug。
10
- - 测试、构建、lint 或类型检查失败。
11
- - AI 生成代码导致行为回归。
12
- - 生产或预发布环境发现异常。
13
-
14
- ## 参与角色与 Skill
15
-
16
- | 阶段 | 主 Agent | Skill |
17
- | --- | --- | --- |
18
- | 风险识别 | Argus | `aios-review` |
19
- | 架构影响判断 | Atlas | `aios-arch` |
20
- | 修复计划 | Mason | `aios-plan` |
21
- | 受控修复 | Hephaestus | `aios-exec` |
22
- | Runtime 相关缺陷 | Daedalus | `aios-runtime` |
23
- | 行业语义缺陷 | Vitruvius | `aios-knowledge` |
24
-
25
- ## 输入
26
-
27
- - 错误现象、日志、截图或复现步骤。
28
- - 失败命令和输出。
29
- - 最近变更、diff 或 PR。
30
- - 预期行为和实际行为。
31
-
32
- ## 执行顺序
33
-
34
- 1. Argus 判断缺陷风险级别和可能影响面。
35
- 2. Hephaestus 尝试复现或定位最小失败点。
36
- 3. Atlas 判断是否涉及架构边界或数据模型问题。
37
- 4. Mason 拆解修复步骤、验证路径和回滚策略。
38
- 5. Hephaestus 执行最小修复。
39
- 6. Argus 复核修复是否引入新风险。
40
-
41
- ## 修复原则
42
-
43
- - 优先复现,再修改。
44
- - 优先最小修复,不顺手重构。
45
- - 优先补回归测试;没有测试条件时记录人工验证。
46
- - 不通过删除测试、降低校验或吞错来制造“通过”。
47
-
48
- ## 输出
49
-
50
- - 根因判断。
51
- - 修复范围。
52
- - 修改文件。
53
- - 验证命令和结果。
54
- - 剩余风险。
55
-
56
- ## 验收标准
57
-
58
- - 原失败路径已通过验证。
59
- - 相关回归路径已检查。
60
- - 没有扩大改动范围。
61
- - Argus 无阻断问题。
62
-
1
+ # Bug 修复 Workflow
2
+
3
+ ## 定位
4
+
5
+ 用于处理缺陷、测试失败、构建失败和生产风险修复。目标是先复现或定位,再做最小修复,最后用证据验证。
6
+
7
+ Workflow 面向建筑行业项目的缺陷修复增强。普通非建筑 bug 修复优先使用宿主工具的通用调试和修复能力;只有项目 profile、上下文或任务事实涉及建筑行业语义、工程知识、RAG / GraphRAG、审图、证据链、人工复核或审计留痕时,才启用 `aios-*` 行业增强。
8
+
9
+ ## 触发场景
10
+
11
+ - 用户报告 bug。
12
+ - 测试、构建、lint 或类型检查失败。
13
+ - AI 生成代码导致行为回归。
14
+ - 生产或预发布环境发现异常。
15
+
16
+ ## 参与角色与 Skill
17
+
18
+ | 阶段 | Agent | Skill |
19
+ | --- | --- | --- |
20
+ | 风险识别 | Argus | `aios-review` |
21
+ | 架构影响判断 | Atlas | `aios-arch` |
22
+ | 修复计划 | Mason | `aios-plan` |
23
+ | 受控修复 | Hephaestus | `aios-exec` |
24
+ | Runtime 相关缺陷 | Daedalus | `aios-runtime` |
25
+ | 行业语义缺陷 | Vitruvius | `aios-knowledge` |
26
+
27
+ ## 输入
28
+
29
+ - 错误现象、日志、截图或复现步骤。
30
+ - 失败命令和输出。
31
+ - 最近变更、diff 或 PR。
32
+ - 预期行为和实际行为。
33
+
34
+ ## 执行顺序
35
+
36
+ 1. Argus 判断缺陷风险级别和可能影响面。
37
+ 2. Hephaestus 尝试复现或定位最小失败点。
38
+ 3. Atlas 判断是否涉及架构边界或数据模型问题。
39
+ 4. Mason 拆解修复步骤、验证路径和回滚策略。
40
+ 5. Hephaestus 执行最小修复。
41
+ 6. Argus 复核修复是否引入新风险。
42
+
43
+ ## 修复原则
44
+
45
+ - 优先复现,再修改。
46
+ - 优先最小修复,不顺手重构。
47
+ - 优先补回归测试;没有测试条件时记录人工验证。
48
+ - 不通过删除测试、降低校验或吞错来制造“通过”。
49
+
50
+ ## 输出
51
+
52
+ - 根因判断。
53
+ - 修复范围。
54
+ - 修改文件。
55
+ - 验证命令和结果。
56
+ - 剩余风险。
57
+
58
+ ## 验收标准
59
+
60
+ - 原失败路径已通过验证。
61
+ - 相关回归路径已检查。
62
+ - 没有扩大改动范围。
63
+ - Argus 无阻断问题。
@@ -1,54 +1,55 @@
1
- # Code Review Workflow
2
-
3
- ## 定位
4
-
5
- 用于 PR、diff、AI 生成代码、Runtime 配置、Prompt、Tool Calling 和发布前质量审查。
6
-
7
- ## 触发场景
8
-
9
- - PR 合并前。
10
- - AI 生成代码进入仓库。
11
- - 涉及权限、安全、依赖、Runtime 或生产发布。
12
- - 大范围重构或多模块变更。
13
-
14
- ## 参与角色与 Skill
15
-
16
- | 阶段 | 主 Agent | Skill |
17
- | --- | --- | --- |
18
- | 质量审查 | Argus | `aios-review` |
19
- | 架构边界复核 | Atlas | `aios-arch` |
20
- | 修复执行 | Hephaestus | `aios-exec` |
21
- | 交付协调 | Mason | `aios-plan` |
22
- | Runtime 风险 | Daedalus | `aios-runtime` |
23
-
24
- ## 输入
25
-
26
- - diff / PR / commit。
27
- - 需求背景和验收标准。
28
- - 测试、构建、lint、typecheck 输出。
29
- - 权限、Runtime、Prompt 或 Tool 配置。
30
-
31
- ## 执行顺序
32
-
33
- 1. Argus 先看需求和预期行为,再审查 diff。
34
- 2. Argus 按 P0-P3 输出问题,先列阻断项。
35
- 3. Atlas 复核架构边界问题。
36
- 4. Daedalus 复核 Runtime / MCP / Memory / Prompt 风险。
37
- 5. Hephaestus 修复明确问题。
38
- 6. Argus 复审。
39
-
40
- ## 输出
41
-
42
- - 阻断问题。
43
- - 非阻断建议。
44
- - 测试缺口。
45
- - 剩余风险。
46
- - 合并或发布建议。
47
-
48
- ## 验收标准
49
-
50
- - 阻断问题已修复或明确不发布。
51
- - 测试缺口被补齐或记录。
52
- - 没有无关风格挑刺。
53
- - 没有未经验证的完成声明。
54
-
1
+ # Code Review Workflow
2
+
3
+ ## 定位
4
+
5
+ 用于 PR、diff、AI 生成代码、Runtime 配置、Prompt、Tool Calling 和发布前质量审查。
6
+
7
+ Workflow 面向建筑行业项目的 code review 增强。普通非建筑代码审查优先使用宿主工具的通用 review 能力;只有项目 profile、上下文或任务事实涉及建筑行业语义、工程知识、RAG / GraphRAG、审图、证据链、人工复核或审计留痕时,才启用 `aios-*` 行业增强。
8
+
9
+ ## 触发场景
10
+
11
+ - PR 合并前。
12
+ - AI 生成代码进入仓库。
13
+ - 涉及权限、安全、依赖、Runtime 或生产发布。
14
+ - 大范围重构或多模块变更。
15
+
16
+ ## 参与角色与 Skill
17
+
18
+ | 阶段 | Agent | Skill |
19
+ | --- | --- | --- |
20
+ | 质量审查 | Argus | `aios-review` |
21
+ | 架构边界复核 | Atlas | `aios-arch` |
22
+ | 修复执行 | Hephaestus | `aios-exec` |
23
+ | 交付协调 | Mason | `aios-plan` |
24
+ | Runtime 风险 | Daedalus | `aios-runtime` |
25
+
26
+ ## 输入
27
+
28
+ - diff / PR / commit。
29
+ - 需求背景和验收标准。
30
+ - 测试、构建、lint、typecheck 输出。
31
+ - 权限、Runtime、Prompt 或 Tool 配置。
32
+
33
+ ## 执行顺序
34
+
35
+ 1. Argus 先看需求和预期行为,再审查 diff。
36
+ 2. Argus P0-P3 输出问题,先列阻断项。
37
+ 3. Atlas 复核架构边界问题。
38
+ 4. Daedalus 复核 Runtime / MCP / Memory / Prompt 风险。
39
+ 5. Hephaestus 修复明确问题。
40
+ 6. Argus 复审。
41
+
42
+ ## 输出
43
+
44
+ - 阻断问题。
45
+ - 非阻断建议。
46
+ - 测试缺口。
47
+ - 剩余风险。
48
+ - 合并或发布建议。
49
+
50
+ ## 验收标准
51
+
52
+ - 阻断问题已修复或明确不发布。
53
+ - 测试缺口被补齐或记录。
54
+ - 没有无关风格挑刺。
55
+ - 没有未经验证的完成声明。