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.
- package/README.md +6 -4
- package/README.zh-CN.md +4 -2
- package/VERSION +1 -1
- package/axioms/README.md +1 -1
- package/axioms/writing.md +1 -1
- package/dist/antigravity/aca/SKILL.md +3 -2
- package/dist/antigravity/aca-design/SKILL.md +1 -1
- package/dist/antigravity/aca-implement/SKILL.md +90 -109
- package/dist/antigravity/aca-release/SKILL.md +4 -3
- package/dist/antigravity/aca-repo-audit/SKILL.md +11 -9
- package/dist/antigravity/aca-review/SKILL.md +114 -115
- package/dist/antigravity/aca-test/SKILL.md +110 -0
- package/dist/antigravity/aca-walkthrough/SKILL.md +1 -1
- package/dist/antigravity-cli/aca/SKILL.md +3 -2
- package/dist/antigravity-cli/aca-design/SKILL.md +1 -1
- package/dist/antigravity-cli/aca-implement/SKILL.md +90 -109
- package/dist/antigravity-cli/aca-release/SKILL.md +4 -3
- package/dist/antigravity-cli/aca-repo-audit/SKILL.md +11 -9
- package/dist/antigravity-cli/aca-review/SKILL.md +114 -115
- package/dist/antigravity-cli/aca-test/SKILL.md +110 -0
- package/dist/antigravity-cli/aca-walkthrough/SKILL.md +1 -1
- package/dist/codex/aca/SKILL.md +3 -2
- package/dist/codex/aca-design/SKILL.md +1 -1
- package/dist/codex/aca-implement/SKILL.md +90 -109
- package/dist/codex/aca-release/SKILL.md +4 -3
- package/dist/codex/aca-repo-audit/SKILL.md +11 -9
- package/dist/codex/aca-review/SKILL.md +114 -115
- package/dist/codex/aca-test/SKILL.md +110 -0
- package/dist/codex/aca-walkthrough/SKILL.md +1 -1
- package/dist/cursor/aca/SKILL.md +3 -2
- package/dist/cursor/aca-design/SKILL.md +1 -1
- package/dist/cursor/aca-implement/SKILL.md +90 -109
- package/dist/cursor/aca-release/SKILL.md +4 -3
- package/dist/cursor/aca-repo-audit/SKILL.md +11 -9
- package/dist/cursor/aca-review/SKILL.md +114 -115
- package/dist/cursor/aca-test/SKILL.md +111 -0
- package/dist/cursor/aca-walkthrough/SKILL.md +1 -1
- package/dist/grok/aca/SKILL.md +3 -2
- package/dist/grok/aca-design/SKILL.md +1 -1
- package/dist/grok/aca-implement/SKILL.md +90 -109
- package/dist/grok/aca-release/SKILL.md +4 -3
- package/dist/grok/aca-repo-audit/SKILL.md +11 -9
- package/dist/grok/aca-review/SKILL.md +114 -115
- package/dist/grok/aca-test/SKILL.md +110 -0
- package/dist/grok/aca-walkthrough/SKILL.md +1 -1
- package/doc-design/document-sets/module.md +6 -2
- package/doc-design/documents/class-design.md +7 -4
- package/doc-design/documents/integration-guide.md +7 -5
- package/doc-design/documents/release.md +5 -3
- package/meta-skills/aca/SKILL.md +3 -2
- package/meta-skills/aca/SKILL.md.tmpl +3 -2
- package/package.json +1 -1
- package/skills/aca-design/SKILL.md +1 -1
- package/skills/aca-implement/SKILL.md +90 -109
- package/skills/aca-implement/SKILL.md.tmpl +91 -110
- package/skills/aca-release/SKILL.md +4 -3
- package/skills/aca-release/SKILL.md.tmpl +4 -3
- package/skills/aca-repo-audit/SKILL.md +11 -9
- package/skills/aca-repo-audit/SKILL.md.tmpl +10 -8
- package/skills/aca-review/SKILL.md +114 -115
- package/skills/aca-review/SKILL.md.tmpl +115 -116
- package/skills/aca-test/SKILL.md +110 -0
- package/skills/aca-test/SKILL.md.tmpl +108 -0
- package/skills/aca-walkthrough/SKILL.md +1 -1
- package/zh-CN/axioms/README.md +1 -1
- package/zh-CN/axioms/writing.md +1 -1
- package/zh-CN/dist/antigravity/aca/SKILL.md +3 -2
- package/zh-CN/dist/antigravity/aca-design/SKILL.md +1 -1
- package/zh-CN/dist/antigravity/aca-implement/SKILL.md +89 -108
- package/zh-CN/dist/antigravity/aca-release/SKILL.md +62 -52
- package/zh-CN/dist/antigravity/aca-repo-audit/SKILL.md +37 -29
- package/zh-CN/dist/antigravity/aca-review/SKILL.md +112 -113
- package/zh-CN/dist/antigravity/aca-test/SKILL.md +110 -0
- package/zh-CN/dist/antigravity/aca-walkthrough/SKILL.md +1 -1
- package/zh-CN/dist/antigravity-cli/aca/SKILL.md +3 -2
- package/zh-CN/dist/antigravity-cli/aca-design/SKILL.md +1 -1
- package/zh-CN/dist/antigravity-cli/aca-implement/SKILL.md +89 -108
- package/zh-CN/dist/antigravity-cli/aca-release/SKILL.md +62 -52
- package/zh-CN/dist/antigravity-cli/aca-repo-audit/SKILL.md +37 -29
- package/zh-CN/dist/antigravity-cli/aca-review/SKILL.md +112 -113
- package/zh-CN/dist/antigravity-cli/aca-test/SKILL.md +110 -0
- package/zh-CN/dist/antigravity-cli/aca-walkthrough/SKILL.md +1 -1
- package/zh-CN/dist/codex/aca/SKILL.md +3 -2
- package/zh-CN/dist/codex/aca-design/SKILL.md +1 -1
- package/zh-CN/dist/codex/aca-implement/SKILL.md +89 -108
- package/zh-CN/dist/codex/aca-release/SKILL.md +62 -52
- package/zh-CN/dist/codex/aca-repo-audit/SKILL.md +37 -29
- package/zh-CN/dist/codex/aca-review/SKILL.md +112 -113
- package/zh-CN/dist/codex/aca-test/SKILL.md +110 -0
- package/zh-CN/dist/codex/aca-walkthrough/SKILL.md +1 -1
- package/zh-CN/dist/cursor/aca/SKILL.md +3 -2
- package/zh-CN/dist/cursor/aca-design/SKILL.md +1 -1
- package/zh-CN/dist/cursor/aca-implement/SKILL.md +89 -108
- package/zh-CN/dist/cursor/aca-release/SKILL.md +62 -52
- package/zh-CN/dist/cursor/aca-repo-audit/SKILL.md +37 -29
- package/zh-CN/dist/cursor/aca-review/SKILL.md +112 -113
- package/zh-CN/dist/cursor/aca-test/SKILL.md +111 -0
- package/zh-CN/dist/cursor/aca-walkthrough/SKILL.md +1 -1
- package/zh-CN/dist/grok/aca/SKILL.md +3 -2
- package/zh-CN/dist/grok/aca-design/SKILL.md +1 -1
- package/zh-CN/dist/grok/aca-implement/SKILL.md +89 -108
- package/zh-CN/dist/grok/aca-release/SKILL.md +62 -52
- package/zh-CN/dist/grok/aca-repo-audit/SKILL.md +37 -29
- package/zh-CN/dist/grok/aca-review/SKILL.md +112 -113
- package/zh-CN/dist/grok/aca-test/SKILL.md +110 -0
- package/zh-CN/dist/grok/aca-walkthrough/SKILL.md +1 -1
- package/zh-CN/doc-design/document-sets/module.md +6 -2
- package/zh-CN/doc-design/documents/class-design.md +7 -4
- package/zh-CN/doc-design/documents/integration-guide.md +7 -5
- package/zh-CN/doc-design/documents/release.md +5 -3
- package/zh-CN/meta-skills/aca/SKILL.md +3 -2
- package/zh-CN/meta-skills/aca/SKILL.md.tmpl +3 -2
- package/zh-CN/skills/aca-design/SKILL.md +1 -1
- package/zh-CN/skills/aca-implement/SKILL.md +89 -108
- package/zh-CN/skills/aca-implement/SKILL.md.tmpl +89 -108
- package/zh-CN/skills/aca-release/SKILL.md +62 -52
- package/zh-CN/skills/aca-release/SKILL.md.tmpl +62 -52
- package/zh-CN/skills/aca-repo-audit/SKILL.md +37 -29
- package/zh-CN/skills/aca-repo-audit/SKILL.md.tmpl +36 -28
- package/zh-CN/skills/aca-review/SKILL.md +112 -113
- package/zh-CN/skills/aca-review/SKILL.md.tmpl +111 -112
- package/zh-CN/skills/aca-test/SKILL.md +110 -0
- package/zh-CN/skills/aca-test/SKILL.md.tmpl +108 -0
- 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
|
-
|
|
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 -- 是 -->
|
|
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
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
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
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
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.
|
|
111
|
-
|
|
112
|
-
2.
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
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.
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
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
|
-
|
|
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.
|
|
57
|
+
2. **检查工程类型**
|
|
58
|
+
运行 `bash ~/.grok/skills/aca/bin/aca-repo-type-check` 检查工程类型
|
|
58
59
|
类型缺失或无效时,停止并建议运行 `/aca-init`
|
|
59
60
|
类型尚未支持时,停止并报告无法核对类型规则
|
|
60
|
-
3.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
225
|
+
1. **核对已有 Tag 与内容来源**
|
|
221
226
|
- 已有 Tag 的指向与注解已核对通过:保留注解,转至[创建与推送 Tag](#62-创建与推送-tag)继续未完成步骤
|
|
222
227
|
- 需要创建 Tag:根据本版版本记录或已确认 Issue,对照本版实际改动确定摘要内容
|
|
223
228
|
验证事实取自[最终提交验证](#52-最终提交验证)的记录
|
|
224
|
-
2.
|
|
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.
|
|
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.
|
|
258
|
+
2. **处理已有 Tag**
|
|
252
259
|
指向与注解匹配时,保留已有 Tag 并继续剩余步骤
|
|
253
260
|
存在冲突时,停止并报告冲突
|
|
254
261
|
不移动或重建已有 Tag
|
|
255
|
-
3.
|
|
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.
|
|
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.
|
|
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
|
| 全部完成且无后续事项 | 报告无待办 |
|