anyone-can-architect 0.2.0 → 0.4.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/CONTEXT.md +2 -2
- package/README.md +6 -4
- package/README.zh-CN.md +4 -2
- package/SSOT.md +5 -0
- package/VERSION +1 -1
- package/axioms/README.md +1 -1
- package/axioms/writing.md +3 -1
- package/dist/antigravity/aca/SKILL.md +3 -2
- package/dist/antigravity/aca-design/SKILL.md +12 -6
- package/dist/antigravity/aca-implement/SKILL.md +102 -114
- package/dist/antigravity/aca-release/SKILL.md +13 -20
- package/dist/antigravity/aca-repo-audit/SKILL.md +13 -9
- package/dist/antigravity/aca-review/SKILL.md +146 -182
- package/dist/antigravity/aca-test/SKILL.md +112 -0
- package/dist/antigravity/aca-walkthrough/SKILL.md +18 -14
- package/dist/antigravity-cli/aca/SKILL.md +3 -2
- package/dist/antigravity-cli/aca-design/SKILL.md +12 -6
- package/dist/antigravity-cli/aca-implement/SKILL.md +102 -114
- package/dist/antigravity-cli/aca-release/SKILL.md +13 -20
- package/dist/antigravity-cli/aca-repo-audit/SKILL.md +13 -9
- package/dist/antigravity-cli/aca-review/SKILL.md +146 -182
- package/dist/antigravity-cli/aca-test/SKILL.md +112 -0
- package/dist/antigravity-cli/aca-walkthrough/SKILL.md +18 -14
- package/dist/codex/aca/SKILL.md +3 -2
- package/dist/codex/aca-design/SKILL.md +12 -6
- package/dist/codex/aca-implement/SKILL.md +102 -114
- package/dist/codex/aca-release/SKILL.md +13 -20
- package/dist/codex/aca-repo-audit/SKILL.md +13 -9
- package/dist/codex/aca-review/SKILL.md +146 -182
- package/dist/codex/aca-test/SKILL.md +112 -0
- package/dist/codex/aca-walkthrough/SKILL.md +18 -14
- package/dist/cursor/aca/SKILL.md +3 -2
- package/dist/cursor/aca-design/SKILL.md +12 -6
- package/dist/cursor/aca-implement/SKILL.md +102 -114
- package/dist/cursor/aca-release/SKILL.md +13 -20
- package/dist/cursor/aca-repo-audit/SKILL.md +13 -9
- package/dist/cursor/aca-review/SKILL.md +146 -182
- package/dist/cursor/aca-test/SKILL.md +113 -0
- package/dist/cursor/aca-walkthrough/SKILL.md +18 -14
- package/dist/grok/aca/SKILL.md +3 -2
- package/dist/grok/aca-design/SKILL.md +12 -6
- package/dist/grok/aca-implement/SKILL.md +102 -114
- package/dist/grok/aca-release/SKILL.md +13 -20
- package/dist/grok/aca-repo-audit/SKILL.md +13 -9
- package/dist/grok/aca-review/SKILL.md +146 -182
- package/dist/grok/aca-test/SKILL.md +112 -0
- package/dist/grok/aca-walkthrough/SKILL.md +18 -14
- package/doc-design/document-sets/module.md +6 -2
- package/doc-design/document-sets/ops-guide.md +25 -27
- package/doc-design/documents/class-design.md +7 -4
- package/doc-design/documents/instrumentation.md +3 -2
- package/doc-design/documents/integration-guide.md +7 -5
- package/doc-design/documents/interaction.md +516 -143
- package/doc-design/documents/interface.md +12 -7
- package/doc-design/documents/release.md +137 -105
- package/doc-design/patterns/interface.md +135 -14
- package/doc-design/repo-types/client-sdk.md +3 -3
- package/doc-design/repo-types/web-app.md +11 -5
- 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 +12 -6
- package/skills/aca-design/SKILL.md.tmpl +9 -5
- package/skills/aca-implement/SKILL.md +102 -114
- package/skills/aca-implement/SKILL.md.tmpl +103 -115
- package/skills/aca-release/SKILL.md +13 -20
- package/skills/aca-release/SKILL.md.tmpl +13 -20
- package/skills/aca-repo-audit/SKILL.md +13 -9
- package/skills/aca-repo-audit/SKILL.md.tmpl +10 -8
- package/skills/aca-review/SKILL.md +146 -182
- package/skills/aca-review/SKILL.md.tmpl +143 -181
- package/skills/aca-test/SKILL.md +112 -0
- package/skills/aca-test/SKILL.md.tmpl +110 -0
- package/skills/aca-walkthrough/SKILL.md +18 -14
- package/skills/aca-walkthrough/SKILL.md.tmpl +15 -13
- package/zh-CN/CONTEXT.md +2 -2
- package/zh-CN/SSOT.md +5 -0
- package/zh-CN/axioms/README.md +1 -1
- package/zh-CN/axioms/writing.md +3 -1
- package/zh-CN/dist/antigravity/aca/SKILL.md +3 -2
- package/zh-CN/dist/antigravity/aca-design/SKILL.md +12 -6
- package/zh-CN/dist/antigravity/aca-implement/SKILL.md +102 -114
- package/zh-CN/dist/antigravity/aca-release/SKILL.md +71 -69
- package/zh-CN/dist/antigravity/aca-repo-audit/SKILL.md +39 -29
- package/zh-CN/dist/antigravity/aca-review/SKILL.md +143 -179
- package/zh-CN/dist/antigravity/aca-test/SKILL.md +112 -0
- package/zh-CN/dist/antigravity/aca-walkthrough/SKILL.md +18 -14
- package/zh-CN/dist/antigravity-cli/aca/SKILL.md +3 -2
- package/zh-CN/dist/antigravity-cli/aca-design/SKILL.md +12 -6
- package/zh-CN/dist/antigravity-cli/aca-implement/SKILL.md +102 -114
- package/zh-CN/dist/antigravity-cli/aca-release/SKILL.md +71 -69
- package/zh-CN/dist/antigravity-cli/aca-repo-audit/SKILL.md +39 -29
- package/zh-CN/dist/antigravity-cli/aca-review/SKILL.md +143 -179
- package/zh-CN/dist/antigravity-cli/aca-test/SKILL.md +112 -0
- package/zh-CN/dist/antigravity-cli/aca-walkthrough/SKILL.md +18 -14
- package/zh-CN/dist/codex/aca/SKILL.md +3 -2
- package/zh-CN/dist/codex/aca-design/SKILL.md +12 -6
- package/zh-CN/dist/codex/aca-implement/SKILL.md +102 -114
- package/zh-CN/dist/codex/aca-release/SKILL.md +71 -69
- package/zh-CN/dist/codex/aca-repo-audit/SKILL.md +39 -29
- package/zh-CN/dist/codex/aca-review/SKILL.md +143 -179
- package/zh-CN/dist/codex/aca-test/SKILL.md +112 -0
- package/zh-CN/dist/codex/aca-walkthrough/SKILL.md +18 -14
- package/zh-CN/dist/cursor/aca/SKILL.md +3 -2
- package/zh-CN/dist/cursor/aca-design/SKILL.md +12 -6
- package/zh-CN/dist/cursor/aca-implement/SKILL.md +102 -114
- package/zh-CN/dist/cursor/aca-release/SKILL.md +71 -69
- package/zh-CN/dist/cursor/aca-repo-audit/SKILL.md +39 -29
- package/zh-CN/dist/cursor/aca-review/SKILL.md +143 -179
- package/zh-CN/dist/cursor/aca-test/SKILL.md +113 -0
- package/zh-CN/dist/cursor/aca-walkthrough/SKILL.md +18 -14
- package/zh-CN/dist/grok/aca/SKILL.md +3 -2
- package/zh-CN/dist/grok/aca-design/SKILL.md +12 -6
- package/zh-CN/dist/grok/aca-implement/SKILL.md +102 -114
- package/zh-CN/dist/grok/aca-release/SKILL.md +71 -69
- package/zh-CN/dist/grok/aca-repo-audit/SKILL.md +39 -29
- package/zh-CN/dist/grok/aca-review/SKILL.md +143 -179
- package/zh-CN/dist/grok/aca-test/SKILL.md +112 -0
- package/zh-CN/dist/grok/aca-walkthrough/SKILL.md +18 -14
- package/zh-CN/doc-design/document-sets/module.md +6 -2
- package/zh-CN/doc-design/document-sets/ops-guide.md +25 -27
- package/zh-CN/doc-design/documents/class-design.md +7 -4
- package/zh-CN/doc-design/documents/instrumentation.md +3 -2
- package/zh-CN/doc-design/documents/integration-guide.md +7 -5
- package/zh-CN/doc-design/documents/interaction.md +516 -143
- package/zh-CN/doc-design/documents/interface.md +12 -7
- package/zh-CN/doc-design/documents/release.md +138 -106
- package/zh-CN/doc-design/patterns/interface.md +135 -14
- package/zh-CN/doc-design/repo-types/client-sdk.md +3 -3
- package/zh-CN/doc-design/repo-types/web-app.md +11 -5
- 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 +12 -6
- package/zh-CN/skills/aca-design/SKILL.md.tmpl +9 -5
- package/zh-CN/skills/aca-implement/SKILL.md +102 -114
- package/zh-CN/skills/aca-implement/SKILL.md.tmpl +102 -114
- package/zh-CN/skills/aca-release/SKILL.md +71 -69
- package/zh-CN/skills/aca-release/SKILL.md.tmpl +71 -69
- package/zh-CN/skills/aca-repo-audit/SKILL.md +39 -29
- package/zh-CN/skills/aca-repo-audit/SKILL.md.tmpl +36 -28
- package/zh-CN/skills/aca-review/SKILL.md +143 -179
- package/zh-CN/skills/aca-review/SKILL.md.tmpl +140 -178
- package/zh-CN/skills/aca-test/SKILL.md +112 -0
- package/zh-CN/skills/aca-test/SKILL.md.tmpl +110 -0
- package/zh-CN/skills/aca-walkthrough/SKILL.md +18 -14
- package/zh-CN/skills/aca-walkthrough/SKILL.md.tmpl +15 -13
|
@@ -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 ~/.gemini/antigravity-cli/skills/aca/bin/aca-repo-type-check` 检查工程类型
|
|
58
59
|
类型缺失或无效时,停止并建议运行 `/aca-init`
|
|
59
60
|
类型尚未支持时,停止并报告无法核对类型规则
|
|
60
|
-
3.
|
|
61
|
+
3. **读取类型规则与发布流程**
|
|
62
|
+
读取 `~/.gemini/antigravity-cli/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,18 +97,16 @@ flowchart TD
|
|
|
94
97
|
|
|
95
98
|
### 3.3 通告配置
|
|
96
99
|
|
|
97
|
-
1.
|
|
100
|
+
1. **检查通告配置**
|
|
101
|
+
运行 `bash ~/.gemini/antigravity-cli/skills/aca/bin/aca-release-notify-check .` 检查通告配置
|
|
98
102
|
记录检查结果与对应配置位置
|
|
99
|
-
2.
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
| 无法完成检查 | 停止,报告原因与恢复条件 |
|
|
107
|
-
|
|
108
|
-
3. 将配置检查结果用于[通告核对](#72-核对发布通告)
|
|
103
|
+
2. **根据检查结果处理**
|
|
104
|
+
- `NOTIFY_NONE`:记录未配置传输,继续发布
|
|
105
|
+
- `NOTIFY_WIRED`:记录平台与消费点,继续发布
|
|
106
|
+
- `NOTIFY_UNWIRED`:停止,报告通告未使用 `aca-tag-notify-extract <tag>` 提取内容,配置修正后重新检查
|
|
107
|
+
- 无法完成检查:停止,报告原因与恢复条件
|
|
108
|
+
3. **传递配置检查结果**
|
|
109
|
+
将配置检查结果用于[通告核对](#72-核对发布通告)
|
|
109
110
|
配置修正后,重新检查
|
|
110
111
|
配置检查用于确认摘要接入情况
|
|
111
112
|
取得实际发送结果后,才能报告已发送
|
|
@@ -114,54 +115,54 @@ flowchart TD
|
|
|
114
115
|
|
|
115
116
|
### 4.1 收口版本记录
|
|
116
117
|
|
|
117
|
-
1.
|
|
118
|
+
1. **确定版本记录范围**
|
|
118
119
|
按仓库发布流程规定的时机与方式,选取本次适用的版本记录
|
|
119
120
|
未选用 release 文档时,按类型规则确定记录范围
|
|
120
121
|
核对版本记录与本次实际改动是否一致
|
|
121
|
-
2.
|
|
122
|
+
2. **更新版本来源与相关记录**
|
|
122
123
|
按仓库约定更新版本来源及需要同步的文件,收口本版记录
|
|
123
124
|
版本记录与实际改动不一致,或无法判断哪些内容属于当前版本时,停止并说明差异
|
|
124
|
-
3.
|
|
125
|
+
3. **同步 README 版本区块**
|
|
125
126
|
版本来源更新后,将根 README 仓库版本行同步为本次 `<TARGET_VERSION>`,保留仓库名
|
|
126
127
|
- 普通项目:运行 `bash ~/.gemini/antigravity-cli/skills/aca/bin/aca-readme-version-sync README.md "<TARGET_VERSION>"`
|
|
127
128
|
- 发布 Anyone Can Architect 自身:在项目 `VERSION` 更新后,运行 `bash ~/.gemini/antigravity-cli/skills/aca/bin/aca-readme-version-sync README.md "$(tr -d '[:space:]' < VERSION)" "$(tr -d '[:space:]' < VERSION)"`
|
|
128
129
|
同步失败时,停止并报告原因
|
|
129
130
|
版本区块缺失或格式异常时,建议运行 `/aca-init`
|
|
130
131
|
其他失败按实际原因处理
|
|
131
|
-
4.
|
|
132
|
+
4. **核验并提交收口改动**
|
|
132
133
|
核对版本一致性、记录完整性与 README 版本区块格式
|
|
133
134
|
只提交本次修改的版本记录、版本指针和 README 版本区块
|
|
134
135
|
不使用 `git add -A` 裹入无关改动
|
|
135
136
|
|
|
136
137
|
### 4.2 确认合并链
|
|
137
138
|
|
|
138
|
-
1.
|
|
139
|
+
1. **确认最终目标**
|
|
139
140
|
最终合并与版本 Tag 落在 `main`
|
|
140
141
|
确认仓库存在 `main`
|
|
141
142
|
不存在时,停止并报告缺少发布目标分支
|
|
142
|
-
2.
|
|
143
|
+
2. **确定分支顺序**
|
|
143
144
|
选用 release 文档时,按其定义的合并链执行
|
|
144
145
|
未定义合并链时,根据仓库现有分支职责确定
|
|
145
146
|
中间分支用途不明确时,请开发者确认
|
|
146
147
|
不为 Release 新建中间分支
|
|
147
|
-
3.
|
|
148
|
+
3. **明确各次合并要求**
|
|
148
149
|
记录来源分支、目标分支、合并方式与必需检查
|
|
149
150
|
上述要求作为[合入与最终验证](#5-合入与最终验证)的执行依据
|
|
150
|
-
4.
|
|
151
|
+
4. **核对已完成的合并**
|
|
151
152
|
恢复执行时,结合合并记录与版本内容确认完成情况
|
|
152
153
|
已完成且前提仍有效的合并直接沿用
|
|
153
154
|
|
|
154
155
|
### 4.3 合并前审计
|
|
155
156
|
|
|
156
|
-
1.
|
|
157
|
+
1. **明确待合并状态**
|
|
157
158
|
同步目标分支,记录待合并提交与目标分支状态
|
|
158
|
-
2.
|
|
159
|
+
2. **执行或复用仓库审计**
|
|
159
160
|
调用包含实现核对的 `/aca-repo-audit`
|
|
160
161
|
已有结果符合其复用条件时,沿用并注明依据
|
|
161
162
|
不满足复用条件时,重新审计
|
|
162
|
-
3.
|
|
163
|
+
3. **完成仓库要求的额外验证**
|
|
163
164
|
按发布流程执行尚未覆盖的验证与必要操作,记录结果
|
|
164
|
-
4.
|
|
165
|
+
4. **判定是否允许合并**
|
|
165
166
|
审计结论为通过且必需验证通过后,进入[合入与最终验证](#5-合入与最终验证)
|
|
166
167
|
审计结论为需要处理或未完成时,停止合并
|
|
167
168
|
必需验证失败或未完成时,停止合并
|
|
@@ -171,42 +172,42 @@ flowchart TD
|
|
|
171
172
|
|
|
172
173
|
### 5.1 按分支链合入 main
|
|
173
174
|
|
|
174
|
-
1.
|
|
175
|
+
1. **选择下一次合并**
|
|
175
176
|
按[合并链](#42-确认合并链)选择尚未完成的步骤
|
|
176
177
|
核对来源分支、目标分支与合并前审计是否仍然有效
|
|
177
|
-
2.
|
|
178
|
+
2. **按仓库约定执行合并**
|
|
178
179
|
遵守仓库已有的合并方式与分支保护规则
|
|
179
180
|
- 需要 Pull Request:创建或更新 Pull Request
|
|
180
181
|
- 允许本地合并:按仓库约定执行
|
|
181
182
|
不强推、不跳过检查、不绕过保护规则
|
|
182
|
-
3.
|
|
183
|
+
3. **确认合并完成**
|
|
183
184
|
核对实际合并结果及目标分支中的版本内容,记录结果提交
|
|
184
185
|
Pull Request 尚未合并时,记录等待状态与恢复位置
|
|
185
186
|
合并完成后,再进入下一次合并
|
|
186
187
|
全部合入 main 后,进入[最终提交验证](#52-最终提交验证)
|
|
187
|
-
4.
|
|
188
|
+
4. **处理冲突并恢复**
|
|
188
189
|
出现冲突时,停止合并并报告冲突文件与原因
|
|
189
190
|
冲突解决并提交后,按[合并前审计](#43-合并前审计)重新核对审计与受影响的验证
|
|
190
191
|
准入条件满足后,继续合并
|
|
191
192
|
|
|
192
193
|
### 5.2 最终提交验证
|
|
193
194
|
|
|
194
|
-
1.
|
|
195
|
+
1. **定位最终提交**
|
|
195
196
|
同步 main,确认本版合并完成
|
|
196
197
|
记录准备锁定的 main 提交
|
|
197
|
-
2.
|
|
198
|
+
2. **核对版本与内容**
|
|
198
199
|
核对 main 上的最终版本号与本次目标版本一致
|
|
199
200
|
核对适用的版本记录已收口
|
|
200
201
|
核对根 README 仓库版本行与本次 Tag 版本一致
|
|
201
202
|
核对 Anyone Can Architect footer 与当前 Anyone Can Architect 版本一致,紧随仓库版本行且为最后一行
|
|
202
203
|
核对最终提交包含本次范围完整的设计、实现和测试
|
|
203
|
-
3.
|
|
204
|
-
|
|
204
|
+
3. **完成最终验证**
|
|
205
|
+
在最终提交上完成仓库发布流程规定的验证与 `/aca-test` 测试范围
|
|
205
206
|
记录验证结果与对应提交
|
|
206
|
-
|
|
207
|
+
复用已有 `/aca-test` 或验证结果时,说明满足的复用条件及其与最终提交的对应依据
|
|
207
208
|
涉及制品时,核对制品与该提交的追溯关系
|
|
208
209
|
验证产物不能代替交付完成的证据
|
|
209
|
-
4.
|
|
210
|
+
4. **判定是否允许锁定版本**
|
|
210
211
|
必需核对与验证全部通过后,进入[锁定版本](#6-锁定版本)
|
|
211
212
|
失败或未完成时,停止并按[输出结果与下一步](#8-输出结果与下一步)报告原因与恢复位置
|
|
212
213
|
|
|
@@ -217,11 +218,12 @@ flowchart TD
|
|
|
217
218
|
发布摘要是 Release 的必产物
|
|
218
219
|
版本通告从 annotated Tag 的 NOTIFY 块生成
|
|
219
220
|
|
|
220
|
-
1.
|
|
221
|
+
1. **核对已有 Tag 与内容来源**
|
|
221
222
|
- 已有 Tag 的指向与注解已核对通过:保留注解,转至[创建与推送 Tag](#62-创建与推送-tag)继续未完成步骤
|
|
222
223
|
- 需要创建 Tag:根据本版版本记录或已确认 Issue,对照本版实际改动确定摘要内容
|
|
223
224
|
验证事实取自[最终提交验证](#52-最终提交验证)的记录
|
|
224
|
-
2.
|
|
225
|
+
2. **按统一格式编写摘要**
|
|
226
|
+
按以下格式编写摘要,写入 `~/.aca/release-note-<TAG>.md`
|
|
225
227
|
|
|
226
228
|
```text
|
|
227
229
|
vX.Y.Z:<一句话主题>(#issue …)
|
|
@@ -239,20 +241,22 @@ flowchart TD
|
|
|
239
241
|
- 变化建议写 3–6 条,不用文件名或提交哈希代替变化描述
|
|
240
242
|
- 末条记录真实验证结果,以 ✅ 开头
|
|
241
243
|
|
|
242
|
-
3.
|
|
244
|
+
3. **机械校验摘要**
|
|
245
|
+
运行 `bash ~/.gemini/antigravity-cli/skills/aca/bin/aca-tag-notify-check ~/.aca/release-note-<TAG>.md <TAG>` 校验摘要
|
|
243
246
|
校验失败时,修正后重新校验
|
|
244
247
|
校验通过后,将摘要文件交给[创建与推送 Tag](#62-创建与推送-tag)
|
|
245
248
|
不使用一行标题或空注解
|
|
246
249
|
|
|
247
250
|
### 6.2 创建与推送 Tag
|
|
248
251
|
|
|
249
|
-
1.
|
|
252
|
+
1. **核对最新状态**
|
|
250
253
|
同步远端,核对本地与远端目标 Tag 是否存在
|
|
251
|
-
2.
|
|
254
|
+
2. **处理已有 Tag**
|
|
252
255
|
指向与注解匹配时,保留已有 Tag 并继续剩余步骤
|
|
253
256
|
存在冲突时,停止并报告冲突
|
|
254
257
|
不移动或重建已有 Tag
|
|
255
|
-
3.
|
|
258
|
+
3. **创建 annotated Tag**
|
|
259
|
+
本地与远端均无目标 Tag 时,创建 annotated Tag
|
|
256
260
|
创建前确认 main 仍指向[最终提交验证](#52-最终提交验证)记录的提交
|
|
257
261
|
确认[发布摘要](#61-发布摘要)已校验通过
|
|
258
262
|
- main 已变化:按[最终提交验证](#52-最终提交验证)重新核验新的最终提交
|
|
@@ -263,23 +267,24 @@ flowchart TD
|
|
|
263
267
|
git tag -a "<TAG>" "<VERIFIED_MAIN_COMMIT>" -F ~/.aca/release-note-<TAG>.md
|
|
264
268
|
```
|
|
265
269
|
|
|
266
|
-
4.
|
|
270
|
+
4. **推送目标 Tag**
|
|
271
|
+
远端尚无目标 Tag 时,按仓库约定推送
|
|
267
272
|
推送失败时,记录原因与恢复位置
|
|
268
273
|
恢复后,核对最新状态再补推送
|
|
269
274
|
推送完成或远端已有目标 Tag 时,按[核对远端 Tag](#63-核对远端-tag)核验结果
|
|
270
275
|
|
|
271
276
|
### 6.3 核对远端 Tag
|
|
272
277
|
|
|
273
|
-
1.
|
|
278
|
+
1. **读取远端实际结果**
|
|
274
279
|
核对目标 Tag 是否存在
|
|
275
280
|
不存在时,按[创建与推送 Tag](#62-创建与推送-tag)处理推送后,重新核对
|
|
276
281
|
存在时,取得其类型、指向的提交与注解
|
|
277
|
-
2.
|
|
282
|
+
2. **核对固化内容**
|
|
278
283
|
确认目标为 annotated Tag
|
|
279
284
|
核对提交与本次已验证的 main 提交一致
|
|
280
285
|
核对注解与本次已确认的摘要一致
|
|
281
286
|
恢复旧版本时,对照该版本的固化记录核对
|
|
282
|
-
3.
|
|
287
|
+
3. **记录状态并推进**
|
|
283
288
|
核对通过后,记录远端固化事实,进入[发布后处理](#7-发布后处理)
|
|
284
289
|
无法核对或发现冲突时,停止并报告原因与恢复条件
|
|
285
290
|
保留已有 Tag
|
|
@@ -288,14 +293,14 @@ flowchart TD
|
|
|
288
293
|
|
|
289
294
|
### 7.1 清理版本分支
|
|
290
295
|
|
|
291
|
-
1.
|
|
296
|
+
1. **确定清理范围**
|
|
292
297
|
按仓库约定列出本次版本分支,以及需要清理的本地与远端范围
|
|
293
|
-
2.
|
|
298
|
+
2. **核对清理条件**
|
|
294
299
|
确认[远端 Tag 核对](#63-核对远端-tag)已通过
|
|
295
300
|
结合合并记录与版本内容,确认候选分支已合入 main
|
|
296
301
|
保留仍承担后续工作的分支
|
|
297
302
|
无法确认归属或合并情况时,保留并记录原因
|
|
298
|
-
3.
|
|
303
|
+
3. **执行并核对清理结果**
|
|
299
304
|
仅清理满足条件的本次分支,记录实际结果
|
|
300
305
|
无法完成时,报告剩余分支、原因与恢复条件
|
|
301
306
|
清理失败不改变版本已经固化的事实
|
|
@@ -303,19 +308,15 @@ flowchart TD
|
|
|
303
308
|
|
|
304
309
|
### 7.2 核对发布通告
|
|
305
310
|
|
|
306
|
-
1.
|
|
311
|
+
1. **定位发送结果**
|
|
307
312
|
根据[通告配置](#33-通告配置)与仓库发布流程,查找本次 Tag 对应的任务、日志或发送回执
|
|
308
|
-
2.
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
| 未确认 | 缺少足以判断发送状态的证据 |
|
|
316
|
-
| 未配置传输 | 配置检查确认未设置发送机制 |
|
|
317
|
-
|
|
318
|
-
3. 处理后续动作
|
|
313
|
+
2. **根据证据记录发送状态**
|
|
314
|
+
- 有本次 Tag 对应的发送成功证据:标记已发送
|
|
315
|
+
- 已确认任务仍在等待或执行:标记等待发送
|
|
316
|
+
- 有明确的发送失败结果:标记发送失败
|
|
317
|
+
- 缺少足以判断发送状态的证据:标记未确认
|
|
318
|
+
- 配置检查确认未设置发送机制:标记未配置传输
|
|
319
|
+
3. **处理后续动作**
|
|
319
320
|
发送失败时,按仓库约定恢复或重发
|
|
320
321
|
状态未确认时,报告缺少的证据
|
|
321
322
|
重发使用 `aca-tag-notify-extract <tag>` 从已锁定 Tag 提取内容
|
|
@@ -327,9 +328,9 @@ flowchart TD
|
|
|
327
328
|
|
|
328
329
|
### 8.1 判定完成状态
|
|
329
330
|
|
|
330
|
-
1.
|
|
331
|
+
1. **判定版本固化状态**
|
|
331
332
|
按[远端 Tag 核对](#63-核对远端-tag)的结果,记录已固化、未固化或未确认
|
|
332
|
-
2.
|
|
333
|
+
2. **判定 Release 完成状态**
|
|
333
334
|
仓库发布流程的必需步骤完成,远端 annotated Tag 的指向与注解核对通过时,标记 Release 完成
|
|
334
335
|
未满足完成条件时,标记未完成
|
|
335
336
|
清理或通告未完成时,按仓库对这些步骤的必需性判定流程状态
|
|
@@ -369,7 +370,8 @@ flowchart TD
|
|
|
369
370
|
| 缺少执行条件 | 补齐后按[发布准备](#3-发布准备)核对状态并恢复 |
|
|
370
371
|
| 设计方案仍需论证 | `/aca-specify` 论证方案 |
|
|
371
372
|
| 修订方案已明确,仅需改文档 | `/aca-design` 修订文档 |
|
|
372
|
-
| 实现问题 | `/aca-implement`
|
|
373
|
+
| 实现问题 | `/aca-implement` 修复代码或测试 |
|
|
374
|
+
| 测试或最终验证未完成 | `/aca-test` 执行验证后恢复发布 |
|
|
373
375
|
| 合并冲突 | 处理并提交冲突解决结果后,重新执行[合并前审计](#43-合并前审计) |
|
|
374
376
|
| 推送、清理或通告尚未完成 | 从对应的未完成步骤恢复 |
|
|
375
377
|
| 全部完成且无后续事项 | 报告无待办 |
|
|
@@ -34,7 +34,7 @@ description: 检查仓库文档与按需核对实现,只读不改
|
|
|
34
34
|
- 先交代整体,再展开细节,参见[金字塔原理](~/.gemini/antigravity-cli/skills/aca/SSOT.md#2-文档结构)
|
|
35
35
|
- 表达判断时,先给结论,再给依据
|
|
36
36
|
- 不增加信息的标题层级应当合并
|
|
37
|
-
-
|
|
37
|
+
- 有时序或优先级的条目用编号列表,包含子项时每步以加粗短语开头表达目的,具体操作与条件分支缩进在该步下
|
|
38
38
|
- 表格只用于多行同构、每行有两个以上属性、行之间没有先后关系的内容
|
|
39
39
|
- 列表项直接写完整的句子
|
|
40
40
|
- 一个条目有分支时,将分支缩进列在该条目下
|
|
@@ -53,6 +53,8 @@ description: 检查仓库文档与按需核对实现,只读不改
|
|
|
53
53
|
- 删除不增加信息、也不帮助理解的内容
|
|
54
54
|
- 一行一句,每句只表达一个事实
|
|
55
55
|
- 操作步骤直接写动作
|
|
56
|
+
- 能用具体做法完整表达的约束,直接写做法
|
|
57
|
+
- 无法用具体做法完整表达的禁止事项仍须保留
|
|
56
58
|
- 有先后关系的动作分项写
|
|
57
59
|
- 执行者、操作对象与指代必须明确
|
|
58
60
|
- 上下文已经明确的执行者、操作对象与指代不重复说明
|
|
@@ -88,18 +90,20 @@ flowchart TD
|
|
|
88
90
|
|
|
89
91
|
## 3 审计准备
|
|
90
92
|
|
|
91
|
-
1.
|
|
93
|
+
1. **确定本次审计范围**
|
|
92
94
|
优先采用开发者指定的范围,其次沿用调用方明确的范围
|
|
93
95
|
未指定时,默认审计整个仓库
|
|
94
96
|
记录本次检查对应的提交及纳入范围的未提交改动
|
|
95
|
-
2.
|
|
97
|
+
2. **检查工程类型**
|
|
98
|
+
运行 `bash ~/.gemini/antigravity-cli/skills/aca/bin/aca-repo-type-check` 检查工程类型
|
|
96
99
|
类型缺失、无效或尚未支持时,将类型规则核对列为未完成
|
|
97
100
|
类型缺失或无效时,建议通过 `/aca-init` 修正
|
|
98
101
|
继续其余不依赖类型规则的检查
|
|
99
|
-
3.
|
|
102
|
+
3. **确定是否包含实现审计**
|
|
100
103
|
开发者要求或 `/aca-release` 调用时,包含实现审计
|
|
101
104
|
其他情况执行文档审计
|
|
102
|
-
4.
|
|
105
|
+
4. **读取规则并定位入口**
|
|
106
|
+
读取有效类型的规则与 `CONTEXT.md`,核对项目术语
|
|
103
107
|
从根 README 定位本次审计范围的文档入口
|
|
104
108
|
入口无法定位时,请开发者提供位置
|
|
105
109
|
位置明确前,将依赖这些内容的检查列为未完成
|
|
@@ -108,21 +112,24 @@ flowchart TD
|
|
|
108
112
|
|
|
109
113
|
### 4.1 读取文档
|
|
110
114
|
|
|
111
|
-
1.
|
|
115
|
+
1. **建立本次范围的文档清单**
|
|
112
116
|
根据类型规则的必要条件与已选用的文档组,列出应有的文档
|
|
113
117
|
对照 README 入口与实际目录,记录缺失文档及未登记的文档
|
|
114
|
-
2.
|
|
118
|
+
2. **读取清单文档与关联引用**
|
|
119
|
+
读取清单中的文档,沿引用补齐理解与核验所需的内容
|
|
115
120
|
范围外的引用作为关联依据,不自动扩大审计范围
|
|
116
|
-
3.
|
|
121
|
+
3. **提取适用检查条件**
|
|
122
|
+
读取对应的文档组、Doc Design 与实际采用的 Pattern
|
|
117
123
|
提取适用检查条件,作为后续逐项核对的依据
|
|
118
124
|
|
|
119
125
|
### 4.2 机械检查
|
|
120
126
|
|
|
121
|
-
1.
|
|
127
|
+
1. **确定实际检查路径**
|
|
128
|
+
根据[文档清单](#41-读取文档)确定实际检查路径
|
|
122
129
|
文档图检查覆盖本次审计的文档目录
|
|
123
130
|
行文检查覆盖本次审计的全部文档,包括涉及的项目级文件
|
|
124
131
|
审计范围包含 Context 时,检查其结构与格式
|
|
125
|
-
2.
|
|
132
|
+
2. **执行或复用机械检查**
|
|
126
133
|
本会话已有相同范围的结果,且相关文件、检查规则与工具均未变化时,可复用
|
|
127
134
|
在报告中注明原检查结果与复用依据
|
|
128
135
|
不满足复用条件时,将以下占位符替换为实际路径并执行对应检查
|
|
@@ -133,7 +140,7 @@ flowchart TD
|
|
|
133
140
|
bash ~/.gemini/antigravity-cli/skills/aca/bin/aca-context-check <本次审计的 Context 文档>
|
|
134
141
|
```
|
|
135
142
|
|
|
136
|
-
3.
|
|
143
|
+
3. **根据实际诊断处理检查结果**
|
|
137
144
|
检查通过时,记录结果与依据
|
|
138
145
|
检出问题时,核实诊断,将成立的问题列为必须处理
|
|
139
146
|
工具缺失或运行失败时,将对应检查列为未完成并说明原因
|
|
@@ -142,17 +149,18 @@ flowchart TD
|
|
|
142
149
|
|
|
143
150
|
### 4.3 内容检查
|
|
144
151
|
|
|
145
|
-
1.
|
|
152
|
+
1. **逐项核对适用检查条件**
|
|
153
|
+
逐项核对[读取文档](#41-读取文档)中提取的适用检查条件
|
|
146
154
|
结合[行文公理](#12-行文公理)核对表达
|
|
147
155
|
每项记录核验结果、对应位置与依据
|
|
148
156
|
不适用的条件说明原因
|
|
149
|
-
2.
|
|
157
|
+
2. **顺着文档主线核对跨文档关系**
|
|
150
158
|
- 入口和阅读顺序是否明确
|
|
151
159
|
- 同一功能、术语、版本或流程是否互相矛盾
|
|
152
160
|
- 同一信息是否由多篇文档重复维护
|
|
153
161
|
- 是否存在过时内容、残稿、空文档或无法指导行动的空话
|
|
154
162
|
- 设计正文是否只描述当前目标设计,未混入旧版本差异、改动过程或改动原因
|
|
155
|
-
3.
|
|
163
|
+
3. **记录问题与未完成项**
|
|
156
164
|
问题记录位置、依据、影响和处理建议
|
|
157
165
|
跨文档重复时,指出信息应保留的位置
|
|
158
166
|
其他位置建议删除重复内容或改为引用
|
|
@@ -166,15 +174,15 @@ flowchart TD
|
|
|
166
174
|
|
|
167
175
|
本次包含实现审计时,双向核对本次范围内的全部设计项,不抽样
|
|
168
176
|
|
|
169
|
-
1.
|
|
177
|
+
1. **列出应实现的设计项**
|
|
170
178
|
以本次已确认的交付范围为依据,列出模块、行为、接口、状态、错误处理与验收条件
|
|
171
|
-
2.
|
|
179
|
+
2. **从设计核对实现**
|
|
172
180
|
为每个设计项定位对应代码、测试和配置
|
|
173
181
|
核对是否完整实现、是否符合设计约定
|
|
174
|
-
3.
|
|
182
|
+
3. **从实现核对设计**
|
|
175
183
|
检查实际业务行为能否对应到设计说明
|
|
176
184
|
辅助函数、工具代码与工程样板,核对其对设计行为的影响
|
|
177
|
-
4.
|
|
185
|
+
4. **记录对应关系与偏移**
|
|
178
186
|
每个设计项记录核对结果与依据
|
|
179
187
|
每个偏移给出设计文档与实现位置
|
|
180
188
|
缺少一侧时,说明缺失内容
|
|
@@ -182,16 +190,17 @@ flowchart TD
|
|
|
182
190
|
|
|
183
191
|
### 5.2 运行验证
|
|
184
192
|
|
|
185
|
-
1.
|
|
186
|
-
|
|
193
|
+
1. **确定验证要求**
|
|
194
|
+
按 `/aca-test` 的边界规则与仓库 `release` 文档,确定本次范围所需的测试与构建命令
|
|
195
|
+
仓库未规定分级时,默认执行完整测试与构建
|
|
187
196
|
核对所需环境、配置与夹具
|
|
188
|
-
2.
|
|
189
|
-
|
|
197
|
+
2. **执行或复用验证结果**
|
|
198
|
+
已有 `/aca-test` 或构建结果覆盖所需范围,且受审提交、测试、夹具、配置、依赖环境及命令均未变化时,可复用
|
|
190
199
|
在报告中注明原验证结果与复用依据
|
|
191
|
-
|
|
200
|
+
不满足复用条件时,在隔离环境中按 `/aca-test` 的执行规则运行所需测试与构建
|
|
192
201
|
静态阅读不能代替执行验证
|
|
193
202
|
验证过程中不修改项目源码、设计文档或提交记录
|
|
194
|
-
3.
|
|
203
|
+
3. **记录结果并处理异常**
|
|
195
204
|
验证通过时,记录结果与依据
|
|
196
205
|
验证失败时,核实诊断并记录成立的问题
|
|
197
206
|
环境缺失或无法执行时,将对应验证列为未完成并说明原因
|
|
@@ -202,15 +211,15 @@ flowchart TD
|
|
|
202
211
|
|
|
203
212
|
### 6.1 复核结果
|
|
204
213
|
|
|
205
|
-
1.
|
|
214
|
+
1. **核对证据对应关系**
|
|
206
215
|
确认检查结果与本次受审内容一致
|
|
207
216
|
核对复用结果是否满足对应条件
|
|
208
|
-
2.
|
|
217
|
+
2. **复核问题清单**
|
|
209
218
|
核对问题涉及的文件与证据,确认成立后纳入报告
|
|
210
219
|
已证伪的问题排除
|
|
211
220
|
证据不足的问题列为未完成核验
|
|
212
221
|
合并重复问题,保留相关位置、依据与影响
|
|
213
|
-
3.
|
|
222
|
+
3. **核对检查覆盖**
|
|
214
223
|
对照文档清单、适用检查条件及本次实现审计要求,核对是否遗漏
|
|
215
224
|
能补查的项目完成补查
|
|
216
225
|
仍无法完成的项目,记录范围、原因与恢复条件
|
|
@@ -224,7 +233,7 @@ flowchart TD
|
|
|
224
233
|
| 未完成 | 未满足通过条件,且无已确认的必须处理项 |
|
|
225
234
|
|
|
226
235
|
必需检查包括本次范围的文档读取、机械检查与内容检查
|
|
227
|
-
|
|
236
|
+
包含实现审计时,还包括全部一致性核对、本次范围所需的测试与构建
|
|
228
237
|
同时存在必须处理项与未完成检查时,结论为需要处理,并列出未完成项
|
|
229
238
|
可选精简不影响通过
|
|
230
239
|
|
|
@@ -274,7 +283,8 @@ flowchart TD
|
|
|
274
283
|
| 缺少核验条件 | 补齐后通过 `/aca-repo-audit` 继续本次审计 |
|
|
275
284
|
| 方案仍需论证 | `/aca-specify` 论证方案 |
|
|
276
285
|
| 修订方案已明确,仅需改文档 | `/aca-design` 修订文档 |
|
|
277
|
-
| 实现偏移 | `/aca-implement`
|
|
286
|
+
| 实现偏移 | `/aca-implement` 修复代码或测试 |
|
|
287
|
+
| 测试或构建未完成 | `/aca-test` 执行验证 |
|
|
278
288
|
| 审计通过 | 返回调用方,按已确认的安排继续 |
|
|
279
289
|
|
|
280
290
|
问题修正后,重新审计受影响范围
|