anyone-can-architect 0.2.0 → 0.3.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 (124) hide show
  1. package/README.md +6 -4
  2. package/README.zh-CN.md +4 -2
  3. package/VERSION +1 -1
  4. package/axioms/README.md +1 -1
  5. package/axioms/writing.md +1 -1
  6. package/dist/antigravity/aca/SKILL.md +3 -2
  7. package/dist/antigravity/aca-design/SKILL.md +1 -1
  8. package/dist/antigravity/aca-implement/SKILL.md +90 -109
  9. package/dist/antigravity/aca-release/SKILL.md +4 -3
  10. package/dist/antigravity/aca-repo-audit/SKILL.md +11 -9
  11. package/dist/antigravity/aca-review/SKILL.md +114 -115
  12. package/dist/antigravity/aca-test/SKILL.md +110 -0
  13. package/dist/antigravity/aca-walkthrough/SKILL.md +1 -1
  14. package/dist/antigravity-cli/aca/SKILL.md +3 -2
  15. package/dist/antigravity-cli/aca-design/SKILL.md +1 -1
  16. package/dist/antigravity-cli/aca-implement/SKILL.md +90 -109
  17. package/dist/antigravity-cli/aca-release/SKILL.md +4 -3
  18. package/dist/antigravity-cli/aca-repo-audit/SKILL.md +11 -9
  19. package/dist/antigravity-cli/aca-review/SKILL.md +114 -115
  20. package/dist/antigravity-cli/aca-test/SKILL.md +110 -0
  21. package/dist/antigravity-cli/aca-walkthrough/SKILL.md +1 -1
  22. package/dist/codex/aca/SKILL.md +3 -2
  23. package/dist/codex/aca-design/SKILL.md +1 -1
  24. package/dist/codex/aca-implement/SKILL.md +90 -109
  25. package/dist/codex/aca-release/SKILL.md +4 -3
  26. package/dist/codex/aca-repo-audit/SKILL.md +11 -9
  27. package/dist/codex/aca-review/SKILL.md +114 -115
  28. package/dist/codex/aca-test/SKILL.md +110 -0
  29. package/dist/codex/aca-walkthrough/SKILL.md +1 -1
  30. package/dist/cursor/aca/SKILL.md +3 -2
  31. package/dist/cursor/aca-design/SKILL.md +1 -1
  32. package/dist/cursor/aca-implement/SKILL.md +90 -109
  33. package/dist/cursor/aca-release/SKILL.md +4 -3
  34. package/dist/cursor/aca-repo-audit/SKILL.md +11 -9
  35. package/dist/cursor/aca-review/SKILL.md +114 -115
  36. package/dist/cursor/aca-test/SKILL.md +111 -0
  37. package/dist/cursor/aca-walkthrough/SKILL.md +1 -1
  38. package/dist/grok/aca/SKILL.md +3 -2
  39. package/dist/grok/aca-design/SKILL.md +1 -1
  40. package/dist/grok/aca-implement/SKILL.md +90 -109
  41. package/dist/grok/aca-release/SKILL.md +4 -3
  42. package/dist/grok/aca-repo-audit/SKILL.md +11 -9
  43. package/dist/grok/aca-review/SKILL.md +114 -115
  44. package/dist/grok/aca-test/SKILL.md +110 -0
  45. package/dist/grok/aca-walkthrough/SKILL.md +1 -1
  46. package/doc-design/document-sets/module.md +6 -2
  47. package/doc-design/documents/class-design.md +7 -4
  48. package/doc-design/documents/integration-guide.md +7 -5
  49. package/doc-design/documents/release.md +5 -3
  50. package/meta-skills/aca/SKILL.md +3 -2
  51. package/meta-skills/aca/SKILL.md.tmpl +3 -2
  52. package/package.json +1 -1
  53. package/skills/aca-design/SKILL.md +1 -1
  54. package/skills/aca-implement/SKILL.md +90 -109
  55. package/skills/aca-implement/SKILL.md.tmpl +91 -110
  56. package/skills/aca-release/SKILL.md +4 -3
  57. package/skills/aca-release/SKILL.md.tmpl +4 -3
  58. package/skills/aca-repo-audit/SKILL.md +11 -9
  59. package/skills/aca-repo-audit/SKILL.md.tmpl +10 -8
  60. package/skills/aca-review/SKILL.md +114 -115
  61. package/skills/aca-review/SKILL.md.tmpl +115 -116
  62. package/skills/aca-test/SKILL.md +110 -0
  63. package/skills/aca-test/SKILL.md.tmpl +108 -0
  64. package/skills/aca-walkthrough/SKILL.md +1 -1
  65. package/zh-CN/axioms/README.md +1 -1
  66. package/zh-CN/axioms/writing.md +1 -1
  67. package/zh-CN/dist/antigravity/aca/SKILL.md +3 -2
  68. package/zh-CN/dist/antigravity/aca-design/SKILL.md +1 -1
  69. package/zh-CN/dist/antigravity/aca-implement/SKILL.md +89 -108
  70. package/zh-CN/dist/antigravity/aca-release/SKILL.md +62 -52
  71. package/zh-CN/dist/antigravity/aca-repo-audit/SKILL.md +37 -29
  72. package/zh-CN/dist/antigravity/aca-review/SKILL.md +112 -113
  73. package/zh-CN/dist/antigravity/aca-test/SKILL.md +110 -0
  74. package/zh-CN/dist/antigravity/aca-walkthrough/SKILL.md +1 -1
  75. package/zh-CN/dist/antigravity-cli/aca/SKILL.md +3 -2
  76. package/zh-CN/dist/antigravity-cli/aca-design/SKILL.md +1 -1
  77. package/zh-CN/dist/antigravity-cli/aca-implement/SKILL.md +89 -108
  78. package/zh-CN/dist/antigravity-cli/aca-release/SKILL.md +62 -52
  79. package/zh-CN/dist/antigravity-cli/aca-repo-audit/SKILL.md +37 -29
  80. package/zh-CN/dist/antigravity-cli/aca-review/SKILL.md +112 -113
  81. package/zh-CN/dist/antigravity-cli/aca-test/SKILL.md +110 -0
  82. package/zh-CN/dist/antigravity-cli/aca-walkthrough/SKILL.md +1 -1
  83. package/zh-CN/dist/codex/aca/SKILL.md +3 -2
  84. package/zh-CN/dist/codex/aca-design/SKILL.md +1 -1
  85. package/zh-CN/dist/codex/aca-implement/SKILL.md +89 -108
  86. package/zh-CN/dist/codex/aca-release/SKILL.md +62 -52
  87. package/zh-CN/dist/codex/aca-repo-audit/SKILL.md +37 -29
  88. package/zh-CN/dist/codex/aca-review/SKILL.md +112 -113
  89. package/zh-CN/dist/codex/aca-test/SKILL.md +110 -0
  90. package/zh-CN/dist/codex/aca-walkthrough/SKILL.md +1 -1
  91. package/zh-CN/dist/cursor/aca/SKILL.md +3 -2
  92. package/zh-CN/dist/cursor/aca-design/SKILL.md +1 -1
  93. package/zh-CN/dist/cursor/aca-implement/SKILL.md +89 -108
  94. package/zh-CN/dist/cursor/aca-release/SKILL.md +62 -52
  95. package/zh-CN/dist/cursor/aca-repo-audit/SKILL.md +37 -29
  96. package/zh-CN/dist/cursor/aca-review/SKILL.md +112 -113
  97. package/zh-CN/dist/cursor/aca-test/SKILL.md +111 -0
  98. package/zh-CN/dist/cursor/aca-walkthrough/SKILL.md +1 -1
  99. package/zh-CN/dist/grok/aca/SKILL.md +3 -2
  100. package/zh-CN/dist/grok/aca-design/SKILL.md +1 -1
  101. package/zh-CN/dist/grok/aca-implement/SKILL.md +89 -108
  102. package/zh-CN/dist/grok/aca-release/SKILL.md +62 -52
  103. package/zh-CN/dist/grok/aca-repo-audit/SKILL.md +37 -29
  104. package/zh-CN/dist/grok/aca-review/SKILL.md +112 -113
  105. package/zh-CN/dist/grok/aca-test/SKILL.md +110 -0
  106. package/zh-CN/dist/grok/aca-walkthrough/SKILL.md +1 -1
  107. package/zh-CN/doc-design/document-sets/module.md +6 -2
  108. package/zh-CN/doc-design/documents/class-design.md +7 -4
  109. package/zh-CN/doc-design/documents/integration-guide.md +7 -5
  110. package/zh-CN/doc-design/documents/release.md +5 -3
  111. package/zh-CN/meta-skills/aca/SKILL.md +3 -2
  112. package/zh-CN/meta-skills/aca/SKILL.md.tmpl +3 -2
  113. package/zh-CN/skills/aca-design/SKILL.md +1 -1
  114. package/zh-CN/skills/aca-implement/SKILL.md +89 -108
  115. package/zh-CN/skills/aca-implement/SKILL.md.tmpl +89 -108
  116. package/zh-CN/skills/aca-release/SKILL.md +62 -52
  117. package/zh-CN/skills/aca-release/SKILL.md.tmpl +62 -52
  118. package/zh-CN/skills/aca-repo-audit/SKILL.md +37 -29
  119. package/zh-CN/skills/aca-repo-audit/SKILL.md.tmpl +36 -28
  120. package/zh-CN/skills/aca-review/SKILL.md +112 -113
  121. package/zh-CN/skills/aca-review/SKILL.md.tmpl +111 -112
  122. package/zh-CN/skills/aca-test/SKILL.md +110 -0
  123. package/zh-CN/skills/aca-test/SKILL.md.tmpl +108 -0
  124. package/zh-CN/skills/aca-walkthrough/SKILL.md +1 -1
