@haaaiawd/anws 2.2.4 → 2.2.6
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 +21 -26
- package/lib/manifest.js +2 -1
- package/package.json +1 -1
- package/templates/.agents/skills/anws-system/SKILL.md +108 -108
- package/templates/.agents/skills/code-reviewer/SKILL.md +8 -7
- package/templates/.agents/skills/e2e-testing-guide/SKILL.md +134 -135
- package/templates/.agents/skills/task-planner/SKILL.md +253 -699
- package/templates/.agents/skills/task-planner/references/TASK_TEMPLATE_05A.md +163 -0
- package/templates/.agents/skills/task-planner/references/TASK_TEMPLATE_05B.md +175 -0
- package/templates/.agents/skills/task-reviewer/SKILL.md +6 -6
- package/templates/.agents/workflows/blueprint.md +44 -358
- package/templates/.agents/workflows/challenge.md +40 -37
- package/templates/.agents/workflows/change.md +339 -346
- package/templates/.agents/workflows/craft.md +5 -12
- package/templates/.agents/workflows/design-system.md +674 -631
- package/templates/.agents/workflows/explore.md +399 -400
- package/templates/.agents/workflows/forge.md +90 -99
- package/templates/.agents/workflows/genesis.md +351 -353
- package/templates/.agents/workflows/probe.md +241 -243
- package/templates/.agents/workflows/quickstart.md +123 -123
- package/templates/.agents/workflows/upgrade.md +1 -11
- package/templates/AGENTS.md +149 -149
- package/templates/.agents/skills/task-planner/references/TASK_TEMPLATE.md +0 -214
|
@@ -40,20 +40,20 @@
|
|
|
40
40
|
> `**/forge` 的权限严格限定**:
|
|
41
41
|
>
|
|
42
42
|
>
|
|
43
|
-
> | 能力
|
|
44
|
-
> |
|
|
45
|
-
> | 在 `src/` 下编写业务代码
|
|
46
|
-
> | 编写单元测试
|
|
47
|
-
> | 更新 `
|
|
48
|
-
> | 运行测试和 lint
|
|
49
|
-
> | Git commit 已完成的任务
|
|
50
|
-
> | 更新 `AGENTS.md` 当前状态
|
|
51
|
-
> | **修改 `.anws/` 下任何设计文档**
|
|
52
|
-
> | **创建
|
|
53
|
-
> | **降级或跳过验收标准**
|
|
54
|
-
> | **引入 ADR 未批准的第三方依赖**
|
|
55
|
-
> | **修改已有代码的公共接口(除非任务明确要求)**
|
|
56
|
-
> | **"顺便"优化/重构不在任务范围内的代码**
|
|
43
|
+
> | 能力 | 允许 | 禁止 |
|
|
44
|
+
> | ---------------------------- | --- | --- |
|
|
45
|
+
> | 在 `src/` 下编写业务代码 | 是 | |
|
|
46
|
+
> | 编写单元测试 | 是 | |
|
|
47
|
+
> | 更新 `05A_TASKS.md` 的 checkbox | 是 | |
|
|
48
|
+
> | 运行测试和 lint | 是 | |
|
|
49
|
+
> | Git commit 已完成的任务 | 是 | |
|
|
50
|
+
> | 更新 `AGENTS.md` 当前状态 | 是 | |
|
|
51
|
+
> | **修改 `.anws/` 下任何设计文档** | | 是 |
|
|
52
|
+
> | **创建 05A_TASKS.md 中不存在的功能** | | 是 |
|
|
53
|
+
> | **降级或跳过验收标准** | | 是 |
|
|
54
|
+
> | **引入 ADR 未批准的第三方依赖** | | 是 |
|
|
55
|
+
> | **修改已有代码的公共接口(除非任务明确要求)** | | 是 |
|
|
56
|
+
> | **"顺便"优化/重构不在任务范围内的代码** | | 是 |
|
|
57
57
|
>
|
|
58
58
|
|
|
59
59
|
---
|
|
@@ -104,16 +104,17 @@
|
|
|
104
104
|
3. **检查必需文件**:
|
|
105
105
|
- `{TARGET_DIR}/01_PRD.md` 存在
|
|
106
106
|
- `{TARGET_DIR}/02_ARCHITECTURE_OVERVIEW.md` 存在
|
|
107
|
-
- `{TARGET_DIR}/
|
|
107
|
+
- `{TARGET_DIR}/05A_TASKS.md` 存在
|
|
108
|
+
- `{TARGET_DIR}/05B_VERIFICATION_PLAN.md` 存在
|
|
108
109
|
4. **检查推荐文件** (缺失则警告):
|
|
109
110
|
- `{TARGET_DIR}/04_SYSTEM_DESIGN/` 存在且非空
|
|
110
111
|
- 如缺失: " 建议先运行 `/design-system`。缺少详细设计可能导致实现质量下降。"
|
|
111
112
|
5. **如果必需文件缺失**: 报错并提示运行 `/genesis` + `/blueprint`。
|
|
112
|
-
6.
|
|
113
|
+
6. `**07_CHALLENGE_REPORT.md`(若存在)**:先读结论;有未闭环 Critical → 停止,不得进入本工作流后续编码步骤;有未闭环 High → 仅用户显式放行(AUTO 不可替代);其余继续。门禁语义与 `**/challenge`** 一致,**不在此重复展开**。
|
|
113
114
|
7. **断点续做判定**:
|
|
114
115
|
- 读取 `AGENTS.md` 的 `Wave` 块
|
|
115
116
|
- 如果存在波次信息:
|
|
116
|
-
- 查看波次任务列表,对照 `
|
|
117
|
+
- 查看波次任务列表,对照 `05A_TASKS.md` 中的 checkbox
|
|
117
118
|
- 如有未完成任务 → **断点续做** → 跳入 Step 3 继续未完成的任务
|
|
118
119
|
- 如全部完成 → **新波次** → 继续 Step 1
|
|
119
120
|
- 如果不存在 → **新开始** → 继续 Step 1
|
|
@@ -136,7 +137,7 @@
|
|
|
136
137
|
> 同主题就不换分支,`/change` 不换分支,`/genesis` 才换分支;开发都在 `feature/`*,稳定结果才进 `main`,tag 只打 `main`。
|
|
137
138
|
|
|
138
139
|
> [!IMPORTANT]
|
|
139
|
-
> **AUTO 与在场性**:一旦判定为 **AUTO 模式**,默认用户**可能不在屏幕前**(喝咖啡、休息等)。除 **Step 0** 中
|
|
140
|
+
> **AUTO 与在场性**:一旦判定为 **AUTO 模式**,默认用户**可能不在屏幕前**(喝咖啡、休息等)。除 **Step 0** 中 `**07_CHALLENGE_REPORT` Critical 未闭环**、**§3.4.5 波末 `code-reviewer` 硬阻塞**、任务 **手动验证**须用户终局确认、以及 **Step 4.4「AUTO 必须停下」** 所列情形外,**不要**再就「是否确认本波任务组合」「是否继续下一波」等向用户发问;展示 Wave 建议后以 `**AUTO`** 假名签署并进入 **Step 2**。需要人类随队微调波次请用**普通模式**。
|
|
140
141
|
|
|
141
142
|
---
|
|
142
143
|
|
|
@@ -147,14 +148,14 @@
|
|
|
147
148
|
> [!IMPORTANT]
|
|
148
149
|
> **模式边界(CRITICAL)**
|
|
149
150
|
>
|
|
150
|
-
> - **普通模式(默认)**:与既有协议一致——**每一波**在 Step 1 **展示 Wave 建议 → 用户确认并批准本波任务组合(签名)→** 再写入 `AGENTS.md` 的 `Wave`
|
|
151
|
+
> - **普通模式(默认)**:与既有协议一致——**每一波**在 Step 1 **展示 Wave 建议 → 用户确认并批准本波任务组合(签名)→** 再写入 `AGENTS.md` 的 `Wave` 块,然后进入 **Step 2**;Step 4 结算后若仍有未完成任务,**下一波**仍须回到 Step 1 **再次**展示并**等待用户批准**,不得在未经批准时开工下一波。Step 4.4 的「不问是否继续」**仅适用于 AUTO**,**不**削弱普通模式的逐波批准权。
|
|
151
152
|
> - **AUTO 模式**(`/forge自动` 或用户明确要求自动连续推进):检查点逻辑仍在,但签名人记为 `AUTO`;**不得**为「波次是否满意」「是否继续下一波」发起闲聊式确认(见 **Step 0「AUTO 与在场性」**、**Step 4.4**)。
|
|
152
153
|
>
|
|
153
154
|
> **为什么?** 优先级与任务边界须可审计;普通模式由人**逐波把关**,AUTO 则由硬性停止条件顶替「人在场」的口头确认。
|
|
154
155
|
|
|
155
156
|
### 1.1 扫描可执行任务
|
|
156
157
|
|
|
157
|
-
读取 `{TARGET_DIR}/
|
|
158
|
+
读取 `{TARGET_DIR}/05A_TASKS.md`,找出所有满足以下条件的任务:
|
|
158
159
|
|
|
159
160
|
- `- [ ]` 未完成
|
|
160
161
|
- 依赖的任务(`**依赖`** 字段)均已完成 `- [x]`
|
|
@@ -198,33 +199,14 @@ T{X.Y.Z}, T{X.Y.Z}, T{X.Y.Z}
|
|
|
198
199
|
|
|
199
200
|
签名规则(与 **模式边界** 一致):
|
|
200
201
|
|
|
201
|
-
- **普通模式** → 用户**明示批准**本波 Wave(可对任务组合提出调整,定稿后再签)→ 写入 `AGENTS.md` `Wave` 块 →
|
|
202
|
-
- **AUTO 模式** → 展示 Wave 建议后**立即**将本波记为 `AUTO`
|
|
203
|
-
|
|
204
|
-
### 1.4 波前静态审查(`code-reviewer`,默认每波)
|
|
205
|
-
|
|
206
|
-
**时机**:`AGENTS.md` 的 **Wave {N}** 已写入且 **Step 1 签名**已达成之后,**进入 Step 2 之前**。
|
|
207
|
-
|
|
208
|
-
**断点续做**:Step 0 若判定**同一波**未收官、直接进入 Step 3,视为该波已在当时完成 Step 1 批准;**不**对同一波重复 §1.4。若无法从 Wave 备注 / 会话记录确认本波曾完成 §1.4(须有一次审查产出或合法豁免),**回到 Step 1** 补办本波签名与 §1.4,再进入 Step 2/3。
|
|
209
|
-
|
|
210
|
-
**默认**:每一**新**波次(含普通模式下用户刚批准的下一波)都必须执行一轮 **`code-reviewer`**,审查对象为 **截至本波开始前、当前工作分支上已 commit 的实现**(相对 `{TARGET_DIR}` 下 PRD / Architecture / ADR / System Design / **`05_TASKS.md`**,含本波将执行任务之契约边界),避免带着错误假设进入编码。
|
|
211
|
-
|
|
212
|
-
**仅以下情形可跳过(须写明原因,写入 Wave 备注或等同持久位)**:
|
|
213
|
-
|
|
214
|
-
1. **无可审实现**:业务实现根(如 `src/`,以项目约定为准)上**尚无可审查的、与本 Sprint / 本波相关的已落地代码**(纯初始化、仅文档、尚未开工)— **不做**形式主义空跑。
|
|
215
|
-
2. **用户明确全域禁止 static review**:用户**明示**「不做 code review / 跳过一切 `code-reviewer`」— 本会话内后续各波均不再调用 **`code-reviewer`**,直接进 **Step 2**;须在 **`AGENTS.md`** 或 Wave 侧标注 **`CODE_REVIEW_DISABLED_BY_USER`**,直至用户声明撤销。**未**收到明示前 **禁止** AI 自行省略波审。
|
|
216
|
-
|
|
217
|
-
**执行**:完整遵从 **`code-reviewer`** skill;宿主有子代理时 **优先**委派。
|
|
218
|
-
|
|
219
|
-
**门禁路由**:Critical / High 按 skill 走 **`/change`** / **`/genesis`**;未解决 blocking 前 **不得** 进入 Step 2(**含 AUTO**,遇此类必须停下)。
|
|
220
|
-
|
|
221
|
-
然后进入 **Step 2**。
|
|
202
|
+
- **普通模式** → 用户**明示批准**本波 Wave(可对任务组合提出调整,定稿后再签)→ 写入 `AGENTS.md` `Wave` 块 → 进入 **Step 2**。**禁止**在用户未批准前写入 Wave 或进入 Step 2/3。
|
|
203
|
+
- **AUTO 模式** → 展示 Wave 建议后**立即**将本波记为 `AUTO` 签入并进入 **Step 2**(**不得**为「确认组合是否满意」再打断用户)。
|
|
222
204
|
|
|
223
205
|
---
|
|
224
206
|
|
|
225
207
|
## Step 2: 上下文加载 (Context Loading)
|
|
226
208
|
|
|
227
|
-
**目标**:
|
|
209
|
+
**目标**: 按需加载本波次需要的文档,不多加载一份。
|
|
228
210
|
|
|
229
211
|
> [!IMPORTANT]
|
|
230
212
|
> **只加载当前波次需要的文档。不要"以防万一"多加载。**
|
|
@@ -234,12 +216,12 @@ T{X.Y.Z}, T{X.Y.Z}, T{X.Y.Z}
|
|
|
234
216
|
### 加载层级
|
|
235
217
|
|
|
236
218
|
|
|
237
|
-
| 层级 | 内容
|
|
238
|
-
| ------------ |
|
|
239
|
-
| **L0 全局** | `02_ARCHITECTURE_OVERVIEW.md`
|
|
240
|
-
| **L1 波级** | 本波涉及系统的 `04_SYSTEM_DESIGN/{system}.md`(L0 导航层)+ 相关 ADR
|
|
241
|
-
| **L1.5 实现级** | 本波任务 `**输入`** 字段中明确引用的 `{system}.detail.md` **对应 §章节**
|
|
242
|
-
| **L2 任务级** | 每个任务的 `**输入`** 字段指定的精确文档章节
|
|
219
|
+
| 层级 | 内容 | 目的 |
|
|
220
|
+
| ------------ | ----------------------------------------------------------------- | ----------- |
|
|
221
|
+
| **L0 全局** | `02_ARCHITECTURE_OVERVIEW.md` + `05B_VERIFICATION_PLAN.md`(目录/索引) | 任务定位 + 验证定位 |
|
|
222
|
+
| **L1 波级** | 本波涉及系统的 `04_SYSTEM_DESIGN/{system}.md`(L0 导航层)+ 相关 ADR | 设计规范、接口契约 |
|
|
223
|
+
| **L1.5 实现级** | 本波任务 `**输入`** 字段中明确引用的 `{system}.detail.md` **对应 §章节** | 算法伪代码、配置常量 |
|
|
224
|
+
| **L2 任务级** | 每个任务的 `**输入`** 字段指定的精确文档章节 | 实现细节 |
|
|
243
225
|
|
|
244
226
|
|
|
245
227
|
> [!IMPORTANT]
|
|
@@ -259,6 +241,7 @@ T{X.Y.Z}, T{X.Y.Z}, T{X.Y.Z}
|
|
|
259
241
|
2. **L1**: 根据本波任务涉及的系统,读取对应的:
|
|
260
242
|
- `{TARGET_DIR}/04_SYSTEM_DESIGN/{system-id}.md`
|
|
261
243
|
- `{TARGET_DIR}/03_ADR/` 中相关的 ADR(由任务的"输入"字段指引)
|
|
244
|
+
3. **L2 验证输入**: 读取 `05B_VERIFICATION_PLAN.md` 中与本波任务相关的章节(按 Task ID 或验证引用定位)
|
|
262
245
|
|
|
263
246
|
---
|
|
264
247
|
|
|
@@ -269,25 +252,26 @@ T{X.Y.Z}, T{X.Y.Z}, T{X.Y.Z}
|
|
|
269
252
|
> [!IMPORTANT]
|
|
270
253
|
> **严格按以下流程执行每个任务,不跳步。**
|
|
271
254
|
|
|
272
|
-
### Wave 内建结构(Wave =
|
|
255
|
+
### Wave 内建结构(Wave = 逐任务循环 + 波末合拢)
|
|
273
256
|
|
|
274
|
-
把 **一次 Wave** 视为
|
|
257
|
+
把 **一次 Wave** 视为 **逐任务循环(阶段 A)+ 末任务波末合拢(阶段 B)**(**未完成不得进入 Step 4**):
|
|
275
258
|
|
|
276
259
|
|
|
277
|
-
| 阶段
|
|
278
|
-
|
|
|
279
|
-
| **
|
|
280
|
-
| **
|
|
260
|
+
| 阶段 | 内容 | 完成判据 |
|
|
261
|
+
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
|
|
262
|
+
| **A. 逐任务循环** | **非末任务**:**§3.1 → §3.6**(含 §3.4,**不**跑 §3.4.5 / §3.4.6 / §3.4.5.1)。**末任务**:**§3.1 → §3.4** → **§3.4.5** → **§3.4.6** → **§3.4.5.1** → **§3.6** | 每任务验收与 commit 已落地;`05A_TASKS.md` 已回写;末任务后 **§3.4.5 / §3.4.6 / §3.4.5.1** 已闭环或可豁免 |
|
|
263
|
+
| **B. 波末合拢** | 仅 **本波最后一项任务**:**§3.4.5**(`code-reviewer`)→ **§3.4.6** → **§3.4.5.1**(极简交付索引)→ **§3.6** | 与 **Step 4 §4.0** 同一门禁 |
|
|
281
264
|
|
|
282
|
-
> **一句**:**§1.4** 与 **Step 4 §4.0** 对齐(波前已完成或可豁免)。
|
|
283
265
|
|
|
284
|
-
|
|
266
|
+
> **一句**:`**code-reviewer` 正文**以 `**code-reviewer`** skill 为准(与 `**/challenge**` 共用);**§3.4.5.1** 仅为 `**/forge` 极简交付索引表**,**不得**替代 skill 报告体。
|
|
267
|
+
|
|
268
|
+
对本波次中的每个任务,执行以下循环(阶段 A / B 见上表):
|
|
285
269
|
|
|
286
270
|
---
|
|
287
271
|
|
|
288
272
|
### 3.1 加载任务级上下文
|
|
289
273
|
|
|
290
|
-
读取该任务 `**输入`**
|
|
274
|
+
读取该任务 `**输入`** 字段指定的文档和章节,并同步读取 `05B_VERIFICATION_PLAN.md` 中该任务的验证章节(Task ID / 验证引用)。
|
|
291
275
|
如果任务依赖已完成的前置任务,浏览相关已有代码了解接口。
|
|
292
276
|
|
|
293
277
|
> [!IMPORTANT]
|
|
@@ -352,7 +336,7 @@ T{X.Y.Z}, T{X.Y.Z}, T{X.Y.Z}
|
|
|
352
336
|
|
|
353
337
|
### 3.4 验证 (Verify)
|
|
354
338
|
|
|
355
|
-
|
|
339
|
+
**根据任务的验证类型执行相应验证**,并与 `05B_VERIFICATION_PLAN.md` 中的验证方法与证据要求对齐:
|
|
356
340
|
|
|
357
341
|
> [!IMPORTANT]
|
|
358
342
|
> **验证类型决定验证方式和证据要求**:
|
|
@@ -398,40 +382,52 @@ T{X.Y.Z}, T{X.Y.Z}, T{X.Y.Z}
|
|
|
398
382
|
|
|
399
383
|
- 若任一自动验证类型未通过 → **修复后重新验证**,不得跳过
|
|
400
384
|
- 若全部自动验证类型通过:
|
|
401
|
-
- **非本波最后一个任务** → **3.5
|
|
402
|
-
- **本波最后一个任务** → **§3.4.6(见下)** →
|
|
385
|
+
- **非本波最后一个任务** → **3.6**(不在此执行 **§3.4.5 / §3.4.6 / §3.4.5.1**)。
|
|
386
|
+
- **本波最后一个任务** → **§3.4.5(见下)** → **§3.4.6(见下)** → **§3.4.5.1(见下)** → **3.6**。
|
|
403
387
|
|
|
404
|
-
### 3.4.
|
|
388
|
+
### 3.4.5 波末静态审查(`code-reviewer`)
|
|
405
389
|
|
|
406
|
-
|
|
390
|
+
**时机**:**仅本波最后一个任务**,且该任务 **§3.4**(自动侧)已全部通过之后、**§3.4.6** 之前。
|
|
407
391
|
|
|
408
|
-
|
|
409
|
-
- **必须**提示用户二选一(除非用户已预先声明):
|
|
410
|
-
- **收尾 A**:本轮**仅**依赖 **§1.4** 已完成的 **`code-reviewer`**(或合法豁免记录)+ 本任务 **§3.4**,**不**再跑 E2E 报告与浏览器;若仍残留 UI 类验收未测,须在 Wave/会话备注写明**风险与原因**。
|
|
411
|
-
- **收尾 B**:**先** 严格按 **`e2e-testing-guide`** skill **只写**《E2E Verification》指南与表格(报告骨架与三档评测含义以 skill **Required output** 内 `<!-- -->` 注释为准:**仅** `PASS` / `PARTIAL_PASS` / `FAIL`);**再** 在用户授权下用宿主 **浏览器工具** 按报告逐步执行,并把 **Evidence / 各 verdict 列** 回填。
|
|
412
|
-
2. 若本波**无**上述验证类型 → 一行 `§3.4.6 skipped — no E2E/manual in wave` → **3.5**。
|
|
413
|
-
3. **无浏览器工具**:只交付 skill 文档,标注 `guide-only`,不得声称已完成实机 `PASS`。
|
|
392
|
+
完整遵从 `**code-reviewer`** skill 写**审查全文**(Lens、证据规则与 `**/challenge`** 共用,**不得**因挂在 `/forge` 而删减 skill 要求);宿主有子代理时 **优先**委派。
|
|
414
393
|
|
|
415
|
-
|
|
394
|
+
**仅以下可豁免(须落盘于 Wave 备注或等同位)**:用户明示「不做 code review / 跳过一切 `code-reviewer`」→ 标 `**CODE_REVIEW_DISABLED_BY_USER`**。
|
|
395
|
+
|
|
396
|
+
**门禁路由**:Critical / High 按 skill → `**/change`** / `**/genesis`**;未解决 blocking 前 不得 进入 §3.4.6、**§3.4.5.1** 与 **§3.6**(**含 AUTO**,须停)。
|
|
416
397
|
|
|
417
|
-
### 3.
|
|
398
|
+
### 3.4.6 波末 E2E(写死:`e2e-testing-guide` → 浏览器)
|
|
418
399
|
|
|
419
|
-
|
|
400
|
+
**仅**在 **本波最后一个任务**、且 **§3.4.5** 已满足或可豁免之后执行。此处**不再**重复跑 `**code-reviewer`**。
|
|
420
401
|
|
|
402
|
+
1. 若本波 `05A_TASKS.md` 中**任一**任务含 **E2E测试** 或 **手动验证**(或等价须实机 UI 的验收),或 `05B_VERIFICATION_PLAN.md` 明确要求实机验证:
|
|
403
|
+
- **必须**提示用户二选一(除非用户已预先声明):
|
|
404
|
+
- **收尾 A**:本轮依赖 **§3.4.5** 已完成的 `**code-reviewer`**(或合法豁免)+ 本任务 §3.4,不再跑 E2E 报告与浏览器;若仍残留 UI 类验收未测,须在 Wave/会话备注写明**风险与原因**。
|
|
405
|
+
- **收尾 B**:**先** 严格按 `**e2e-testing-guide`** skill **只写**《E2E Verification》指南与表格(报告骨架与三档评测含义以 skill **Required output** 内 `<!-- -->` 注释为准:**仅** `PASS` / `PARTIAL_PASS` / `FAIL`);**再** 在用户授权下用宿主 **浏览器工具** 按报告逐步执行,并把 **Evidence / 各 verdict 列** 回填。
|
|
406
|
+
2. 若本波**无**上述验证类型 → 一行 `§3.4.6 skipped — no E2E/manual in wave`(仍须进入 **§3.4.5.1**)。
|
|
407
|
+
3. **无浏览器工具**:只交付 skill 文档,标注 `guide-only`,不得声称已完成实机 `PASS`。
|
|
421
408
|
|
|
422
|
-
|
|
423
|
-
| --- | ------------------------- | --- |
|
|
424
|
-
| 1 | 代码接口与 SYSTEM_DESIGN 定义一致? | 是/否 |
|
|
425
|
-
| 2 | 未引入 ADR 未批准的依赖? | 是/否 |
|
|
426
|
-
| 3 | 未添加任务范围外的功能? | 是/否 |
|
|
427
|
-
| 4 | 代码风格与项目一致,lint 通过? | 是/否 |
|
|
428
|
-
| 5 | 所有验收标准已验证通过? | 是/否 |
|
|
429
|
-
| 6 | 所有可执行验收标准有足够证据(终端/日志/截图)? | 是/否 |
|
|
430
|
-
| 7 | 需人工确认的验收标准已标记 ? | 是/否 |
|
|
409
|
+
### 3.4.5.1 `/forge` 极简交付索引(非 `code-reviewer` 报告)
|
|
431
410
|
|
|
411
|
+
**时机**:**§3.4.6** 之后、**§3.6 提交** 之前(仅末任务路径)。
|
|
432
412
|
|
|
433
|
-
-
|
|
434
|
-
|
|
413
|
+
**性质**:**不是**审查正文;**不得**用本表替代 `**code-reviewer`** skill 输出。本表仅为 `**/forge` 波次交付封面索引**(固定列,不扩写长文)。
|
|
414
|
+
|
|
415
|
+
```markdown
|
|
416
|
+
## Wave {N} 交付索引(/forge 极简)
|
|
417
|
+
|
|
418
|
+
| 项 | 值 |
|
|
419
|
+
| -- | -- |
|
|
420
|
+
| Wave | {N} |
|
|
421
|
+
| 任务 ID | T…, T… |
|
|
422
|
+
| 分支 @ HEAD | `feature/…` @ `<短 SHA>` |
|
|
423
|
+
| `code-reviewer` | 已执行 / 豁免:`CODE_REVIEW_DISABLED_BY_USER` |
|
|
424
|
+
| 审查正文索引 | 见上「code-reviewer」输出块标题或首行 / `N/A — USER_OPT_OUT` |
|
|
425
|
+
| §3.4.6 E2E | 已做 / 已跳过 / N/A |
|
|
426
|
+
| 本波可进 Step 4 | 是 / 否 |
|
|
427
|
+
```
|
|
428
|
+
|
|
429
|
+
> [!IMPORTANT]
|
|
430
|
+
> **交付完整性**:**「本波可进 Step 4」= 是** 仅当:`code-reviewer` 已可溯源执行 **或** 已 `**CODE_REVIEW_DISABLED_BY_USER`**,且上表六行均已填写。否则视为**交付不完整**,**禁止**进入 **Step 4.1+**。**未**获用户明示前,**禁止** AI 自行省略 `**code-reviewer`**。
|
|
435
431
|
|
|
436
432
|
---
|
|
437
433
|
|
|
@@ -447,7 +443,7 @@ T{X.Y.Z}, T{X.Y.Z}, T{X.Y.Z}
|
|
|
447
443
|
- 例: `fix(challenge): T4.2.3 — 严重度语义对齐`
|
|
448
444
|
2. **任务完成持久化** (立即回写):
|
|
449
445
|
> [!IMPORTANT]
|
|
450
|
-
> **每完成一个 task 并通过验证,立即回写 `
|
|
446
|
+
> **每完成一个 task 并通过验证,立即回写 `05A_TASKS.md`**。
|
|
451
447
|
> 这是进度持久化的核心机制——即使 AI 上下文丢失或会话崩溃,
|
|
452
448
|
> 下次加载 TASKS.md 就能看到精确进度。
|
|
453
449
|
> 配合 AGENTS.md 的 Wave 块形成**双层恢复机制**: 粗粒度(Wave) + 细粒度(Task checkbox)。
|
|
@@ -455,7 +451,7 @@ T{X.Y.Z}, T{X.Y.Z}, T{X.Y.Z}
|
|
|
455
451
|
- 仅按 **Task ID** 精确定位并更新状态,禁止按标题模糊匹配
|
|
456
452
|
- 将对应任务的 `- [ ]` 改为 `- [x]`
|
|
457
453
|
- 不得顺手修改未完成、未验证或不在当前波次内的任务
|
|
458
|
-
- 确保回写后的 `
|
|
454
|
+
- 确保回写后的 `05A_TASKS.md` 与实际进度一致
|
|
459
455
|
3. **继续下一个任务** → 回到 3.1
|
|
460
456
|
|
|
461
457
|
---
|
|
@@ -468,10 +464,10 @@ T{X.Y.Z}, T{X.Y.Z}, T{X.Y.Z}
|
|
|
468
464
|
|
|
469
465
|
同时满足方可进入 **4.1+**:
|
|
470
466
|
|
|
471
|
-
1. **§
|
|
472
|
-
2. **Step 3
|
|
467
|
+
1. **§3.4.5 / §3.4.5.1 / §3.4.6**:**末任务**路径上 `**code-reviewer`** 已完成(可溯源)或 `**CODE_REVIEW_DISABLED_BY_USER`** 已落盘;**§3.4.6** 已按 **收尾 A/B** 处理或已跳过;**§3.4.5.1** 极简交付索引表已填且 **「本波可进 Step 4」= 是**。
|
|
468
|
+
2. **Step 3**:本波内**全部**任务已完成,且 **§3.6**(每任务 commit + `05A_TASKS` 回写)已闭环。
|
|
473
469
|
|
|
474
|
-
**不满足 → 禁止**进入 **4.1 及之后**;回到 Step
|
|
470
|
+
**不满足 → 禁止**进入 **4.1 及之后**;回到 Step 3 补齐波末合拢。
|
|
475
471
|
|
|
476
472
|
### 4.1 更新状态
|
|
477
473
|
|
|
@@ -488,15 +484,18 @@ T{X.Y.Z}, T{X.Y.Z}, T{X.Y.Z}
|
|
|
488
484
|
|
|
489
485
|
### 4.2 波次回顾
|
|
490
486
|
|
|
491
|
-
|
|
487
|
+
向用户按 **Wave 完成模板**汇报(可与 `AGENTS.md` / 会话归档对齐);**须包含** **§3.4.5.1** 极简交付索引表(整表粘贴,**不**展开 `code-reviewer` 全文):
|
|
492
488
|
|
|
493
489
|
```markdown
|
|
494
|
-
## Wave {N} 完成
|
|
490
|
+
## 🌊 Wave {N} 完成
|
|
495
491
|
|
|
496
492
|
**已完成**: T{X.Y.Z}, T{X.Y.Z}, ...
|
|
497
493
|
**验证状态**: 全部通过 / 部分通过
|
|
494
|
+
**Code review(检测与修复结果)**: 最高严重度:无 / Low / Medium / High / Critical;本波已修复:…;残留待跟进:无 / …(**审查正文索引**:§3.4.5 输出块标题或首行;若豁免写 `CODE_REVIEW_DISABLED_BY_USER`)
|
|
498
495
|
**发现的问题** (如有): ...
|
|
499
496
|
**阻塞项** (如有): ...
|
|
497
|
+
|
|
498
|
+
(粘贴 §3.4.5.1「Wave {N} 交付索引」表)
|
|
500
499
|
```
|
|
501
500
|
|
|
502
501
|
### 4.3 Git commit 状态更新
|
|
@@ -513,7 +512,7 @@ chore(wave): settle wave {N} progress
|
|
|
513
512
|
|
|
514
513
|
**签名检查点** :
|
|
515
514
|
|
|
516
|
-
- 还有未完成任务 → **普通模式**:展示下一波 Wave 建议并等待用户签名 → 回到 **Step 1**。**AUTO 模式**:**不得**再问「是否继续下一波」— 直接回到 **Step 1** 并以
|
|
515
|
+
- 还有未完成任务 → **普通模式**:展示下一波 Wave 建议并等待用户签名 → 回到 **Step 1**。**AUTO 模式**:**不得**再问「是否继续下一波」— 直接回到 **Step 1** 并以 `**AUTO`** 签署下一波(展示 Wave 建议即可)。
|
|
517
516
|
- 当前 Sprint 所有任务完成 → 进入 **Step 5**
|
|
518
517
|
- 有阻塞问题 → 引导用户运行相应工作流修复
|
|
519
518
|
|
|
@@ -523,7 +522,7 @@ chore(wave): settle wave {N} progress
|
|
|
523
522
|
> - 命中手动验证且需要用户最终确认
|
|
524
523
|
> - `/change` 评估后发现必须升级到 `/genesis`
|
|
525
524
|
> - 其他工作流要求用户作出新的版本级决定
|
|
526
|
-
> - **§
|
|
525
|
+
> - **§3.4.5 波末 `code-reviewer`** 产出未解决的 **Critical / High**,且无法在本会话内按 skill 收窄为可执行修复路径(须走 `**/change`** / `**/genesis`** 或用户显式承担风险—**未显式承担则停**)
|
|
527
526
|
>
|
|
528
527
|
> 命中以上任一条件,AUTO 必须立即停止,等待用户批准。
|
|
529
528
|
|
|
@@ -549,11 +548,3 @@ chore(wave): settle wave {N} progress
|
|
|
549
548
|
|
|
550
549
|
---
|
|
551
550
|
|
|
552
|
-
- 每个任务的验收标准全部通过
|
|
553
|
-
- 每个任务的遵从性检查全部通过
|
|
554
|
-
- **§1.4 / §3.4.6**:**§4.0** 已满足;§1.4 波前审查或合法豁免已落盘;§3.4.6 已按 **收尾 A/B** 处理(选 A 须有备注),或本波无 E2E/手动态
|
|
555
|
-
- 所有代码已 git commit,message 包含 Task ID
|
|
556
|
-
- 所有任务已完成持久化(`05_TASKS.md`)
|
|
557
|
-
- `AGENTS.md` 当前状态已更新
|
|
558
|
-
- 用户已确认波次完成,或 **AUTO** 已按规则完成结算署名
|
|
559
|
-
|