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
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: aca-test
|
|
3
|
+
description: 根据当前实现或改动影响范围选取并运行最小化测试,只测不改
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# aca-test
|
|
7
|
+
|
|
8
|
+
根据当前实现范围或改动突破的设计边界,选取并运行对应的最小化测试
|
|
9
|
+
只执行测试与验证,不修改设计文档、生产代码或测试代码
|
|
10
|
+
|
|
11
|
+
## 1 原则
|
|
12
|
+
|
|
13
|
+
1. **影响定界**
|
|
14
|
+
以本次实现或改动的契约边界与依赖关系确定最小化测试范围
|
|
15
|
+
2. **只测不改**
|
|
16
|
+
只运行测试并核实结果,不修改设计文档、生产代码或测试代码
|
|
17
|
+
3. **证据绑定**
|
|
18
|
+
测试结果绑定被测提交、测试范围与实际执行的命令,供后续环节直接复用
|
|
19
|
+
|
|
20
|
+
## 2 执行流程
|
|
21
|
+
|
|
22
|
+
```mermaid
|
|
23
|
+
flowchart TD
|
|
24
|
+
Start([接收测试请求]) --> Scope["确定测试范围 · §3"]
|
|
25
|
+
Scope --> Reuse{"满足结果复用条件? · §3"}
|
|
26
|
+
Reuse -- 是 --> Report(["输出结果与下一步 · §5"])
|
|
27
|
+
Reuse -- 否 --> Ready{"测试环境与前置条件就绪? · §3"}
|
|
28
|
+
Ready -- 否 --> Report
|
|
29
|
+
Ready -- 是 --> Run["运行测试与异常复核 · §4"]
|
|
30
|
+
Run --> Report
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## 3 确定测试范围
|
|
34
|
+
|
|
35
|
+
1. **确定被测对象与改动范围**
|
|
36
|
+
- 开发者或上游调用方已明确本次待测范围:直接沿用该范围
|
|
37
|
+
- 未明确范围:读取当前工作区改动与近期提交,对照设计文档定位改动所属的模块、命令或事件
|
|
38
|
+
- 记录本次被测提交及纳入验证的未提交改动
|
|
39
|
+
2. **按变更突破的设计边界选取最小化测试集**
|
|
40
|
+
- 仅实现或修改模块、命令或事件内部,模块 `interface`、命令路由与事件调度契约未变化:只选取该单元自身的白盒与黑盒测试
|
|
41
|
+
- 修改模块 `interface`、命令路由、事件调度或跨单元协作:选取本单元测试、调用该契约的模块或命令与事件测试,以及项目级 `testcase` 中设计依据关联该单元的黑盒测试
|
|
42
|
+
- 修改公共基础、全局配置、数据迁移、构建或部署等跨模块共享底座:选取受影响的全量测试与对应环境验证
|
|
43
|
+
- 仓库 `release` 文档对当前验证另有规定时,一并纳入
|
|
44
|
+
3. **核对复用条件与执行环境**
|
|
45
|
+
- 已有测试结果覆盖本次选定范围,且被测内容、测试代码、夹具、配置与依赖环境均未变化:直接复用并记录依据,进入[输出结果与下一步](#5-输出结果与下一步)
|
|
46
|
+
- 需要执行测试:按测试设计核对所需环境、夹具及真实依赖或测试替身的就绪状态
|
|
47
|
+
- 环境或依赖未就绪:记录缺失条件,按[输出结果与下一步](#5-输出结果与下一步)报告未完成
|
|
48
|
+
|
|
49
|
+
## 4 运行与复核
|
|
50
|
+
|
|
51
|
+
1. **控制并发与资源隔离**
|
|
52
|
+
- 按测试设计建立夹具与隔离环境
|
|
53
|
+
- 涉及容器、数据库、真实平台或模型评测等共享或重型资源时,限制并发度并隔离资源,避免并行争用导致超时
|
|
54
|
+
2. **执行选定测试**
|
|
55
|
+
- 运行[确定测试范围](#3-确定测试范围)选定的测试用例及必要的构建或静态检查
|
|
56
|
+
- 执行完成后,按夹具规定清理本次产生的测试数据与临时资源
|
|
57
|
+
- 验证过程中不修改设计文档、生产代码、测试代码或提交记录
|
|
58
|
+
3. **复核失败并区分原因**
|
|
59
|
+
- 全部通过:记录执行命令、通过用例数与耗时
|
|
60
|
+
- 出现失败:对照已确认的设计,核对失败日志、测试用例、夹具与实现
|
|
61
|
+
- 疑似宿主高负载或资源争用导致超时:在低并发隔离条件下单独重跑失败项核实
|
|
62
|
+
- 单独重跑稳定通过且确认为环境负载所致:记录初跑异常、重跑命令与通过结果
|
|
63
|
+
- 实现偏离设计:报告实现问题,指出失败用例与对应实现位置
|
|
64
|
+
- 用例预期过时或测试、夹具本身错误:报告测试问题,指出对应设计依据与错误位置
|
|
65
|
+
- 设计缺失或契约冲突:将对应验证列为未完成,交由 `/aca-specify` 或 `/aca-design` 补齐
|
|
66
|
+
- 环境故障或诊断无法核实:将对应验证列为未完成并记录原因
|
|
67
|
+
|
|
68
|
+
## 5 输出结果与下一步
|
|
69
|
+
|
|
70
|
+
### 5.1 判定结论
|
|
71
|
+
|
|
72
|
+
| 结论 | 条件 |
|
|
73
|
+
| --- | --- |
|
|
74
|
+
| 通过 | 本次选定范围的测试与必需检查全部通过(含复用或超时复核通过),无失败项与未完成项 |
|
|
75
|
+
| 失败 | 存在已确认的代码或测试失败项 |
|
|
76
|
+
| 未完成 | 设计缺失、契约冲突、环境缺失、无法执行或诊断无法核实,且无已确认的失败项 |
|
|
77
|
+
|
|
78
|
+
同时存在已确认的失败项与未完成项时,结论为失败,并列出未完成项
|
|
79
|
+
|
|
80
|
+
### 5.2 测试报告
|
|
81
|
+
|
|
82
|
+
在当前对话中按以下模板输出测试结果
|
|
83
|
+
|
|
84
|
+
```markdown
|
|
85
|
+
# 🧪 Test:<通过 / 失败 / 未完成>
|
|
86
|
+
|
|
87
|
+
| 项目 | 结果 |
|
|
88
|
+
| --- | --- |
|
|
89
|
+
| 范围 | <本次被测单元或改动范围> |
|
|
90
|
+
| 基线 | <被测提交及纳入验证的未提交改动> |
|
|
91
|
+
| 选取依据 | <沿用上游范围 / 契约未变的单元内测试 / 契约变化的依赖链测试 / 全局底座全量测试> |
|
|
92
|
+
| 执行命令 | <实际运行的测试与检查命令,或复用依据> |
|
|
93
|
+
| 结果 | <通过数、失败数与耗时> |
|
|
94
|
+
| 异常复核 | <超时单独重跑核实结果 / 无> |
|
|
95
|
+
| 失败项 | <失败用例、原因与对应位置 / 无> |
|
|
96
|
+
| 未完成 | <未执行的验证、原因与恢复条件 / 无> |
|
|
97
|
+
| 下一步 | <一个立即可执行的动作> |
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
### 5.3 后续动作
|
|
101
|
+
|
|
102
|
+
按测试结论与本轮进度选择下一步
|
|
103
|
+
|
|
104
|
+
| 结论 | 情况 | 下一步 |
|
|
105
|
+
| --- | --- | --- |
|
|
106
|
+
| 未完成 | 测试环境、夹具或外部依赖缺失 | 补齐环境条件后通过 `/aca-test` 重新验证 |
|
|
107
|
+
| 失败 | 代码或测试实现问题 | `/aca-implement` 修复(未改变代码结构时直接通过 `/aca-test` 重新验证,改变代码结构时经 `/aca-review` 审查后再运行 `/aca-test`) |
|
|
108
|
+
| 未完成 | 设计缺失或契约冲突 | `/aca-specify` 或 `/aca-design` 修正设计 |
|
|
109
|
+
| 通过 | 本轮尚有待实施的后续任务 | `/aca-implement` 继续实施下一范围 |
|
|
110
|
+
| 通过 | 本轮实施范围全部验证通过 | 按版本推进安排衔接 `/aca-release` 或结束本次任务 |
|
|
@@ -33,7 +33,7 @@ description: 用业务语言导读设计文档,逐单元确认设计决定,
|
|
|
33
33
|
- 先交代整体,再展开细节,参见[金字塔原理](~/.claude/skills/aca/SSOT.md#2-文档结构)
|
|
34
34
|
- 表达判断时,先给结论,再给依据
|
|
35
35
|
- 不增加信息的标题层级应当合并
|
|
36
|
-
-
|
|
36
|
+
- 有时序或优先级的条目用编号列表,包含子项时每步以加粗短语开头表达目的,具体操作与条件分支缩进在该步下
|
|
37
37
|
- 表格只用于多行同构、每行有两个以上属性、行之间没有先后关系的内容
|
|
38
38
|
- 列表项直接写完整的句子
|
|
39
39
|
- 一个条目有分支时,将分支缩进列在该条目下
|
|
@@ -52,6 +52,8 @@ description: 用业务语言导读设计文档,逐单元确认设计决定,
|
|
|
52
52
|
- 删除不增加信息、也不帮助理解的内容
|
|
53
53
|
- 一行一句,每句只表达一个事实
|
|
54
54
|
- 操作步骤直接写动作
|
|
55
|
+
- 能用具体做法完整表达的约束,直接写做法
|
|
56
|
+
- 无法用具体做法完整表达的禁止事项仍须保留
|
|
55
57
|
- 有先后关系的动作分项写
|
|
56
58
|
- 执行者、操作对象与指代必须明确
|
|
57
59
|
- 上下文已经明确的执行者、操作对象与指代不重复说明
|
|
@@ -99,7 +101,7 @@ flowchart TD
|
|
|
99
101
|
仍无法定位时,请开发者指定文档位置
|
|
100
102
|
读取 `~/.claude/skills/aca/doc-design/repo-types/{repo-type}.md`
|
|
101
103
|
读取 `CONTEXT.md` 与当前范围的设计文档
|
|
102
|
-
|
|
104
|
+
读取对应的文档组与文档设计,按需读取相关 pattern
|
|
103
105
|
4. 安排导读顺序
|
|
104
106
|
按类型规则的治理顺序安排导读
|
|
105
107
|
文档组内部按对应文档组规定的顺序安排
|
|
@@ -153,14 +155,15 @@ flowchart TD
|
|
|
153
155
|
|
|
154
156
|
### 4.2 讨论与核对
|
|
155
157
|
|
|
156
|
-
1.
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
158
|
+
1. **用业务语言导读当前单元**
|
|
159
|
+
- 先说明当前单元要解决的问题与需求,再说明设计如何满足这些需求
|
|
160
|
+
- 涉及业务概念:链接项目 `CONTEXT.md` 中的对应词条,说明概念的含义及其在当前设计中的作用
|
|
161
|
+
2. **核对组织与表达方式**
|
|
162
|
+
- 导读文档整体结构:对照对应文档设计说明章节划分、内容归属与展开顺序,提出需要合并、拆分或重排的内容
|
|
163
|
+
- 导读 Chapter 或 Section:对照对应文档设计的表达要求与 `~/.claude/skills/aca/doc-design/patterns/` 的适用场景,向开发者说明当前表达方式是否适合该内容,不默认沿用已有代码、表格或图
|
|
164
|
+
- 现有表达方式不合适:先向开发者提出替换、拆分或组合后的表达方式并读取所选 pattern,不顺着原有表达局部修补
|
|
165
|
+
3. **逐项核对检查条件**
|
|
166
|
+
- 逐项核对文档组、文档设计与所选 pattern 中适用于当前单元的检查条件
|
|
164
167
|
|
|
165
168
|
| 检查项 | 关注内容 |
|
|
166
169
|
| --- | --- |
|
|
@@ -168,14 +171,14 @@ flowchart TD
|
|
|
168
171
|
| 完整性 | 职责、行为、边界与异常处理的遗漏 |
|
|
169
172
|
| 歧义与实现唯一性 | 多种合理解读、符合描述但行为不同的实现、尚未明确的设计决定 |
|
|
170
173
|
| 冗余 | 重复维护、不增加信息的内容 |
|
|
171
|
-
| 表达 |
|
|
174
|
+
| 表达 | 表达方式选择与适配性、行文公理、对应文档设计与术语一致性 |
|
|
172
175
|
|
|
173
176
|
### 4.3 确认、修订与检查
|
|
174
177
|
|
|
175
|
-
1.
|
|
178
|
+
1. 请开发者确认当前单元的设计决定与表达方式调整
|
|
176
179
|
开发者不理解或有异议时,澄清含义与依据
|
|
177
180
|
尚未确认时,按[讨论与核对](#42-讨论与核对)继续讨论当前单元
|
|
178
|
-
2.
|
|
181
|
+
2. 存在已确认的调整时,按对应文档设计与所选 pattern 当场修订
|
|
179
182
|
涉及章节调整时,同步更新受影响的引用与关联设计
|
|
180
183
|
3. 修订后,重新执行受影响的检查条件与机械检查
|
|
181
184
|
报告修正内容与检查结果
|
|
@@ -244,4 +247,5 @@ flowchart TD
|
|
|
244
247
|
| --- | --- | --- |
|
|
245
248
|
| 未完成 | 尚有未导读单元或缺少核验条件 | 补齐条件后,通过 `/aca-walkthrough` 继续本次导读 |
|
|
246
249
|
| 未完成 | 设计方案在本轮无法确定 | `/aca-specify` 论证方案 |
|
|
247
|
-
| 完成 |
|
|
250
|
+
| 完成 | 当前范围导读完成,且本轮设计涉及跨模块范围 | 通过 `/aca-review` 审查设计 |
|
|
251
|
+
| 完成 | 当前范围导读完成,且本轮设计不涉及跨模块范围 | 直接进入后续流程(需要实施代码时进入 `/aca-implement`,仅改设计文档时衔接 `/aca-release`) |
|
|
@@ -52,7 +52,7 @@ flowchart TD
|
|
|
52
52
|
仍无法定位时,请开发者指定文档位置
|
|
53
53
|
读取 `~/.claude/skills/aca/doc-design/repo-types/{repo-type}.md`
|
|
54
54
|
读取 `CONTEXT.md` 与当前范围的设计文档
|
|
55
|
-
|
|
55
|
+
读取对应的文档组与文档设计,按需读取相关 pattern
|
|
56
56
|
4. 安排导读顺序
|
|
57
57
|
按类型规则的治理顺序安排导读
|
|
58
58
|
文档组内部按对应文档组规定的顺序安排
|
|
@@ -106,14 +106,15 @@ flowchart TD
|
|
|
106
106
|
|
|
107
107
|
### 4.2 讨论与核对
|
|
108
108
|
|
|
109
|
-
1.
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
109
|
+
1. **用业务语言导读当前单元**
|
|
110
|
+
- 先说明当前单元要解决的问题与需求,再说明设计如何满足这些需求
|
|
111
|
+
- 涉及业务概念:链接项目 `CONTEXT.md` 中的对应词条,说明概念的含义及其在当前设计中的作用
|
|
112
|
+
2. **核对组织与表达方式**
|
|
113
|
+
- 导读文档整体结构:对照对应文档设计说明章节划分、内容归属与展开顺序,提出需要合并、拆分或重排的内容
|
|
114
|
+
- 导读 Chapter 或 Section:对照对应文档设计的表达要求与 `~/.claude/skills/aca/doc-design/patterns/` 的适用场景,向开发者说明当前表达方式是否适合该内容,不默认沿用已有代码、表格或图
|
|
115
|
+
- 现有表达方式不合适:先向开发者提出替换、拆分或组合后的表达方式并读取所选 pattern,不顺着原有表达局部修补
|
|
116
|
+
3. **逐项核对检查条件**
|
|
117
|
+
- 逐项核对文档组、文档设计与所选 pattern 中适用于当前单元的检查条件
|
|
117
118
|
|
|
118
119
|
| 检查项 | 关注内容 |
|
|
119
120
|
| --- | --- |
|
|
@@ -121,14 +122,14 @@ flowchart TD
|
|
|
121
122
|
| 完整性 | 职责、行为、边界与异常处理的遗漏 |
|
|
122
123
|
| 歧义与实现唯一性 | 多种合理解读、符合描述但行为不同的实现、尚未明确的设计决定 |
|
|
123
124
|
| 冗余 | 重复维护、不增加信息的内容 |
|
|
124
|
-
| 表达 |
|
|
125
|
+
| 表达 | 表达方式选择与适配性、行文公理、对应文档设计与术语一致性 |
|
|
125
126
|
|
|
126
127
|
### 4.3 确认、修订与检查
|
|
127
128
|
|
|
128
|
-
1.
|
|
129
|
+
1. 请开发者确认当前单元的设计决定与表达方式调整
|
|
129
130
|
开发者不理解或有异议时,澄清含义与依据
|
|
130
131
|
尚未确认时,按[讨论与核对](#42-讨论与核对)继续讨论当前单元
|
|
131
|
-
2.
|
|
132
|
+
2. 存在已确认的调整时,按对应文档设计与所选 pattern 当场修订
|
|
132
133
|
涉及章节调整时,同步更新受影响的引用与关联设计
|
|
133
134
|
3. 修订后,重新执行受影响的检查条件与机械检查
|
|
134
135
|
报告修正内容与检查结果
|
|
@@ -197,4 +198,5 @@ flowchart TD
|
|
|
197
198
|
| --- | --- | --- |
|
|
198
199
|
| 未完成 | 尚有未导读单元或缺少核验条件 | 补齐条件后,通过 `/aca-walkthrough` 继续本次导读 |
|
|
199
200
|
| 未完成 | 设计方案在本轮无法确定 | `/aca-specify` 论证方案 |
|
|
200
|
-
| 完成 |
|
|
201
|
+
| 完成 | 当前范围导读完成,且本轮设计涉及跨模块范围 | 通过 `/aca-review` 审查设计 |
|
|
202
|
+
| 完成 | 当前范围导读完成,且本轮设计不涉及跨模块范围 | 直接进入后续流程(需要实施代码时进入 `/aca-implement`,仅改设计文档时衔接 `/aca-release`) |
|