@@ -43,8 +43,9 @@ flowchart TD
43
43
  | `/aca-specify` | 论证新增需求或优化既有设计,确认方案后衔接 Design |
44
44
  | `/aca-design` | 编写并检查当前范围的设计文档,确定下一范围或完成全局收口 |
45
45
  | `/aca-walkthrough` | 用业务语言导读设计文档,逐单元确认设计决定,发现的问题经确认后当场修正 |
46
- | `/aca-review` | 确定审查对象与范围,审查设计或核对实现是否符合设计,不修改受审文档与代码 |
47
- | `/aca-implement` | 按设计规划文件结构,按模块依赖实施并验证代码与测试 |
46
+ | `/aca-review` | 确定审查对象与范围,静态审查设计或代码与测试实现,不修改受审文档与代码,不运行代码 |
47
+ | `/aca-implement` | 按设计规划文件结构,按模块依赖编写生产代码与测试代码 |
48
+ | `/aca-test` | 根据当前实现范围或改动突破的设计边界,选取并运行最小化测试,只测不改 |
48
49
  | `/aca-repo-audit` | 检查仓库文档,按需核对实现,只读不改 |
49
50
  | `/aca-release` | 按仓库发布流程收口,合入 main 并锁定 annotated Tag |
50
51
  | `/aca-feedback` | 收集治理规则偏差,明确授权后提交 Issue |
