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