@haaaiawd/anws 2.2.0 → 2.2.2
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 +180 -343
- package/bin/cli.js +112 -112
- package/lib/changelog.js +258 -258
- package/lib/copy.js +116 -109
- package/lib/diff.js +11 -0
- package/lib/manifest.js +4 -1
- package/lib/update.js +319 -319
- package/package.json +4 -3
- package/templates/.agents/skills/anws-system/SKILL.md +9 -7
- package/templates/.agents/skills/code-reviewer/SKILL.md +102 -327
- package/templates/.agents/skills/concept-modeler/SKILL.md +19 -17
- package/templates/.agents/skills/craft-authoring/SKILL.md +123 -0
- package/templates/.agents/skills/e2e-testing-guide/SKILL.md +59 -0
- package/templates/.agents/skills/system-designer/SKILL.md +6 -6
- package/templates/.agents/skills/system-designer/references/system-design-template.md +17 -17
- package/templates/.agents/skills/task-planner/SKILL.md +113 -113
- package/templates/.agents/skills/task-planner/references/TASK_TEMPLATE.md +82 -82
- package/templates/.agents/workflows/blueprint.md +284 -284
- package/templates/.agents/workflows/challenge.md +450 -491
- package/templates/.agents/workflows/change.md +263 -286
- package/templates/.agents/workflows/craft.md +243 -664
- package/templates/.agents/workflows/design-system.md +624 -624
- package/templates/.agents/workflows/explore.md +400 -371
- package/templates/.agents/workflows/forge.md +444 -413
- package/templates/.agents/workflows/genesis.md +342 -395
- package/templates/.agents/workflows/probe.md +21 -16
- package/templates/.agents/workflows/quickstart.md +123 -138
- package/templates/AGENTS.md +149 -134
|
@@ -1,364 +1,332 @@
|
|
|
1
|
-
---
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
# /challenge
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
- **业务契约**: `01_PRD.md` 中的业务目标、主流程、约束、验收语义
|
|
17
|
-
- **架构契约**: `02_ARCHITECTURE_OVERVIEW.md`、`03_ADR/`、`04_SYSTEM_DESIGN/` 中的系统边界、接口、状态与技术决策
|
|
18
|
-
- **任务契约**: `05_TASKS.md` 对实现承接、覆盖范围、验证方式作出的承诺
|
|
19
|
-
- **文档契约**: README / 使用说明 / 验证路径对评审者和实施者作出的操作承诺(如在当前审查范围内可获得)
|
|
20
|
-
- **运行契约**: 错误语义、审计边界、日志边界、幂等、重试、超时、降级、调度与长期运行承诺
|
|
21
|
-
|
|
22
|
-
**核心原则**:
|
|
23
|
-
|
|
24
|
-
-
|
|
25
|
-
-
|
|
26
|
-
-
|
|
27
|
-
-
|
|
28
|
-
-
|
|
29
|
-
-
|
|
30
|
-
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
>
|
|
46
|
-
>
|
|
47
|
-
>
|
|
48
|
-
>
|
|
49
|
-
>
|
|
50
|
-
>
|
|
51
|
-
>
|
|
52
|
-
> -
|
|
53
|
-
>
|
|
54
|
-
>
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
>
|
|
65
|
-
>
|
|
66
|
-
>
|
|
67
|
-
>
|
|
68
|
-
> 3
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
-
|
|
145
|
-
-
|
|
146
|
-
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
-
|
|
150
|
-
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
-
|
|
154
|
-
-
|
|
155
|
-
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
|
162
|
-
|
|
163
|
-
|
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
>
|
|
175
|
-
>
|
|
176
|
-
>
|
|
177
|
-
> -
|
|
178
|
-
>
|
|
179
|
-
> -
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
-
|
|
189
|
-
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
4.
|
|
200
|
-
|
|
201
|
-
| 失败原因 | 失真契约 | Root Cause | 证据 | 概率 |
|
|
202
|
-
|---------|---------|-----------|------|:----:|
|
|
203
|
-
| 重复发货 | 写操作承诺 | 无幂等键 / 无去重状态 | PRD + API 设计未定义重试语义 | 🔴高 |
|
|
204
|
-
| 错误响应分叉 | 错误契约 | 默认失败路径未统一包装 | 401/404 由框架默认返回 | 🟡中 |
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
---
|
|
208
|
-
|
|
209
|
-
## Step 2.5: 审查模式判定 (Review Mode Detection)
|
|
210
|
-
|
|
211
|
-
**目标**: 在开始任何审查之前,先确定**本次应该审查什么**——避免无脑双跑。
|
|
212
|
-
|
|
213
|
-
根据上下文信号推断模式:
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
|
218
|
-
|
|
|
219
|
-
|
|
|
220
|
-
|
|
|
221
|
-
|
|
|
222
|
-
|
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
1
|
+
---
|
|
2
|
+
|
|
3
|
+
## description: "对项目的设计、任务与实现进行系统性挑战,用证据证明风险真实存在。适用于设计完成后的质量把关、编码前的决策复核,以及实现后的静态忠实度审查。产出 07_CHALLENGE_REPORT.md。"
|
|
4
|
+
|
|
5
|
+
# /challenge
|
|
6
|
+
|
|
7
|
+
你是项目的 **CHALLENGER (质疑者)**。
|
|
8
|
+
|
|
9
|
+
**你的核心使命**:
|
|
10
|
+
系统性地挑战项目的每一个决策和假设,**用证据证明问题真实存在**,而非空想问题。
|
|
11
|
+
|
|
12
|
+
**你审查的主对象不是文档本身,而是系统是否忠于其规范契约。**
|
|
13
|
+
|
|
14
|
+
**规范契约** 由以下来源共同组成:
|
|
15
|
+
|
|
16
|
+
- **业务契约**: `01_PRD.md` 中的业务目标、主流程、约束、验收语义
|
|
17
|
+
- **架构契约**: `02_ARCHITECTURE_OVERVIEW.md`、`03_ADR/`、`04_SYSTEM_DESIGN/` 中的系统边界、接口、状态与技术决策
|
|
18
|
+
- **任务契约**: `05_TASKS.md` 对实现承接、覆盖范围、验证方式作出的承诺
|
|
19
|
+
- **文档契约**: README / 使用说明 / 验证路径对评审者和实施者作出的操作承诺(如在当前审查范围内可获得)
|
|
20
|
+
- **运行契约**: 错误语义、审计边界、日志边界、幂等、重试、超时、降级、调度与长期运行承诺
|
|
21
|
+
|
|
22
|
+
**核心原则**:
|
|
23
|
+
|
|
24
|
+
- **规范契约优先**: 先识别系统承诺了什么,再判断这些承诺是否闭合,最后再用工程证据坐实
|
|
25
|
+
- **三维度审查**: 系统设计(架构完整性)、运行模拟(时序正确性)、工程实现(可测试性)
|
|
26
|
+
- **承诺闭合优先于形式完整**: 比起“看起来像个完整项目”,更优先发现“系统最不能撒谎的地方是否失真”
|
|
27
|
+
- **高信号输出**: 聚焦真正影响判断的根因问题,避免把报告写成低价值 checklist
|
|
28
|
+
- **有证据才算问题**: 每个质疑必须有具体理由或调研支撑
|
|
29
|
+
- **问题分级**: Critical / High / Medium / Low 四级严重度
|
|
30
|
+
- **宁缺毋滥**: 10 个虚假问题不如 3 个真实问题
|
|
31
|
+
- **可验证**: 每个问题都要说明如何验证
|
|
32
|
+
|
|
33
|
+
**审查方法论**:
|
|
34
|
+
|
|
35
|
+
1. **系统设计维度** - 架构完整性、边界清晰度、一致性
|
|
36
|
+
2. **运行模拟维度** - 时序正确性、状态同步、边界条件
|
|
37
|
+
3. **工程实现维度** - 可测试性、可维护性、性能、安全
|
|
38
|
+
|
|
39
|
+
**Output Goal**: `.anws/v{N}/07_CHALLENGE_REPORT.md`
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## ⚠️ CRITICAL 深度思考要求
|
|
44
|
+
|
|
45
|
+
> [!IMPORTANT]
|
|
46
|
+
> **质疑需要深度思考,思考方式基于模型能力和任务复杂度。**
|
|
47
|
+
>
|
|
48
|
+
> **核心判断规则**:
|
|
49
|
+
>
|
|
50
|
+
> - **无 CoT 模型** → **必须调用** `sequential-thinking` CLI
|
|
51
|
+
> - **有 CoT 模型 + 简单质疑**(问题明确、步骤 < 5)→ 用思考引导问题组织自然 CoT
|
|
52
|
+
> - **有 CoT 模型 + 复杂质疑**(需要多方案比较、修正前提)→ 调用 `sequential-thinking` CLI
|
|
53
|
+
>
|
|
54
|
+
> 质疑不是"扫一眼文档然后列问题"。质疑需要**深度思考**:
|
|
55
|
+
>
|
|
56
|
+
> - 你需要理解设计者的意图,才能找到他们遗漏的部分
|
|
57
|
+
> - 你需要推演因果链,才能证明问题真实存在
|
|
58
|
+
> - 你需要模拟系统运行,才能发现隐藏的故障模式
|
|
59
|
+
|
|
60
|
+
---
|
|
61
|
+
|
|
62
|
+
## ⚠️ CRITICAL 质量要求
|
|
63
|
+
|
|
64
|
+
> [!IMPORTANT]
|
|
65
|
+
> **禁止空想问题!**
|
|
66
|
+
>
|
|
67
|
+
> - ❌ "可能会有性能问题" → 没有证据
|
|
68
|
+
> - ✅ "根据 RFC 设计,每次请求需要 3 次数据库查询,在 1000 并发下可能成为瓶颈" → 有具体分析
|
|
69
|
+
>
|
|
70
|
+
> 每个质疑**必须**包含:
|
|
71
|
+
>
|
|
72
|
+
> 1. **具体指向**: 指出问题在哪个文件/设计的哪个部分
|
|
73
|
+
> 2. **证据来源**: 代码分析 / 调研结果 / 历史经验
|
|
74
|
+
> 3. **影响评估**: 如果问题成真,后果是什么
|
|
75
|
+
|
|
76
|
+
---
|
|
77
|
+
|
|
78
|
+
## 🎚️ 严重度分级
|
|
79
|
+
|
|
80
|
+
|
|
81
|
+
| 等级 | 判定标准 | 所需行动 |
|
|
82
|
+
| --------------- | -------------------- | ----------------------------- |
|
|
83
|
+
| **Critical** 🔴 | 根本性矛盾或不可能实现。不解决无法继续。 | P0 — 必须在 blueprint/forge 之前修复 |
|
|
84
|
+
| **High** 🟠 | 大概率导致返工或失败的严重风险。 | P1 — 在 forge 之前修复 |
|
|
85
|
+
| **Medium** 🟡 | 有变通方案的质量隐患。 | P2 — 实现阶段修复 |
|
|
86
|
+
| **Low** 🟢 | 润色项或轻微不一致。 | P3 — 后续跟踪 |
|
|
87
|
+
|
|
88
|
+
|
|
89
|
+
> [!NOTE]
|
|
90
|
+
> 报告输出时,**优先保留 Critical / High**。Medium / Low 只在确实影响判断或能形成稳定改进方向时保留,避免报告膨胀。
|
|
91
|
+
|
|
92
|
+
---
|
|
93
|
+
|
|
94
|
+
## Step 0: 定位架构版本 (Locate Architecture)
|
|
95
|
+
|
|
96
|
+
**目标**: 找到当前活动的架构版本。
|
|
97
|
+
|
|
98
|
+
1. **扫描版本**: `list_dir .anws/`
|
|
99
|
+
2. **确定最新版本**: 找到数字最大的文件夹 `v{N}`(例如 `v3`)。
|
|
100
|
+
3. **TARGET_DIR** = `.anws/v{N}`。
|
|
101
|
+
|
|
102
|
+
---
|
|
103
|
+
|
|
104
|
+
## Step 1: 建立上下文 (Context Loading)
|
|
105
|
+
|
|
106
|
+
**目标**: 深度理解项目设计。
|
|
107
|
+
|
|
108
|
+
1. **准备环境**:
|
|
109
|
+
无需额外创建目录,报告将保存至 `{TARGET_DIR}`。
|
|
110
|
+
2. **深度阅读设计文档**:
|
|
111
|
+
- 读取 `{TARGET_DIR}/01_PRD.md`
|
|
112
|
+
- 读取 `{TARGET_DIR}/02_ARCHITECTURE_OVERVIEW.md`
|
|
113
|
+
- 读取 `{TARGET_DIR}/03_ADR/`
|
|
114
|
+
- 读取 `{TARGET_DIR}/04_SYSTEM_DESIGN/`(如存在)
|
|
115
|
+
- 读取 `{TARGET_DIR}/05_TASKS.md`(如存在)
|
|
116
|
+
3. **强制深度理解** :
|
|
117
|
+
> [!IMPORTANT]
|
|
118
|
+
> 复杂项目可以循环多次。
|
|
119
|
+
>
|
|
120
|
+
> **为什么?** 因为你不能"扫一眼就质疑"。你需要先理解:
|
|
121
|
+
>
|
|
122
|
+
> - 设计者为什么这样设计?
|
|
123
|
+
> - 他们考虑了什么?没考虑什么?
|
|
124
|
+
> - 系统的核心约束是什么?
|
|
125
|
+
> 思考引导:
|
|
126
|
+
1. "项目的核心目标是什么?用户最需要什么?"
|
|
127
|
+
2. "关键技术决策有哪些?为什么选这个?"
|
|
128
|
+
3. "最复杂的部分在哪里?复杂性来自哪里?"
|
|
129
|
+
4. "哪些部分设计得很详细?哪些很粗略?"
|
|
130
|
+
5. "如果我是实现者,我会在哪里卡住?"
|
|
131
|
+
|
|
132
|
+
---
|
|
133
|
+
|
|
134
|
+
## Step 1.5: 规范来源识别与承诺模型 (Contract Modeling)
|
|
135
|
+
|
|
136
|
+
**目标**: 在任何详细审查之前,先明确**系统到底承诺了什么**。
|
|
137
|
+
|
|
138
|
+
> [!IMPORTANT]
|
|
139
|
+
> 不要一上来就扫问题。先抽取**规范来源集合**与**承诺模型**。
|
|
140
|
+
> 这是本工作流的第一性动作。
|
|
141
|
+
|
|
142
|
+
1. **识别规范来源**:
|
|
143
|
+
- `01_PRD.md` → 业务契约
|
|
144
|
+
- `02_ARCHITECTURE_OVERVIEW.md` + `03_ADR/` + `04_SYSTEM_DESIGN/` → 架构契约
|
|
145
|
+
- `05_TASKS.md` → 任务契约
|
|
146
|
+
- 当前审查范围内可读到的 README / 验证说明 / 配置说明 → 文档契约
|
|
147
|
+
2. **构建最小语义模型**(内部使用,不必原样照抄到最终报告):
|
|
148
|
+
- **规范来源清单**: 每类契约来自哪些文件
|
|
149
|
+
- **承诺清单**: 每条关键承诺的来源、对象、失败后果
|
|
150
|
+
- **任务承接映射**: 若 `05_TASKS.md` 存在,记录哪些承诺已被任务覆盖,哪些没有
|
|
151
|
+
3. **至少抽取以下承诺类型**:
|
|
152
|
+
- **结果承诺**: 系统最终要达成什么业务结果
|
|
153
|
+
- **状态承诺**: 状态机、资源生命周期、越序约束是否明确
|
|
154
|
+
- **时间承诺**: 时间窗口、TTL、过期、调度、保留期
|
|
155
|
+
- **错误承诺**: 错误码、错误结构、默认失败路径是否一致
|
|
156
|
+
- **安全承诺**: 鉴权、授权、数据隔离、敏感信息边界
|
|
157
|
+
- **审计承诺**: 哪些操作应留痕、留痕粒度、问责边界
|
|
158
|
+
- **运行承诺**: 幂等、重试、超时、降级、可观测性
|
|
159
|
+
4. **输出一个简明承诺模型摘要**:
|
|
160
|
+
```markdown
|
|
161
|
+
| 承诺类型 | 承诺摘要 | 契约来源 | 失真风险 |
|
|
162
|
+
|---------|---------|---------|---------|
|
|
163
|
+
| 错误承诺 | 所有 API 失败路径返回统一错误结构 | PRD §X / ADR-00Y | 客户端分叉处理 |
|
|
164
|
+
| 审计承诺 | 所有关键业务读写操作需留痕 | PRD §Y / System Design §Z | 无法问责 / 排障 |
|
|
165
|
+
| 运行承诺 | 写操作可安全重试且不重复副作用 | PRD §A / Architecture §B | 重复扣款/发货 |
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
---
|
|
169
|
+
|
|
170
|
+
## Step 2: Pre-Mortem (预演失败)
|
|
171
|
+
|
|
172
|
+
**目标**: 从未来回看,分析可能的失败原因——**但必须有逻辑依据**。
|
|
173
|
+
|
|
174
|
+
> [!IMPORTANT]
|
|
175
|
+
> 你**必须**使用 `sequential-thinking` skill 组织 **3-5 个 thought**进行深度思考。
|
|
176
|
+
>
|
|
177
|
+
> **为什么?** Pre-Mortem 的本质是**模拟推演**。你需要:
|
|
178
|
+
>
|
|
179
|
+
> - 在脑中"运行"这个项目
|
|
180
|
+
> - 想象每个阶段可能出什么问题
|
|
181
|
+
> - 追溯每个问题的 Root Cause
|
|
182
|
+
> - 应用三维度审查框架(系统设计、运行模拟、工程实现)
|
|
183
|
+
|
|
184
|
+
1. **设定场景**:
|
|
185
|
+
> 6 个月后,项目失败了。为什么?
|
|
186
|
+
2. **优先追问以下失真类型**:
|
|
187
|
+
- **写操作副作用失真**: 重试后是否可能重复产生副作用?
|
|
188
|
+
- **状态/时间口径失真**: 状态转换、时间字段、窗口计算是否偏离契约?
|
|
189
|
+
- **失败语义失真**: 默认 401/404/校验失败路径是否仍符合统一承诺?
|
|
190
|
+
- **审计/观测失真**: 留痕边界是否缩水?日志是否引入新的泄露面?
|
|
191
|
+
- **任务承接失真**: 关键承诺是否根本没有落入实现任务?
|
|
192
|
+
3. **思考引导** (每个失败原因都要回答):
|
|
193
|
+
1. "这个失败原因的 Root Cause 是什么?"
|
|
194
|
+
2. "它违背了哪条规范契约?"
|
|
195
|
+
3. "有什么证据表明这会发生?"
|
|
196
|
+
4. "发生概率有多高?(高/中/低)"
|
|
197
|
+
5. "如果发生了,影响有多大?"
|
|
198
|
+
6. "有没有已知的类似失败案例?"
|
|
199
|
+
4. **输出格式**:
|
|
200
|
+
```markdown
|
|
201
|
+
| 失败原因 | 失真契约 | Root Cause | 证据 | 概率 |
|
|
202
|
+
|---------|---------|-----------|------|:----:|
|
|
203
|
+
| 重复发货 | 写操作承诺 | 无幂等键 / 无去重状态 | PRD + API 设计未定义重试语义 | 🔴高 |
|
|
204
|
+
| 错误响应分叉 | 错误契约 | 默认失败路径未统一包装 | 401/404 由框架默认返回 | 🟡中 |
|
|
205
|
+
```
|
|
206
|
+
|
|
207
|
+
---
|
|
208
|
+
|
|
209
|
+
## Step 2.5: 审查模式判定 (Review Mode Detection)
|
|
210
|
+
|
|
211
|
+
**目标**: 在开始任何审查之前,先确定**本次应该审查什么**——避免无脑双跑。
|
|
212
|
+
|
|
213
|
+
根据上下文信号推断模式:
|
|
214
|
+
|
|
215
|
+
|
|
216
|
+
| 信号 | 推断模式 |
|
|
217
|
+
| -------------------------- | ----------------------------- |
|
|
218
|
+
| `05_TASKS.md` 不存在 | `DESIGN` — 只能审查设计 |
|
|
219
|
+
| 用户明确提到任务/任务清单有问题 | `TASKS` |
|
|
220
|
+
| 用户明确提到实现代码 / 交付验收 / 静态代码质检 | `CODE` |
|
|
221
|
+
| 用户明确说「全面审查」或「都看看」 | `FULL` |
|
|
222
|
+
| `05_TASKS.md` 存在,但用户无明确指向 | `DESIGN`,任务审查与代码审查**按需自适应升级** |
|
|
223
|
+
| 本轮是修复后的复查,上轮有任务类问题 | `FULL` |
|
|
224
|
+
|
|
225
|
+
|
|
226
|
+
**如果模式仍不明确,直接询问用户**:
|
|
227
|
+
|
|
226
228
|
> 本次审查侧重什么?
|
|
229
|
+
>
|
|
227
230
|
> 1. **设计/架构**(design-reviewer)— 架构完整性、接口、运行时行为
|
|
228
231
|
> 2. **任务清单**(task-reviewer)— 任务质量、REQ 覆盖、US 完整性
|
|
229
232
|
> 3. **实现代码**(code-reviewer)— 契约忠实度、测试漂移、回流遗漏
|
|
230
233
|
> 4. **全面审查**(全都跑)
|
|
231
234
|
|
|
232
235
|
**设置** `REVIEW_MODE` = `DESIGN` / `TASKS` / `CODE` / `FULL`,后续步骤依据此值触发。
|
|
233
|
-
|
|
234
|
-
---
|
|
235
|
-
|
|
236
|
-
## Step 3: 设计审查 (Design Review)
|
|
237
|
-
|
|
238
|
-
**触发条件**: `REVIEW_MODE` = `DESIGN` 或 `FULL`
|
|
239
|
-
|
|
240
|
-
> 如果 `REVIEW_MODE` = `TASKS`,**跳过本步骤**,直接进入 Step 3.5。
|
|
241
|
-
|
|
242
|
-
调用 `design-reviewer` skill:
|
|
243
|
-
- 输入: `{TARGET_DIR}` 下的 `01_PRD.md`, `02_ARCHITECTURE_OVERVIEW.md`, `03_ADR/`, `04_SYSTEM_DESIGN/`
|
|
244
|
-
- 输出: 设计审查发现清单(含严重度分级 + 文档关联)
|
|
245
|
-
|
|
246
|
-
**使用方式要求**:
|
|
247
|
-
- 将 `design-reviewer` 视为**规范契约的设计证据层**,不是最终结论本身
|
|
248
|
-
- 优先要求其证明:哪些契约在系统边界、接口、状态、时序、错误路径上没有闭合
|
|
249
|
-
|
|
250
|
-
**收集发现**,暂存待 Step 5 合并。
|
|
251
|
-
|
|
252
|
-
---
|
|
253
|
-
|
|
254
|
-
## Step 3.5: 任务审查 (Task Review)
|
|
255
|
-
|
|
256
|
-
**触发条件**(满足任一即执行,`05_TASKS.md` 必须存在):
|
|
257
|
-
|
|
258
|
-
1. `REVIEW_MODE` = `TASKS` 或 `FULL`
|
|
259
|
-
2. **自适应升级**:`REVIEW_MODE` = `DESIGN`,且 design-reviewer 的发现满足以下任一条件:
|
|
260
|
-
- 存在「架构组件在任务中无覆盖」类问题(对应 task-reviewer Pass D2)
|
|
261
|
-
- Critical/High 级设计问题超过 3 条,需确认是否已有任务跟进
|
|
262
|
-
|
|
263
|
-
**自适应升级时,询问用户**:
|
|
264
|
-
|
|
265
|
-
> 设计审查发现 {N} 个问题可能涉及任务覆盖不足,是否追加任务审查?
|
|
266
|
-
> 1. 是,追加 task-reviewer
|
|
267
|
-
> 2. 否,继续
|
|
268
|
-
|
|
269
|
-
如触发,调用 `task-reviewer` skill:
|
|
270
|
-
- 输入: `{TARGET_DIR}` 下的 `05_TASKS.md`, `01_PRD.md`, `02_ARCHITECTURE_OVERVIEW.md`, `03_ADR/`, `04_SYSTEM_DESIGN/`
|
|
271
|
-
- 输出: 任务审查报告(含契约覆盖、基础单测承接、REQ 覆盖率、US 完整性 + 问题清单)
|
|
272
|
-
|
|
273
|
-
**使用方式要求**:
|
|
274
|
-
- 将 `task-reviewer` 视为**规范契约在任务层的承接证据**
|
|
275
|
-
- 优先确认:关键承诺是否有实现任务、验证任务、边界/失败路径任务,以及是否存在幽灵任务稀释主轴
|
|
276
|
-
- 额外确认:公共契约是否被任务和验证接住,基础层低依赖逻辑是否被单元测试充分承接,而不是只靠高层集成测试兜底
|
|
277
236
|
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
237
|
+
---
|
|
238
|
+
|
|
239
|
+
## Step 3: 设计审查 (Design Review)
|
|
240
|
+
|
|
241
|
+
**触发条件**: `REVIEW_MODE` = `DESIGN` 或 `FULL`
|
|
242
|
+
|
|
243
|
+
> 若 `REVIEW_MODE` = `TASKS`,**跳过本步骤**,直接进入 Step 3.5。
|
|
244
|
+
|
|
245
|
+
完整遵从 `**design-reviewer`** skill(输入范围、Pass、输出结构均以 skill 为准)。
|
|
246
|
+
|
|
247
|
+
**收集发现**,暂存 Step 5。
|
|
283
248
|
|
|
284
249
|
---
|
|
285
250
|
|
|
286
|
-
## Step 3.
|
|
251
|
+
## Step 3.5: 任务审查 (Task Review)
|
|
252
|
+
|
|
253
|
+
**触发条件**(满足任一即执行,`05_TASKS.md` 必须存在):
|
|
254
|
+
|
|
255
|
+
1. `REVIEW_MODE` = `TASKS` 或 `FULL`
|
|
256
|
+
2. **自适应升级**:`REVIEW_MODE` = `DESIGN`,且 design-reviewer 发现指向任务覆盖不足(见 skill 与上轮输出)。
|
|
257
|
+
|
|
258
|
+
升级前询问用户是否追加 task-reviewer(是 / 否)。
|
|
259
|
+
|
|
260
|
+
如触发,完整遵从 `**task-reviewer`** skill(含 `04_SYSTEM_DESIGN/` 必读规则,详见 skill)。
|
|
261
|
+
|
|
262
|
+
**收集发现**,暂存 Step 5。跳过则 `Task review skipped` + 原因。
|
|
263
|
+
|
|
264
|
+
---
|
|
287
265
|
|
|
288
|
-
|
|
266
|
+
## Step 3.7: 代码审查 (Code Review)
|
|
289
267
|
|
|
290
|
-
|
|
291
|
-
2. **自适应升级**:`REVIEW_MODE` = `DESIGN` 或 `TASKS`,且发现满足以下任一条件:
|
|
292
|
-
- 契约已定义、任务已承接,但需要确认实现是否忠于这些承诺
|
|
293
|
-
- 存在“测试可能只是表面覆盖”的高风险信号
|
|
294
|
-
- 存在“代码里可能出现未回流的新公共契约”的高风险信号
|
|
268
|
+
**触发**:同上 `REVIEW_MODE` / 自适应规则;`src/` 须存在。
|
|
295
269
|
|
|
296
|
-
|
|
297
|
-
- 输入: 当前工作目录下的 `src/`, `{TARGET_DIR}/01_PRD.md`, `{TARGET_DIR}/02_ARCHITECTURE_OVERVIEW.md`, `{TARGET_DIR}/03_ADR/`, `{TARGET_DIR}/04_SYSTEM_DESIGN/`, `{TARGET_DIR}/05_TASKS.md`, 如存在再加 `{TARGET_DIR}/07_CHALLENGE_REPORT.md`
|
|
298
|
-
- 输出: 代码审查报告(Contract Drift / Task Drift / Test Drift / Missing Change Backflow / Foundational Test Gaps + 安全与测试摘要)
|
|
270
|
+
完整遵从 `**code-reviewer`** skill(静态边界、输入、Lens、输出结构、跳过协议一概以 skill 为准——本节不重复)。
|
|
299
271
|
|
|
300
|
-
|
|
301
|
-
- 将 `code-reviewer` 视为**实现侧证据层**,不是泛化风格审查器
|
|
302
|
-
- 优先确认:实现是否忠于既有契约与任务承诺,而不是先盯代码美观度
|
|
303
|
-
- 它必须是**纯静态审查**:不启动项目、不跑测试、不修改代码
|
|
272
|
+
**执行方式**:宿主支持子代理时 **优先**委派子代理执行 `code-reviewer`;否则由当前会话执行(协议相同)。
|
|
304
273
|
|
|
305
|
-
|
|
274
|
+
**收集发现** 待 Step 5 合并;跳过则 `Code review skipped` + 一行原因。
|
|
306
275
|
|
|
307
276
|
---
|
|
308
277
|
|
|
309
278
|
## Step 4: 承诺闭合验证与假设证伪 (Closure Validation)
|
|
310
|
-
|
|
311
|
-
**目标**: 识别隐含假设,并验证关键承诺在边界条件下是否**真正闭合**。
|
|
312
|
-
|
|
313
|
-
> **为什么?** 隐含假设是最危险的,因为它们通常不会被记录和验证。
|
|
314
|
-
|
|
315
|
-
1.
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
2.
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
3.
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
4.
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
|
|
|
357
|
-
|
|
|
358
|
-
|
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
279
|
+
|
|
280
|
+
**目标**: 识别隐含假设,并验证关键承诺在边界条件下是否**真正闭合**。
|
|
281
|
+
|
|
282
|
+
> **为什么?** 隐含假设是最危险的,因为它们通常不会被记录和验证。
|
|
283
|
+
|
|
284
|
+
1. **承诺闭合检查清单**:
|
|
285
|
+
|
|
286
|
+
| 检查维度 | 核心问题 | 契约位置 |
|
|
287
|
+
| ------- | --------------------------- | ---- |
|
|
288
|
+
| **重复态** | 同一请求再来一次,是否仍忠于原承诺? | |
|
|
289
|
+
| **失败态** | 超时、部分失败、外部依赖失败时,承诺是否仍成立? | |
|
|
290
|
+
| **默认态** | 框架默认错误路径 / 默认资源路径是否与系统契约一致? | |
|
|
291
|
+
| **运行态** | 调度、清理、保留期、长期运行行为是否有闭环? | |
|
|
292
|
+
| **并发态** | 多用户/并发冲突时,状态与副作用是否可控? | |
|
|
293
|
+
| **观测态** | 是否留有足够日志/审计证据,同时不扩大泄露面? | |
|
|
294
|
+
|
|
295
|
+
2. **技术与运行健壮性检查**:
|
|
296
|
+
|
|
297
|
+
| 检查项 | 问题 | 契约位置 |
|
|
298
|
+
| ------------- | ------------------------------- | ---- |
|
|
299
|
+
| **事务处理** | 关键写操作是否有原子性保障?中间失败能回滚吗? | |
|
|
300
|
+
| **重试机制** | 外部服务调用失败时怎么办?是否会扩大副作用? | |
|
|
301
|
+
| **降级策略** | 主服务不可用时有 Fallback 吗? | |
|
|
302
|
+
| **超时处理** | 慢操作有超时限制吗? | |
|
|
303
|
+
| **接口定义** | 所有关键 API 都有完整输入/输出/错误 Schema 吗? | |
|
|
304
|
+
| **配置管理** | 秘钥/配置如何管理?硬编码了吗? | |
|
|
305
|
+
| **日志监控** | 关键操作有日志吗?日志是否越界记录敏感信息? | |
|
|
306
|
+
| **版本控制** | 数据格式/升级如何处理? | |
|
|
307
|
+
| **Prompt 模板** | LLM 的 Prompt 有完整定义吗? | |
|
|
308
|
+
| **工具定义** | LLM Tool Use 有 JSON Schema 吗? | |
|
|
309
|
+
|
|
310
|
+
3. **契约与验证责任闭合检查**:
|
|
311
|
+
|
|
312
|
+
| 检查项 | 问题 | 契约位置 |
|
|
313
|
+
| -------- | ------------------------- | ---- |
|
|
314
|
+
| **契约承接** | 所有公共契约是否都有实现任务承接? | |
|
|
315
|
+
| **验证承接** | 所有高风险公共契约是否都有至少一层明确验证承接? | |
|
|
316
|
+
| **基础单测** | 基础层、共享层、纯逻辑层是否默认获得单元测试承接? | |
|
|
317
|
+
| **错误路径** | 契约的失败态、边界态是否有对应测试责任? | |
|
|
318
|
+
| **回归责任** | 影响既有关键能力的变更是否有最小回归验证? | |
|
|
319
|
+
|
|
320
|
+
4. **记录验证结果**(内部分析可详细,最终报告只保留高信号摘要):
|
|
321
|
+
```markdown
|
|
322
|
+
| 项目 | 结论 | 证据 | 对应问题 |
|
|
323
|
+
|------|------|------|----------|
|
|
324
|
+
| 重复态 | Pass / Partial / Fail | ... | CH-01 |
|
|
325
|
+
| 失败态 | Pass / Partial / Fail | ... | CH-02 |
|
|
326
|
+
| 默认态 | Pass / Partial / Fail | ... | CH-03 |
|
|
327
|
+
| 运行态 | Pass / Partial / Fail | ... | CH-04 |
|
|
328
|
+
```
|
|
329
|
+
|
|
362
330
|
---
|
|
363
331
|
|
|
364
332
|
## Step 4.5: 审查门禁 (Review Gate)
|
|
@@ -369,57 +337,58 @@ description: "对项目的设计、任务与实现进行系统性挑战,用证
|
|
|
369
337
|
> **如果最新 `07_CHALLENGE_REPORT.md` 中存在未处理的 Critical 问题,不得直接进入 `/forge`。**
|
|
370
338
|
>
|
|
371
339
|
> 处理方式:
|
|
340
|
+
>
|
|
372
341
|
> - 通过 `/change` 消化当前版本内可收敛的问题
|
|
373
342
|
> - 或通过 `/genesis` / `/design-system` 重开设计前提
|
|
374
343
|
>
|
|
375
344
|
> 如仅存在 High 问题,可由用户显式签名决定是否继续;AUTO 模式不得自动穿过这一关。
|
|
376
|
-
|
|
377
|
-
## Step 5: 生成质疑报告 (Challenge Report)
|
|
378
|
-
|
|
379
|
-
**目标**: 输出结构化报告,每个问题都有证据支撑,并采用**问题发现优先**的紧凑结构。
|
|
380
|
-
|
|
381
|
-
保存报告到 `{TARGET_DIR}/07_CHALLENGE_REPORT.md`
|
|
382
|
-
|
|
383
|
-
**报告模板**:
|
|
384
|
-
|
|
385
|
-
```markdown
|
|
386
|
-
# [项目名称] 质疑报告 (Challenge Report)
|
|
387
|
-
|
|
388
|
-
> **审查日期**: {YYYY-MM-DD}
|
|
389
|
-
> **审查范围**: {TARGET_DIR} 全部设计文档
|
|
390
|
-
> **累计轮次**: {N}
|
|
391
|
-
|
|
392
|
-
---
|
|
393
|
-
|
|
394
|
-
## 📋 问题总览
|
|
395
|
-
|
|
396
|
-
> 已解决轮次仅保留摘要。当前活跃轮只保留影响判断的高信号问题。
|
|
397
|
-
|
|
398
|
-
### 第{N}轮(当前活跃)
|
|
399
|
-
|
|
400
|
-
| 严重度 | 数量 | 摘要 | 状态 |
|
|
401
|
-
|--------|------|------|------|
|
|
402
|
-
| Critical | X | [本轮 Critical 问题的合并摘要] | ⏳ 待处理 |
|
|
403
|
-
| High | X | [本轮 High 问题的合并摘要] | ⏳ 待处理 |
|
|
404
|
-
| Medium | X | [本轮 Medium 问题的合并摘要] | ⏳ 待处理 |
|
|
405
|
-
| Low | X | [本轮 Low 问题的合并摘要或省略说明] | ⏳ 待处理 |
|
|
406
|
-
|
|
407
|
-
---
|
|
408
|
-
|
|
409
|
-
## 📊 审查摘要
|
|
410
|
-
|
|
411
|
-
**审查模式**: `{REVIEW_MODE}`
|
|
412
|
-
**整体判断**: 🟢 可继续 / 🟡 需先修复高优先问题 / 🔴 暂不建议继续
|
|
413
|
-
**高信号结论**: [用 2-4 句总结最值得关心的问题,不展开方法过程]
|
|
414
|
-
|
|
415
|
-
| 指标 | 数值 |
|
|
416
|
-
|------|------|
|
|
417
|
-
| Critical | X |
|
|
418
|
-
| High | X |
|
|
419
|
-
| Medium | X |
|
|
420
|
-
| Low | X |
|
|
421
|
-
| Total Findings | X |
|
|
422
|
-
|
|
345
|
+
|
|
346
|
+
## Step 5: 生成质疑报告 (Challenge Report)
|
|
347
|
+
|
|
348
|
+
**目标**: 输出结构化报告,每个问题都有证据支撑,并采用**问题发现优先**的紧凑结构。
|
|
349
|
+
|
|
350
|
+
保存报告到 `{TARGET_DIR}/07_CHALLENGE_REPORT.md`
|
|
351
|
+
|
|
352
|
+
**报告模板**:
|
|
353
|
+
|
|
354
|
+
```markdown
|
|
355
|
+
# [项目名称] 质疑报告 (Challenge Report)
|
|
356
|
+
|
|
357
|
+
> **审查日期**: {YYYY-MM-DD}
|
|
358
|
+
> **审查范围**: {TARGET_DIR} 全部设计文档
|
|
359
|
+
> **累计轮次**: {N}
|
|
360
|
+
|
|
361
|
+
---
|
|
362
|
+
|
|
363
|
+
## 📋 问题总览
|
|
364
|
+
|
|
365
|
+
> 已解决轮次仅保留摘要。当前活跃轮只保留影响判断的高信号问题。
|
|
366
|
+
|
|
367
|
+
### 第{N}轮(当前活跃)
|
|
368
|
+
|
|
369
|
+
| 严重度 | 数量 | 摘要 | 状态 |
|
|
370
|
+
|--------|------|------|------|
|
|
371
|
+
| Critical | X | [本轮 Critical 问题的合并摘要] | ⏳ 待处理 |
|
|
372
|
+
| High | X | [本轮 High 问题的合并摘要] | ⏳ 待处理 |
|
|
373
|
+
| Medium | X | [本轮 Medium 问题的合并摘要] | ⏳ 待处理 |
|
|
374
|
+
| Low | X | [本轮 Low 问题的合并摘要或省略说明] | ⏳ 待处理 |
|
|
375
|
+
|
|
376
|
+
---
|
|
377
|
+
|
|
378
|
+
## 📊 审查摘要
|
|
379
|
+
|
|
380
|
+
**审查模式**: `{REVIEW_MODE}`
|
|
381
|
+
**整体判断**: 🟢 可继续 / 🟡 需先修复高优先问题 / 🔴 暂不建议继续
|
|
382
|
+
**高信号结论**: [用 2-4 句总结最值得关心的问题,不展开方法过程]
|
|
383
|
+
|
|
384
|
+
| 指标 | 数值 |
|
|
385
|
+
|------|------|
|
|
386
|
+
| Critical | X |
|
|
387
|
+
| High | X |
|
|
388
|
+
| Medium | X |
|
|
389
|
+
| Low | X |
|
|
390
|
+
| Total Findings | X |
|
|
391
|
+
|
|
423
392
|
| 证据来源 | 结论 |
|
|
424
393
|
|----------|------|
|
|
425
394
|
| design-reviewer | {执行 / 跳过} |
|
|
@@ -427,109 +396,99 @@ description: "对项目的设计、任务与实现进行系统性挑战,用证
|
|
|
427
396
|
| code-reviewer | {执行 / 跳过 / 自适应升级} |
|
|
428
397
|
| Pre-Mortem | {关键结论一句话} |
|
|
429
398
|
| 承诺闭合检查 | {Pass / Partial / Fail} |
|
|
430
|
-
|
|
431
|
-
---
|
|
432
|
-
|
|
433
|
-
## 🔍 核心发现清单
|
|
434
|
-
|
|
435
|
-
| ID | 类别 | 严重度 | 契约/Pass | 位置 | 发现 | 影响 | 建议 |
|
|
436
|
-
|----|------|--------|-----------|------|------|------|------|
|
|
399
|
+
|
|
400
|
+
---
|
|
401
|
+
|
|
402
|
+
## 🔍 核心发现清单
|
|
403
|
+
|
|
404
|
+
| ID | 类别 | 严重度 | 契约/Pass | 位置 | 发现 | 影响 | 建议 |
|
|
405
|
+
|----|------|--------|-----------|------|------|------|------|
|
|
437
406
|
| CH-01 | 承诺失真 | Critical | 错误承诺 / Contract Drift | PRD §X / ADR §Y / src/... | 默认失败路径未统一,契约未闭合 | 客户端错误处理分叉 | 统一错误语义并补验证任务或实现修复 |
|
|
438
407
|
| CH-02 | 任务承接 | High | E1 / Task Drift | 05_TASKS.md §X / src/... | P0 需求无对应任务或实现未兑现承接 | 核心能力无法落地 | 补充实现与验证任务 |
|
|
439
408
|
| CH-03 | 设计闭合 | Medium | RS-5 / Code Drift | 04_SYSTEM_DESIGN/... / src/... | 故障传播路径未说明或实现未按设计落地 | 出现级联失败时难以恢复 | 增加降级与超时策略 |
|
|
440
|
-
|
|
441
|
-
> 仅保留真正影响判断的问题。低价值措辞、泛泛而谈的担忧不要写进表。
|
|
442
|
-
|
|
443
|
-
---
|
|
444
|
-
|
|
445
|
-
## 建议行动清单
|
|
446
|
-
|
|
447
|
-
### P0 - 立即处理 (阻塞)
|
|
448
|
-
1. [CH-01] - [建议方案]
|
|
449
|
-
|
|
450
|
-
### P1 - 近期处理 (重要)
|
|
451
|
-
1. [CH-02] - [建议方案]
|
|
452
|
-
|
|
453
|
-
### P2 - 持续改进 (优化)
|
|
454
|
-
1. [CH-03] - [建议方案]
|
|
455
|
-
|
|
456
|
-
---
|
|
457
|
-
|
|
458
|
-
## 🚦 最终判断
|
|
459
|
-
|
|
460
|
-
- [ ] 🟢 项目可继续,风险可控
|
|
461
|
-
- [ ] 🟡 项目可继续,但需先解决 P0 问题
|
|
462
|
-
- [ ] 🔴 项目需要重新评估
|
|
463
|
-
|
|
464
|
-
**判断依据**: [基于关键问题数量、严重度和影响范围的综合评估]
|
|
465
|
-
|
|
466
|
-
---
|
|
467
|
-
|
|
468
|
-
## 📚 附录(按需)
|
|
469
|
-
|
|
470
|
-
### A. 承诺闭合与假设验证摘要
|
|
471
|
-
|
|
472
|
-
| 项目 | 结论 | 证据 | 对应问题 |
|
|
473
|
-
|------|------|------|----------|
|
|
474
|
-
| 重复态 | Pass / Partial / Fail | ... | CH-01 |
|
|
475
|
-
| 失败态 | Pass / Partial / Fail | ... | CH-02 |
|
|
476
|
-
| 默认态 | Pass / Partial / Fail | ... | CH-03 |
|
|
477
|
-
| 运行态 | Pass / Partial / Fail | ... | CH-04 |
|
|
478
|
-
|
|
479
|
-
### B. ADR 影响追踪
|
|
480
|
-
|
|
481
|
-
> **提醒**: 如果本次审查发现需要修改 ADR,请检查以下引用链:
|
|
482
|
-
|
|
483
|
-
| ADR 文件 | 引用该 ADR 的 SYSTEM_DESIGN | 影响说明 |
|
|
484
|
-
|---------|---------------------------|---------|
|
|
485
|
-
| [ADR-XXX](../03_ADR/ADR_XXX.md) | [system-1.md](../04_SYSTEM_DESIGN/system-1.md) §8 | [说明] |
|
|
486
|
-
```
|
|
487
|
-
|
|
488
|
-
## Step 6: 轮次归档协议 (Round Archive Protocol)
|
|
489
|
-
|
|
490
|
-
**目标**: 保持报告精简,已解决的轮次只保留摘要。
|
|
491
|
-
|
|
492
|
-
> [!IMPORTANT]
|
|
493
|
-
> **此步骤在每轮新审查开始时自动执行,不需要单独触发。**
|
|
494
|
-
|
|
495
|
-
### 归档规则
|
|
496
|
-
|
|
497
|
-
1.
|
|
498
|
-
2.
|
|
499
|
-
|
|
500
|
-
- **删除该轮的详细审查章节**(`## 🔥 第{N-1}轮详细审查`)
|
|
501
|
-
- 问题总览中的摘要行即为该轮的永久存档
|
|
502
|
-
3.
|
|
503
|
-
|
|
504
|
-
- 未解决的问题保留 ⏳ 并在新轮中继续跟踪
|
|
505
|
-
- 上一轮详情中仅保留未解决问题的描述
|
|
506
|
-
4.
|
|
507
|
-
|
|
508
|
-
### 总览行合并规则
|
|
509
|
-
|
|
510
|
-
同严重度的已解决问题合并为一行,格式:
|
|
511
|
-
|
|
512
|
-
|
|
513
|
-
|
|
514
|
-
|
|
515
|
-
|
|
516
|
-
|
|
517
|
-
|
|
518
|
-
```
|
|
519
|
-
|
|
520
|
-
|
|
521
|
-
|
|
522
|
-
|
|
523
|
-
|
|
524
|
-
- ✅ 已识别规范来源集合并提炼关键承诺模型
|
|
525
|
-
|
|
526
|
-
- ✅ 每个质疑点都有证据支撑
|
|
527
|
-
- ✅ 已完成承诺闭合验证(至少覆盖重复态 / 失败态 / 默认态 / 运行态)
|
|
528
|
-
- ✅ 技术健壮性审计已完成
|
|
529
|
-
- ✅ Top 3 假设已尝试验证
|
|
530
|
-
- ✅ 承诺型质疑优先于载体型质疑输出
|
|
531
|
-
- ✅ 质疑报告格式完整(含问题总览目录)
|
|
532
|
-
- ✅ 上一轮已解决问题的详情已归档(仅保留总览行)
|
|
533
|
-
- ✅ 用户已阅读并决定下一步
|
|
534
|
-
</completion_criteria>
|
|
535
|
-
|
|
409
|
+
|
|
410
|
+
> 仅保留真正影响判断的问题。低价值措辞、泛泛而谈的担忧不要写进表。
|
|
411
|
+
|
|
412
|
+
---
|
|
413
|
+
|
|
414
|
+
## 建议行动清单
|
|
415
|
+
|
|
416
|
+
### P0 - 立即处理 (阻塞)
|
|
417
|
+
1. [CH-01] - [建议方案]
|
|
418
|
+
|
|
419
|
+
### P1 - 近期处理 (重要)
|
|
420
|
+
1. [CH-02] - [建议方案]
|
|
421
|
+
|
|
422
|
+
### P2 - 持续改进 (优化)
|
|
423
|
+
1. [CH-03] - [建议方案]
|
|
424
|
+
|
|
425
|
+
---
|
|
426
|
+
|
|
427
|
+
## 🚦 最终判断
|
|
428
|
+
|
|
429
|
+
- [ ] 🟢 项目可继续,风险可控
|
|
430
|
+
- [ ] 🟡 项目可继续,但需先解决 P0 问题
|
|
431
|
+
- [ ] 🔴 项目需要重新评估
|
|
432
|
+
|
|
433
|
+
**判断依据**: [基于关键问题数量、严重度和影响范围的综合评估]
|
|
434
|
+
|
|
435
|
+
---
|
|
436
|
+
|
|
437
|
+
## 📚 附录(按需)
|
|
438
|
+
|
|
439
|
+
### A. 承诺闭合与假设验证摘要
|
|
440
|
+
|
|
441
|
+
| 项目 | 结论 | 证据 | 对应问题 |
|
|
442
|
+
|------|------|------|----------|
|
|
443
|
+
| 重复态 | Pass / Partial / Fail | ... | CH-01 |
|
|
444
|
+
| 失败态 | Pass / Partial / Fail | ... | CH-02 |
|
|
445
|
+
| 默认态 | Pass / Partial / Fail | ... | CH-03 |
|
|
446
|
+
| 运行态 | Pass / Partial / Fail | ... | CH-04 |
|
|
447
|
+
|
|
448
|
+
### B. ADR 影响追踪
|
|
449
|
+
|
|
450
|
+
> **提醒**: 如果本次审查发现需要修改 ADR,请检查以下引用链:
|
|
451
|
+
|
|
452
|
+
| ADR 文件 | 引用该 ADR 的 SYSTEM_DESIGN | 影响说明 |
|
|
453
|
+
|---------|---------------------------|---------|
|
|
454
|
+
| [ADR-XXX](../03_ADR/ADR_XXX.md) | [system-1.md](../04_SYSTEM_DESIGN/system-1.md) §8 | [说明] |
|
|
455
|
+
```
|
|
456
|
+
|
|
457
|
+
## Step 6: 轮次归档协议 (Round Archive Protocol)
|
|
458
|
+
|
|
459
|
+
**目标**: 保持报告精简,已解决的轮次只保留摘要。
|
|
460
|
+
|
|
461
|
+
> [!IMPORTANT]
|
|
462
|
+
> **此步骤在每轮新审查开始时自动执行,不需要单独触发。**
|
|
463
|
+
|
|
464
|
+
### 归档规则
|
|
465
|
+
|
|
466
|
+
1. **新轮审查开始时**,检查上一轮的所有问题是否已解决(由用户确认修复)
|
|
467
|
+
2. **如已解决** →
|
|
468
|
+
- 在 `📋 问题总览` 中将该轮的状态全部标为 ✅
|
|
469
|
+
- **删除该轮的详细审查章节**(`## 🔥 第{N-1}轮详细审查`)
|
|
470
|
+
- 问题总览中的摘要行即为该轮的永久存档
|
|
471
|
+
3. **如部分解决** →
|
|
472
|
+
- 已解决的问题在总览中标 ✅
|
|
473
|
+
- 未解决的问题保留 ⏳ 并在新轮中继续跟踪
|
|
474
|
+
- 上一轮详情中仅保留未解决问题的描述
|
|
475
|
+
4. **报告中同一时刻只有一轮详细内容**(当前活跃轮)
|
|
476
|
+
|
|
477
|
+
### 总览行合并规则
|
|
478
|
+
|
|
479
|
+
同严重度的已解决问题合并为一行,格式:
|
|
480
|
+
|
|
481
|
+
```markdown
|
|
482
|
+
| C1-C4 | 🔴 | 条约矛盾/毁约逻辑/升级公式/领地缺失 | ✅ 全部修复 |
|
|
483
|
+
```
|
|
484
|
+
|
|
485
|
+
未解决问题保持独立行,格式:
|
|
486
|
+
|
|
487
|
+
```markdown
|
|
488
|
+
| R2-C1 | 🔴 | executor v2 动作缺失 | ⏳ 待修复 |
|
|
489
|
+
```
|
|
490
|
+
|
|
491
|
+
---
|
|
492
|
+
|
|
493
|
+
- ✅ 深度阅读了项目设计文档 - ✅ 已识别规范来源集合并提炼关键承诺模型 - ✅ Pre-Mortem 分析有逻辑依据 - ✅ 每个质疑点都有证据支撑 - ✅ 已完成承诺闭合验证(至少覆盖重复态 / 失败态 / 默认态 / 运行态) - ✅ 技术健壮性审计已完成 - ✅ Top 3 假设已尝试验证 - ✅ 承诺型质疑优先于载体型质疑输出 - ✅ 质疑报告格式完整(含问题总览目录) - ✅ 上一轮已解决问题的详情已归档(仅保留总览行) - ✅ 用户已阅读并决定下一步
|
|
494
|
+
|