@@ -22,7 +22,7 @@ description: 将已确认的方案或已核实的现状编写成完整设计文
22
22
  - 先交代整体,再展开细节,参见[金字塔原理](~/.grok/skills/aca/SSOT.md#2-文档结构)
23
23
  - 表达判断时,先给结论,再给依据
24
24
  - 不增加信息的标题层级应当合并
25
- - 有时序或优先级的条目用编号列表,每项有多个属性时属性缩进在该项下
25
+ - 有时序或优先级的条目用编号列表,包含子项时每步以加粗短语开头表达目的,具体操作与条件分支缩进在该步下
26
26
  - 表格只用于多行同构、每行有两个以上属性、行之间没有先后关系的内容
27
27
  - 列表项直接写完整的句子
28
28
  - 一个条目有分支时,将分支缩进列在该条目下
@@ -3,12 +3,11 @@ name: aca-implement
3
3
  description: |
4
4
  1. 根据设计设定实现目标与完成条件
5
5
  2. 根据模块边界与内部设计,规划源码和测试文件的职责与结构
6
- 3. 按模块依赖编排实施与验证任务
6
+ 3. 按模块依赖编排实施任务
7
7
  4. 按规划建立全部目录与文件占位
8
- 5. 按模块依赖分配子 agent,尽可能并行实施并执行黑盒与白盒测试
9
- 6. 每个模块验证通过后,提交对应改动
10
- 7. 整合已验证模块的提交
11
- 8. 完成整体验证,核对目标的完成条件
8
+ 5. 按模块依赖分配子 agent,尽可能并行编写生产代码与黑盒、白盒测试代码
9
+ 6. 每个模块完成后,提交对应改动并整合
10
+ 7. 核对目标的完成条件,衔接审查与测试
12
11
  只改代码与测试
13
12
  ---
14
13
  <!-- AUTO-GENERATED from SKILL.md.tmpl — do not edit directly -->
@@ -16,22 +15,21 @@ description: |
16
15
 
17
16
  # aca-implement
18
17
 
19
- 按当前范围的设计文档完成代码与测试的实施
20
- 只改代码与测试,不改设计文档
18
+ 按当前范围的设计文档完成生产代码与测试代码的编写
19
+ 只改代码与测试,不改设计文档,不运行测试
21
20
 
22
21
  ## 1 原则
23
22
 
24
23
  1. **目标驱动**
25
24
  以已确认的交付目标决定实施范围与任务优先级
26
- 以完成条件及其验证证据判断目标是否达成
25
+ 以设计要求的覆盖情况判断实施是否完成
27
26
  2. **依赖驱动并行**
28
27
  以依赖关系确定实施顺序
29
- 依赖已满足且不存在共享资源冲突的任务,尽可能并行推进
30
- 3. **测试驱动**
31
- 以对外契约与内部设计确定测试预期
32
- 以测试驱动实现,以黑盒与白盒测试共同验证设计要求
33
- 4. **范围约束**
34
- 实施与重构均以已确认的设计范围为边界
28
+ 依赖已满足且不存在文件冲突的任务,尽可能并行推进
29
+ 3. **代码与测试同步**
30
+ 以对外契约、内部设计与测试设计为依据,同步编写生产代码及黑盒、白盒测试代码
31
+ 4. **只写不测**
32
+ 实施阶段只编写或修改代码与测试,测试运行统一交给 `/aca-test`
35
33
 
36
34
  ## 2 执行流程
37
35
 
@@ -41,14 +39,9 @@ flowchart TD
41
39
  Plan --> Prepare["实施准备 · §4"]
42
40
  Prepare --> Implement["实施与整合 · §5"]
43
41
  Implement -- 所有剩余任务均受阻且无进行中任务 --> Report
44
- Implement --> Modules{所有模块任务已完成并整合}
42
+ Implement --> Modules{当前范围的模块任务均已完成并整合}
45
43
  Modules -- 否 --> Implement
46
- Modules -- 是 --> Verify["整体验证 · §6"]
47
- Verify --> Complete{当前范围的全部完成条件均已验证满足}
48
- Complete -- 否,设计明确且可在当前范围内修复 --> Implement
49
- Complete -- 否,剩余验证可继续执行 --> Verify
50
- Complete -- 否,剩余修复或验证受阻 --> Report
51
- Complete -- 是 --> Report(["输出结果与下一步 · §7"])
44
+ Modules -- 是 --> Report(["输出结果与下一步 · §6"])
52
45
  ```
53
46
 
54
47
  ## 3 目标与任务编排
@@ -57,49 +50,53 @@ flowchart TD
57
50
  检查工作区状态与近期提交,核对当前实施进度及已有改动
58
51
  保留本次实施范围之外的已有改动
59
52
 
60
- 1. 根据已确认的设计与实施范围,列出交付物及各自的完成条件
61
- 2. 对照交付要求与现有代码、测试,列出需要复用、修改、新增或移除的内容
62
- 3. 根据黑盒与白盒测试设计,列出本次需要执行的测试
63
- 明确这些测试所需的环境与夹具
64
- 4. 根据设计列出本次涉及的模块及其依赖关系
65
- 模块包含各级子模块:顶层模块取自 architecture,子模块取自直接父级 class-design 的内部组成
66
- 5. 根据测试设计,明确各项测试使用真实依赖还是测试替身
67
- 核对所需依赖的就绪状态
68
- 6. 根据模块边界、内部设计与仓库约定,规划源码与测试文件结构
69
- 列出当前实施范围内的全部源码与测试目录、文件
70
- 7. 明确各文件的职责、所属模块与依赖
71
- 核对文件职责是否单一,职责划分是否重叠
72
- 职责不单一或存在重叠时,调整文件划分
73
- 8. 将实施准备、模块实施、整合与整体验证拆成任务
74
- 以设计中的模块为最小实施、验证与提交单位
75
- 有子模块时,各子模块与父级的组合实现分别成为任务,父级任务依赖其全部子模块任务
76
- 9. 明确每项任务的依赖、负责人和完成条件
77
- 10. 使用当前 AI Agent 环境提供的目标或任务管理能力,维护总目标与任务进度
78
- 记录各任务的状态:待实施、进行中、已完成或受阻
79
- 记录任务的验证证据与下一步动作
80
- 恢复任务时,核对任务记录、工作区与近期提交
81
- 根据核对结果更新任务状态并继续实施
53
+ 1. **明确交付物与完成条件**
54
+ - 根据已确认的设计与实施范围,列出交付物及各自的完成条件
55
+ 2. **梳理代码与测试改动清单**
56
+ - 对照交付要求与现有代码、测试,列出需要复用、修改、新增或移除的内容
57
+ 3. **编排对应的测试范围**
58
+ - 根据黑盒与白盒测试设计,列出本次需要编写或更新的测试用例与夹具
59
+ - 记录当前实施范围对应的待测单元与测试用例范围,供后续 `/aca-test` 直接执行
60
+ 4. **梳理模块与依赖关系**
61
+ - 根据设计列出本次涉及的模块及其依赖关系
62
+ - 模块包含各级子模块:顶层模块取自 architecture,子模块取自直接父级 class-design 的内部组成
63
+ 5. **规划源码与测试文件结构**
64
+ - 根据模块边界、内部设计与仓库约定,规划源码与测试文件结构
65
+ - 列出当前实施范围内的全部源码与测试目录、文件
66
+ 6. **核对文件职责与边界**
67
+ - 明确各文件的职责、所属模块与依赖
68
+ - 核对文件职责是否单一,职责划分是否重叠
69
+ - 职责不单一或存在重叠:调整文件划分
70
+ 7. **拆分模块实施与整合任务**
71
+ - 将实施准备、模块实施与整合拆成任务
72
+ - 以设计中的模块为最小实施与提交单位
73
+ - 有子模块时,各子模块与父级的组合实现分别成为任务,父级任务依赖其全部子模块任务
74
+ - 明确每项任务的依赖、负责人和完成条件
75
+ 8. **维护任务状态与进度**
76
+ - 使用当前 AI Agent 环境提供的目标或任务管理能力,维护总目标与任务进度
77
+ - 记录各任务的状态:待实施、进行中、已完成或受阻
78
+ - 恢复任务时,核对任务记录、工作区与近期提交,更新任务状态并继续实施
82
79
 
83
80
  ## 4 实施准备
84
81
 
85
- 1. 按规划补齐当前范围的全部源码和测试目录与文件占位
86
- 已有文件直接复用,新增文件创建为空文件
87
- 删除规划中明确移除、且已核实不再承担有效职责的文件
88
- 文件用途、依赖或删除范围无法确认时,保留并向开发者核实
89
- 全部文件占位建立后,再进入模块实现
90
- 2. 主 agent 为各子 agent 安排独立工作区
91
- 按测试设计分配测试资源,确保并行任务互不干扰
92
- 将准备好的文件结构同步到各工作区
93
- 3. 为每个子 agent 提供以下任务上下文
82
+ 1. **建立目录与文件占位**
83
+ - 按规划补齐当前范围的全部源码和测试目录与文件占位
84
+ - 已有文件直接复用,新增文件创建为空文件
85
+ - 删除规划中明确移除、且已核实不再承担有效职责的文件
86
+ - 文件用途、依赖或删除范围无法确认:保留并向开发者核实
87
+ - 全部文件占位建立后,再进入模块实现
88
+ 2. **分配独立工作区**
89
+ - 主 agent 为各子 agent 安排独立工作区
90
+ - 将准备好的文件结构同步到各工作区
91
+ 3. **下发子 agent 任务上下文**
94
92
  - 总体实现目标,以及当前模块需要完成的功能与改动范围
95
93
  - 当前模块及其依赖的结构依据、接口、内部设计与测试用例的相关章节链接
96
94
  顶层模块的结构依据为 architecture,子模块的结构依据为父级 class-design 的内部组成
97
95
  - 各项依赖的就绪状态,以及测试中的真实依赖或替身安排
98
96
  - 工作区路径、起始提交、允许修改的文件,以及适用的仓库约定
99
- - 测试环境与夹具、验证命令,以及模块完成条件
100
- - 只修改代码与测试
97
+ - 只修改生产代码与测试代码,不修改设计文档,不运行测试
101
98
  - 遵循[异常处理](#52-异常处理)要求
102
- - 返回改动文件、提交记录、验证命令及结果、未验证项与阻塞原因
99
+ - 返回改动文件、提交记录、对应测试范围与阻塞原因
103
100
 
104
101
  涉及其他任务负责的文件或共享文件时,先交由主 agent 协调
105
102
 
@@ -107,63 +104,48 @@ flowchart TD
107
104
 
108
105
  ### 5.1 实施循环
109
106
 
110
- 1. 主 agent 选择依赖已满足的模块任务
111
- 将可并行实施的任务分配给子 agent
112
- 2. 各模块按测试设计实施与验证
113
- 1. 准备并运行测试
114
- 按设计复用、编写或更新模块当前范围的黑盒与白盒测试
115
- 新增或变更的设计要求尚未实现时,确认对应测试失败
116
- 行为保持不变的重构,先运行对应测试,建立验证基线
117
- 2. 按设计完成模块当前范围的改动并验证
118
- 设计未规定的实现细节,按仓库约定处理
119
- 仓库没有对应约定时,采用最简单且符合设计的实现
120
- 设计包含飞书卡片示意时,按[飞书卡片映射](~/.grok/skills/aca/skills/references/lark-card-mapping.md)实现
121
- 运行模块测试,确认全部通过
122
- 3. 按需重构并重新验证
123
- 重构后重新运行模块测试,确认全部通过
124
- 出现非预期的测试失败且设计明确时,修正代码并重新运行受影响的测试
125
- 3. 核对模块当前范围的黑盒、白盒测试结果及其他完成条件
126
- 全部满足后,只暂存并提交当前任务的改动
127
- 4. 主 agent 核对模块提交与验证证据
128
- 确认模块达到完成条件后,整合其提交
129
- 在整合后的代码上运行受影响模块的测试与模块间集成测试
130
- 5. 主 agent 更新任务状态、验证证据与依赖就绪状态
131
- 记录受阻任务的原因与恢复条件
132
- 将已整合且验证通过的依赖提交同步到需要真实依赖的模块工作区
133
- 仍有可实施任务时,回到第 1 步
134
- 没有可派发任务且仍有进行中任务时,等待执行结果
135
- 全部模块任务完成并整合后,进入[整体验证](#6-整体验证)
136
- 所有剩余任务均受阻且无进行中任务时,按[输出结果](#7-输出结果)报告未完成
107
+ 1. **派发可并行模块任务**
108
+ - 主 agent 选择依赖已满足的模块任务,将可并行实施的任务分配给子 agent
109
+ 2. **编写模块生产代码与测试代码**
110
+ - 按设计复用、编写或更新模块当前范围的黑盒与白盒测试代码及夹具
111
+ - 按设计完成模块当前范围的生产代码改动
112
+ - 设计未规定的实现细节,按仓库约定处理;仓库没有对应约定时,采用最简单且符合设计的实现
113
+ - 设计包含飞书卡片示意时,按[飞书卡片映射](~/.grok/skills/aca/skills/references/lark-card-mapping.md)实现
114
+ - 按需整理代码结构,保持职责单一与边界清晰
115
+ 3. **核对模块完成条件并提交**
116
+ - 核对模块当前范围的接口契约、内部机制及黑盒、白盒测试代码已按设计全部写齐
117
+ - 只暂存并提交当前任务的改动
118
+ 4. **整合模块提交**
119
+ - 主 agent 核对模块提交的文件范围与完成情况
120
+ - 确认模块达到完成条件后,整合其提交
121
+ 5. **更新进度与推进**
122
+ - 主 agent 更新任务状态、已实现的模块范围与依赖就绪状态
123
+ - 记录受阻任务的原因与恢复条件
124
+ - 将已整合的依赖提交同步到下游模块工作区
125
+ - 仍有可实施任务:回到第 1 步
126
+ - 没有可派发任务且仍有进行中任务:等待执行结果
127
+ - 当前范围全部模块任务完成并整合:进入[输出结果](#6-输出结果)
128
+ - 所有剩余任务均受阻且无进行中任务:按[输出结果](#6-输出结果)报告未完成
137
129
 
138
130
  ### 5.2 异常处理
139
131
 
140
- 1. 发现设计缺失、冲突或无法实现时,执行任务的 agent 暂停受影响任务
141
- 子 agent 向主 agent 报告问题及影响范围
142
- 主 agent 核实问题及其影响范围,再向开发者报告
143
- 需要补充或修订方案时,建议通过 `/aca-specify` 处理
144
- 未受影响的独立任务继续推进
145
- 2. 发现其他仓库的问题时,主 agent 核实后向开发者报告问题及影响
146
- 未经授权,不修改其他仓库
132
+ 1. **处理设计缺失或冲突**
133
+ - 发现设计缺失、冲突或无法实现时,执行任务的 agent 暂停受影响任务
134
+ - 子 agent 向主 agent 报告问题及影响范围
135
+ - 主 agent 核实问题及其影响范围,再向开发者报告
136
+ - 需要补充或修订方案时,建议通过 `/aca-specify` 处理
137
+ - 未受影响的独立任务继续推进
138
+ 2. **处理跨仓库问题**
139
+ - 发现其他仓库的问题时,主 agent 核实后向开发者报告问题及影响
140
+ - 未经授权,不修改其他仓库
147
141
 
148
- ## 6 整体验证
142
+ ## 6 输出结果
149
143
 
150
- 所有模块任务完成并整合后,由主 agent 执行当前交付范围的整体验证
151
- 按实施规划运行模块测试、集成测试、系统测试、构建与静态检查
152
- 执行设计规定的测试用例,核验被测对象的运行结果
153
- 构建或静态检查通过,不能代替行为测试的运行结果
154
-
155
- 发现设计明确且可在当前范围内修复的问题时,返回[实施与整合](#5-实施与整合)处理
156
- 修正后重新执行受影响的验证
157
- 对照总目标逐项核对完成条件
158
- 将验证结果与未验证项更新到任务记录
159
-
160
- ## 7 输出结果
161
-
162
- 当前范围的全部完成条件均已验证满足时,将目标与任务状态标记为完成
144
+ 当前范围的全部完成条件均已满足时,将目标与任务状态标记为完成
163
145
  未完成时,报告剩余工作、阻塞原因与恢复动作
164
146
  本次实施完成后,通过 `/aca-review` 对本次实施范围进行实现审查
165
- 向 Review 提供总体目标、对应设计、实施范围与比较基线
166
- 注明受审提交及未提交改动,并提供验证结果与证据
147
+ 向 Review 与后续 `/aca-test` 提供总体目标、对应设计、实施范围、编排好的待测范围及比较基线
148
+ 注明受审提交及未提交改动
167
149
  结束汇报使用以下样式,按实际状态填写标题与结果
168
150
 
169
151
  ```markdown
@@ -173,9 +155,8 @@ flowchart TD
173
155
  | --- | --- |
174
156
  | 目标 | <总目标及完成条件的满足情况> |
175
157
  | 范围 | <实现范围与模块进度> |
176
- | 改动 | <主要实现行为> |
177
- | 验证 | <测试执行、构建与静态检查结果> |
178
- | 未验证 | <未验证范围 / 无> |
158
+ | 改动 | <主要生产代码与测试代码改动> |
159
+ | 待测范围 | <为 /aca-test 编排的本次待测单元与测试用例范围> |
179
160
  | 提交 | <提交记录 / 未提交> |
180
161
  | 阻塞 | <阻塞项与原因 / 无> |
181
162
  | 建议 | <扩展建议 / 无> |
@@ -50,31 +50,33 @@ flowchart TD
50
50
 
51
51
  ### 3.1 发布依据与前提
52
52
 
53
- 1. 确定本次发布目标
53
+ 1. **确定本次发布目标**
54
54
  沿用开发者或调用方已明确的版本、Tag 与发布范围
55
55
  信息缺失时,请开发者补齐
56
56
  已明确的信息直接沿用
57
- 2. 运行 `bash ~/.grok/skills/aca/bin/aca-repo-type-check` 检查工程类型
57
+ 2. **检查工程类型**
58
+ 运行 `bash ~/.grok/skills/aca/bin/aca-repo-type-check` 检查工程类型
58
59
  类型缺失或无效时,停止并建议运行 `/aca-init`
59
60
  类型尚未支持时,停止并报告无法核对类型规则
60
- 3. 读取 `~/.grok/skills/aca/doc-design/repo-types/{repo-type}.md`
61
+ 3. **读取类型规则与发布流程**
62
+ 读取 `~/.grok/skills/aca/doc-design/repo-types/{repo-type}.md`
61
63
  按项目结构定位适用的发布流程、版本来源与版本记录
62
64
  已选用 release 文档时,按其规定执行
63
65
  未选用时,采用本 skill 的默认流程
64
- 4. 明确本次执行要求
66
+ 4. **明确本次执行要求**
65
67
  列出必需步骤、通过条件,以及所需环境、工具、权限与外部依赖
66
68
  必需条件不满足时,按[输出结果与下一步](#8-输出结果与下一步)报告停止原因与恢复位置
67
69
 
68
70
  ### 3.2 当前状态与恢复位置
69
71
 
70
- 1. 同步并读取当前发布状态
72
+ 1. **同步并读取当前发布状态**
71
73
  核对远端分支、Tag、本地状态与已有执行记录
72
- 2. 核对已有 Tag
74
+ 2. **核对已有 Tag**
73
75
  确认本地与远端同名 Tag 的指向和注解是否符合本次发布
74
76
  存在冲突时,停止并报告冲突
75
77
  匹配时,保留已完成的固化结果
76
78
  不重复执行版本记录收口、合并与 Tag 创建
77
- 3. 核对剩余步骤的前提
79
+ 3. **核对剩余步骤的前提**
78
80
  - 继续收口、合并或创建 Tag:核对对应的执行条件
79
81
  确认对应分支与提交、版本记录及工作区状态
80
82
  核对相关文件的版本号一致,已有改动全部提交,工作区干净
@@ -82,7 +84,8 @@ flowchart TD
82
84
  版本区块缺失或格式异常时,停止并建议运行 `/aca-init`
83
85
  - 仅恢复通告:以已锁定的 Tag 为依据
84
86
  前提或验证证据已失效时,回到对应步骤重新核验
85
- 4. 按下表确定恢复位置,选择尚未完成的步骤
87
+ 4. **确定恢复位置**
88
+ 按下表确定恢复位置,选择尚未完成的步骤
86
89
  沿用仍然有效的完成事实
87
90
 
88
91
  | 剩余工作 | 入口 |
@@ -94,9 +97,10 @@ flowchart TD
94
97
 
95
98
  ### 3.3 通告配置
96
99
 
97
- 1. 运行 `bash ~/.grok/skills/aca/bin/aca-release-notify-check .` 检查通告配置
100
+ 1. **检查通告配置**
101
+ 运行 `bash ~/.grok/skills/aca/bin/aca-release-notify-check .` 检查通告配置
98
102
  记录检查结果与对应配置位置
99
- 2. 根据检查结果处理
103
+ 2. **根据检查结果处理**
100
104
 
101
105
  | 结果 | 处理 |
102
106
  | --- | --- |
@@ -105,7 +109,8 @@ flowchart TD
105
109
  | `NOTIFY_UNWIRED` | 停止,报告通告未使用 `aca-tag-notify-extract <tag>` 提取内容,配置修正后重新检查 |
106
110
  | 无法完成检查 | 停止,报告原因与恢复条件 |
107
111
 
108
- 3. 将配置检查结果用于[通告核对](#72-核对发布通告)
112
+ 3. **传递配置检查结果**
113
+ 将配置检查结果用于[通告核对](#72-核对发布通告)
109
114
  配置修正后,重新检查
110
115
  配置检查用于确认摘要接入情况
111
116
  取得实际发送结果后,才能报告已发送
@@ -114,54 +119,54 @@ flowchart TD
114
119
 
115
120
  ### 4.1 收口版本记录
116
121
 
117
- 1. 确定版本记录范围
122
+ 1. **确定版本记录范围**
118
123
  按仓库发布流程规定的时机与方式,选取本次适用的版本记录
119
124
  未选用 release 文档时,按类型规则确定记录范围
120
125
  核对版本记录与本次实际改动是否一致
121
- 2. 更新版本来源与相关记录
126
+ 2. **更新版本来源与相关记录**
122
127
  按仓库约定更新版本来源及需要同步的文件,收口本版记录
123
128
  版本记录与实际改动不一致,或无法判断哪些内容属于当前版本时,停止并说明差异
124
- 3. 同步 README 版本区块
129
+ 3. **同步 README 版本区块**
125
130
  版本来源更新后,将根 README 仓库版本行同步为本次 `<TARGET_VERSION>`,保留仓库名
126
131
  - 普通项目:运行 `bash ~/.grok/skills/aca/bin/aca-readme-version-sync README.md "<TARGET_VERSION>"`
127
132
  - 发布 Anyone Can Architect 自身:在项目 `VERSION` 更新后,运行 `bash ~/.grok/skills/aca/bin/aca-readme-version-sync README.md "$(tr -d '[:space:]' < VERSION)" "$(tr -d '[:space:]' < VERSION)"`
128
133
  同步失败时,停止并报告原因
129
134
  版本区块缺失或格式异常时,建议运行 `/aca-init`
130
135
  其他失败按实际原因处理
131
- 4. 核验并提交收口改动
136
+ 4. **核验并提交收口改动**
132
137
  核对版本一致性、记录完整性与 README 版本区块格式
133
138
  只提交本次修改的版本记录、版本指针和 README 版本区块
134
139
  不使用 `git add -A` 裹入无关改动
135
140
 
136
141
  ### 4.2 确认合并链
137
142
 
138
- 1. 确认最终目标
143
+ 1. **确认最终目标**
139
144
  最终合并与版本 Tag 落在 `main`
140
145
  确认仓库存在 `main`
141
146
  不存在时,停止并报告缺少发布目标分支
142
- 2. 确定分支顺序
147
+ 2. **确定分支顺序**
143
148
  选用 release 文档时,按其定义的合并链执行
144
149
  未定义合并链时,根据仓库现有分支职责确定
145
150
  中间分支用途不明确时,请开发者确认
146
151
  不为 Release 新建中间分支
147
- 3. 明确各次合并要求
152
+ 3. **明确各次合并要求**
148
153
  记录来源分支、目标分支、合并方式与必需检查
149
154
  上述要求作为[合入与最终验证](#5-合入与最终验证)的执行依据
150
- 4. 核对已完成的合并
155
+ 4. **核对已完成的合并**
151
156
  恢复执行时,结合合并记录与版本内容确认完成情况
152
157
  已完成且前提仍有效的合并直接沿用
153
158
 
154
159
  ### 4.3 合并前审计
155
160
 
156
- 1. 明确待合并状态
161
+ 1. **明确待合并状态**
157
162
  同步目标分支,记录待合并提交与目标分支状态
158
- 2. 执行或复用仓库审计
163
+ 2. **执行或复用仓库审计**
159
164
  调用包含实现核对的 `/aca-repo-audit`
160
165
  已有结果符合其复用条件时,沿用并注明依据
161
166
  不满足复用条件时,重新审计
162
- 3. 完成仓库要求的额外验证
167
+ 3. **完成仓库要求的额外验证**
163
168
  按发布流程执行尚未覆盖的验证与必要操作,记录结果
164
- 4. 判定是否允许合并
169
+ 4. **判定是否允许合并**
165
170
  审计结论为通过且必需验证通过后,进入[合入与最终验证](#5-合入与最终验证)
166
171
  审计结论为需要处理或未完成时,停止合并
167
172
  必需验证失败或未完成时,停止合并
@@ -171,42 +176,42 @@ flowchart TD
171
176
 
172
177
  ### 5.1 按分支链合入 main
173
178
 
174
- 1. 选择下一次合并
179
+ 1. **选择下一次合并**
175
180
  按[合并链](#42-确认合并链)选择尚未完成的步骤
176
181
  核对来源分支、目标分支与合并前审计是否仍然有效
177
- 2. 按仓库约定执行合并
182
+ 2. **按仓库约定执行合并**
178
183
  遵守仓库已有的合并方式与分支保护规则
179
184
  - 需要 Pull Request:创建或更新 Pull Request
180
185
  - 允许本地合并:按仓库约定执行
181
186
  不强推、不跳过检查、不绕过保护规则
182
- 3. 确认合并完成
187
+ 3. **确认合并完成**
183
188
  核对实际合并结果及目标分支中的版本内容,记录结果提交
184
189
  Pull Request 尚未合并时,记录等待状态与恢复位置
185
190
  合并完成后,再进入下一次合并
186
191
  全部合入 main 后,进入[最终提交验证](#52-最终提交验证)
187
- 4. 处理冲突并恢复
192
+ 4. **处理冲突并恢复**
188
193
  出现冲突时,停止合并并报告冲突文件与原因
189
194
  冲突解决并提交后,按[合并前审计](#43-合并前审计)重新核对审计与受影响的验证
190
195
  准入条件满足后,继续合并
191
196
 
192
197
  ### 5.2 最终提交验证
193
198
 
194
- 1. 定位最终提交
199
+ 1. **定位最终提交**
195
200
  同步 main,确认本版合并完成
196
201
  记录准备锁定的 main 提交
197
- 2. 核对版本与内容
202
+ 2. **核对版本与内容**
198
203
  核对 main 上的最终版本号与本次目标版本一致
199
204
  核对适用的版本记录已收口
200
205
  核对根 README 仓库版本行与本次 Tag 版本一致
201
206
  核对 Anyone Can Architect footer 与当前 Anyone Can Architect 版本一致,紧随仓库版本行且为最后一行
202
207
  核对最终提交包含本次范围完整的设计、实现和测试
203
- 3. 完成最终验证
204
- 在最终提交上完成仓库发布流程规定的验证
208
+ 3. **完成最终验证**
209
+ 在最终提交上完成仓库发布流程规定的验证与 `/aca-test` 测试范围
205
210
  记录验证结果与对应提交
206
- 复用已有结果时,说明满足的复用条件及其与最终提交的对应依据
211
+ 复用已有 `/aca-test` 或验证结果时,说明满足的复用条件及其与最终提交的对应依据
207
212
  涉及制品时,核对制品与该提交的追溯关系
208
213
  验证产物不能代替交付完成的证据
209
- 4. 判定是否允许锁定版本
214
+ 4. **判定是否允许锁定版本**
210
215
  必需核对与验证全部通过后,进入[锁定版本](#6-锁定版本)
211
216
  失败或未完成时,停止并按[输出结果与下一步](#8-输出结果与下一步)报告原因与恢复位置
212
217
 
@@ -217,11 +222,12 @@ flowchart TD
217
222
  发布摘要是 Release 的必产物
218
223
  版本通告从 annotated Tag 的 NOTIFY 块生成
219
224
 
220
- 1. 核对已有 Tag 与内容来源
225
+ 1. **核对已有 Tag 与内容来源**
221
226
  - 已有 Tag 的指向与注解已核对通过:保留注解,转至[创建与推送 Tag](#62-创建与推送-tag)继续未完成步骤
222
227
  - 需要创建 Tag:根据本版版本记录或已确认 Issue,对照本版实际改动确定摘要内容
223
228
  验证事实取自[最终提交验证](#52-最终提交验证)的记录
224
- 2. 按以下格式编写摘要,写入 `~/.aca/release-note-<TAG>.md`
229
+ 2. **按统一格式编写摘要**
230
+ 按以下格式编写摘要,写入 `~/.aca/release-note-<TAG>.md`
225
231
 
226
232
  ```text
227
233
  vX.Y.Z:<一句话主题>(#issue …)
@@ -239,20 +245,22 @@ flowchart TD
239
245
  - 变化建议写 3–6 条,不用文件名或提交哈希代替变化描述
240
246
  - 末条记录真实验证结果,以 ✅ 开头
241
247
 
242
- 3. 运行 `bash ~/.grok/skills/aca/bin/aca-tag-notify-check ~/.aca/release-note-<TAG>.md <TAG>` 校验摘要
248
+ 3. **机械校验摘要**
249
+ 运行 `bash ~/.grok/skills/aca/bin/aca-tag-notify-check ~/.aca/release-note-<TAG>.md <TAG>` 校验摘要
243
250
  校验失败时,修正后重新校验
244
251
  校验通过后,将摘要文件交给[创建与推送 Tag](#62-创建与推送-tag)
245
252
  不使用一行标题或空注解
246
253
 
247
254
  ### 6.2 创建与推送 Tag
248
255
 
249
- 1. 核对最新状态
256
+ 1. **核对最新状态**
250
257
  同步远端,核对本地与远端目标 Tag 是否存在
251
- 2. 处理已有 Tag
258
+ 2. **处理已有 Tag**
252
259
  指向与注解匹配时,保留已有 Tag 并继续剩余步骤
253
260
  存在冲突时,停止并报告冲突
254
261
  不移动或重建已有 Tag
255
- 3. 本地与远端均无目标 Tag 时,创建 annotated Tag
262
+ 3. **创建 annotated Tag**
263
+ 本地与远端均无目标 Tag 时,创建 annotated Tag
256
264
  创建前确认 main 仍指向[最终提交验证](#52-最终提交验证)记录的提交
257
265
  确认[发布摘要](#61-发布摘要)已校验通过
258
266
  - main 已变化:按[最终提交验证](#52-最终提交验证)重新核验新的最终提交
@@ -263,23 +271,24 @@ flowchart TD
263
271
  git tag -a "<TAG>" "<VERIFIED_MAIN_COMMIT>" -F ~/.aca/release-note-<TAG>.md
264
272
  ```
265
273
 
266
- 4. 远端尚无目标 Tag 时,按仓库约定推送
274
+ 4. **推送目标 Tag**
275
+ 远端尚无目标 Tag 时,按仓库约定推送
267
276
  推送失败时,记录原因与恢复位置
268
277
  恢复后,核对最新状态再补推送
269
278
  推送完成或远端已有目标 Tag 时,按[核对远端 Tag](#63-核对远端-tag)核验结果
270
279
 
271
280
  ### 6.3 核对远端 Tag
272
281
 
273
- 1. 读取远端实际结果
282
+ 1. **读取远端实际结果**
274
283
  核对目标 Tag 是否存在
275
284
  不存在时,按[创建与推送 Tag](#62-创建与推送-tag)处理推送后,重新核对
276
285
  存在时,取得其类型、指向的提交与注解
277
- 2. 核对固化内容
286
+ 2. **核对固化内容**
278
287
  确认目标为 annotated Tag
279
288
  核对提交与本次已验证的 main 提交一致
280
289
  核对注解与本次已确认的摘要一致
281
290
  恢复旧版本时,对照该版本的固化记录核对
282
- 3. 记录状态并推进
291
+ 3. **记录状态并推进**
283
292
  核对通过后,记录远端固化事实,进入[发布后处理](#7-发布后处理)
284
293
  无法核对或发现冲突时,停止并报告原因与恢复条件
285
294
  保留已有 Tag
@@ -288,14 +297,14 @@ flowchart TD
288
297
 
289
298
  ### 7.1 清理版本分支
290
299
 
291
- 1. 确定清理范围
300
+ 1. **确定清理范围**
292
301
  按仓库约定列出本次版本分支,以及需要清理的本地与远端范围
293
- 2. 核对清理条件
302
+ 2. **核对清理条件**
294
303
  确认[远端 Tag 核对](#63-核对远端-tag)已通过
295
304
  结合合并记录与版本内容,确认候选分支已合入 main
296
305
  保留仍承担后续工作的分支
297
306
  无法确认归属或合并情况时,保留并记录原因
298
- 3. 执行并核对清理结果
307
+ 3. **执行并核对清理结果**
299
308
  仅清理满足条件的本次分支,记录实际结果
300
309
  无法完成时,报告剩余分支、原因与恢复条件
301
310
  清理失败不改变版本已经固化的事实
@@ -303,9 +312,9 @@ flowchart TD
303
312
 
304
313
  ### 7.2 核对发布通告
305
314
 
306
- 1. 定位发送结果
315
+ 1. **定位发送结果**
307
316
  根据[通告配置](#33-通告配置)与仓库发布流程,查找本次 Tag 对应的任务、日志或发送回执
308
- 2. 根据证据记录发送状态
317
+ 2. **根据证据记录发送状态**
309
318
 
310
319
  | 状态 | 判定依据 |
311
320
  | --- | --- |
@@ -315,7 +324,7 @@ flowchart TD
315
324
  | 未确认 | 缺少足以判断发送状态的证据 |
316
325
  | 未配置传输 | 配置检查确认未设置发送机制 |
317
326
 
318
- 3. 处理后续动作
327
+ 3. **处理后续动作**
319
328
  发送失败时,按仓库约定恢复或重发
320
329
  状态未确认时,报告缺少的证据
321
330
  重发使用 `aca-tag-notify-extract <tag>` 从已锁定 Tag 提取内容
@@ -327,9 +336,9 @@ flowchart TD
327
336
 
328
337
  ### 8.1 判定完成状态
329
338
 
330
- 1. 判定版本固化状态
339
+ 1. **判定版本固化状态**
331
340
  按[远端 Tag 核对](#63-核对远端-tag)的结果,记录已固化、未固化或未确认
332
- 2. 判定 Release 完成状态
341
+ 2. **判定 Release 完成状态**
333
342
  仓库发布流程的必需步骤完成,远端 annotated Tag 的指向与注解核对通过时,标记 Release 完成
334
343
  未满足完成条件时,标记未完成
335
344
  清理或通告未完成时,按仓库对这些步骤的必需性判定流程状态
@@ -369,7 +378,8 @@ flowchart TD
369
378
  | 缺少执行条件 | 补齐后按[发布准备](#3-发布准备)核对状态并恢复 |
370
379
  | 设计方案仍需论证 | `/aca-specify` 论证方案 |
371
380
  | 修订方案已明确,仅需改文档 | `/aca-design` 修订文档 |
372
- | 实现问题 | `/aca-implement` 修复并验证 |
381
+ | 实现问题 | `/aca-implement` 修复代码或测试 |
382
+ | 测试或最终验证未完成 | `/aca-test` 执行验证后恢复发布 |
373
383
  | 合并冲突 | 处理并提交冲突解决结果后,重新执行[合并前审计](#43-合并前审计) |
374
384
  | 推送、清理或通告尚未完成 | 从对应的未完成步骤恢复 |
375
385
  | 全部完成且无后续事项 | 报告无待办 |