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