@haaaiawd/anws 2.2.2 → 2.2.3

package/templates/.agents/workflows/forge.md

@@ -24,17 +24,17 @@
 
 **核心原则**：
 
-- 📖 **文档即合约** — 规范文档是不可违反的权威
-- 🌊 **波次执行** — 每波 2-5 个任务，加载→编码→验证→提交
-- 🛑 **遇疑则停** — 发现问题立即停止，不猜不赶
-- ✍ **签名机制** — 每次波次开始都要经过检查点；普通模式由用户签名，`/forge自动` 模式记为 `AUTO`
+- **文档即合约** — 规范文档是不可违反的权威
+- **波次执行** — 每波 2-5 个任务，加载→编码→验证→提交
+- **遇疑则停** — 发现问题立即停止，不猜不赶
+- **签名机制** — 每次波次开始都要经过检查点；普通模式由用户签名，`/forge自动` 模式记为 `AUTO`
 
 **与用户的关系**：
 你是用户的**忠实执行者**，不是自由发挥的创造者。
 
 ---
 
-## ⚠️ CRITICAL 权限边界
+## CRITICAL 权限边界
 
 > [!IMPORTANT]
 > **`/forge` 的权限严格限定**:
@@ -42,37 +42,37 @@
 >
 > | 能力                          | 允许  | 禁止  |
 > | --------------------------- | --- | --- |
-> | 在 `src/` 下编写业务代码            | ✅   |     |
-> | 编写单元测试                      | ✅   |     |
-> | 更新 `05_TASKS.md` 的 checkbox | ✅   |     |
-> | 运行测试和 lint                  | ✅   |     |
-> | Git commit 已完成的任务           | ✅   |     |
-> | 更新 `AGENTS.md` 当前状态         | ✅   |     |
-> | **修改 `.anws/` 下任何设计文档**     |     | ❌   |
-> | **创建 TASKS.md 中不存在的功能**     |     | ❌   |
-> | **降级或跳过验收标准**               |     | ❌   |
-> | **引入 ADR 未批准的第三方依赖**        |     | ❌   |
-> | **修改已有代码的公共接口（除非任务明确要求）**   |     | ❌   |
-> | **"顺便"优化/重构不在任务范围内的代码**     |     | ❌   |
+> | 在 `src/` 下编写业务代码            | 是 | |
+> | 编写单元测试                      | 是 | |
+> | 更新 `05_TASKS.md` 的 checkbox | 是 | |
+> | 运行测试和 lint                  | 是 | |
+> | Git commit 已完成的任务           | 是 | |
+> | 更新 `AGENTS.md` 当前状态         | 是 | |
+> | **修改 `.anws/` 下任何设计文档**     | | 是 |
+> | **创建 TASKS.md 中不存在的功能**     | | 是 |
+> | **降级或跳过验收标准**               | | 是 |
+> | **引入 ADR 未批准的第三方依赖**        | | 是 |
+> | **修改已有代码的公共接口（除非任务明确要求）**   | | 是 |
+> | **"顺便"优化/重构不在任务范围内的代码**     | | 是 |
 >
 
 ---
 
-## ⚠️ CRITICAL 反自由发挥护栏
+## CRITICAL 反自由发挥护栏
 
 > [!IMPORTANT]
 > **你只实现任务描述和验收标准中明确要求的内容。**
 >
-> - ❌ "我觉得加个缓存会更好" → **禁止**
-> - ❌ "顺便优化了一下这个函数" → **禁止**
-> - ❌ "虽然文档没提到，但加了错误处理" → **禁止**（除非验收标准要求）
-> - ❌ "这个设计不太合理，我自己调整了" → **禁止**
-> - ✅ 严格按任务描述 + 验收标准实现
-> - ✅ 发现任何问题 → 报告用户 → 用户通过相应工作流修改 → 修改后再继续
+> - "我觉得加个缓存会更好" → **禁止**
+> - "顺便优化了一下这个函数" → **禁止**
+> - "虽然文档没提到，但加了错误处理" → **禁止**（除非验收标准要求）
+> - "这个设计不太合理，我自己调整了" → **禁止**
+> - 严格按任务描述 + 验收标准实现
+> - 发现任何问题 → 报告用户 → 用户通过相应工作流修改 → 修改后再继续
 
 ---
 
-## ⚠️ CRITICAL 冲突处理协议
+## CRITICAL 冲突处理协议
 
 > [!IMPORTANT]
 > **以下情况必须立即停止编码，报告用户**:
@@ -80,13 +80,13 @@
 >
 > | 冲突类型                   | 处理方式                                |
 > | ---------------------- | ----------------------------------- |
-> | 文档之间互相矛盾               | 🛑 停止 → 列出矛盾点 → 用户通过 `/change` 修复   |
-> | 任务描述模糊/不完整             | 🛑 停止 → 列出疑问 → 用户确认或通过 `/change` 补充 |
-> | 依赖的前置任务产物与预期不符         | 🛑 停止 → 报告差异 → 用户决定                 |
-> | 发现设计不可实现               | 🛑 停止 → 记录原因 → 建议用户运行 `/challenge`  |
-> | 需要 ADR 未批准的新依赖         | 🛑 停止 → 说明理由 → 用户决定是否创建新 ADR        |
-> | 需要的系统设计文档不存在           | 🛑 停止 → 引导用户运行 `/design-system`     |
-> | **发现未定义但必须新增/修改的公共契约** | 🛑 停止 → 生成回流说明 → 跳转 `/change`       |
+> | 文档之间互相矛盾               |  停止 → 列出矛盾点 → 用户通过 `/change` 修复   |
+> | 任务描述模糊/不完整             |  停止 → 列出疑问 → 用户确认或通过 `/change` 补充 |
+> | 依赖的前置任务产物与预期不符         |  停止 → 报告差异 → 用户决定                 |
+> | 发现设计不可实现               |  停止 → 记录原因 → 建议用户运行 `/challenge`  |
+> | 需要 ADR 未批准的新依赖         |  停止 → 说明理由 → 用户决定是否创建新 ADR        |
+> | 需要的系统设计文档不存在           |  停止 → 引导用户运行 `/design-system`     |
+> | **发现未定义但必须新增/修改的公共契约** |  停止 → 生成回流说明 → 跳转 `/change`       |
 >
 >
 > **核心原则: 宁可停下来问，也不要猜测。**
@@ -107,7 +107,7 @@
   - `{TARGET_DIR}/05_TASKS.md` 存在
 4. **检查推荐文件** (缺失则警告):
   - `{TARGET_DIR}/04_SYSTEM_DESIGN/` 存在且非空
-  - 如缺失: "⚠️ 建议先运行 `/design-system`。缺少详细设计可能导致实现质量下降。"
+  - 如缺失: " 建议先运行 `/design-system`。缺少详细设计可能导致实现质量下降。"
 5. **如果必需文件缺失**: 报错并提示运行 `/genesis` + `/blueprint`。
 6. **Challenge 门禁检查**:
   - 如果 `{TARGET_DIR}/07_CHALLENGE_REPORT.md` 存在，必须先读取最新审查结果
@@ -115,7 +115,7 @@
   - 如存在**未处理 High** → 仅允许用户显式签名放行；AUTO 模式不得自动通过
   - 如无未处理高严重度问题 → 继续
 7. **断点续做判定**:
-  - 读取 `AGENTS.md` 的 `🌊 Wave` 块
+  - 读取 `AGENTS.md` 的 `Wave` 块
     - 如果存在波次信息：
       - 查看波次任务列表，对照 `05_TASKS.md` 中的 checkbox
       - 如有未完成任务 → **断点续做** → 跳入 Step 3 继续未完成的任务
@@ -174,7 +174,7 @@
 向用户展示：
 
 ```markdown
-## 📋 Wave {N} 建议
+## Wave {N} 建议
 
 | 任务 ID  | 标题 | 依赖文档                        | 估时  |
 | -------- | ---- | ------------------------------- | :---: |
@@ -187,10 +187,10 @@
 确认此波次？或调整任务组合？
 ```
 
-**签名检查点** ⚠️: 获得签名后，将确认的波次写入 `AGENTS.md` 的 `🌊 Wave` 块：
+**签名检查点** : 获得签名后，将确认的波次写入 `AGENTS.md` 的 `Wave` 块：
 
 ```markdown
-### 🌊 Wave {N} — {波次目标简述}
+### Wave {N} — {波次目标简述}
 T{X.Y.Z}, T{X.Y.Z}, T{X.Y.Z}
 ```
 
@@ -290,7 +290,7 @@ T{X.Y.Z}, T{X.Y.Z}, T{X.Y.Z}
 3. "验收标准里最关键的约束是什么？"
 4. "有没有歧义的地方？有没有不确定的点？"
 
-- 如发现歧义或不确定 → 🛑 **触发冲突处理协议**，停止并报告用户
+- 如发现歧义或不确定 →  **触发冲突处理协议**，停止并报告用户
 - 如无问题 → 继续 3.3
 
 ---
@@ -329,31 +329,31 @@ T{X.Y.Z}, T{X.Y.Z}, T{X.Y.Z}
 >
 > | 验证类型       | 验证方式                     | 证据要求                      | 标记  |
 > | ---------- | ------------------------ | ------------------------- | --- |
-> | **单元测试**   | 运行 `npm test` 或等效命令      | 终端输出：`X passed, 0 failed` | ✅/❌ |
-> | **集成测试**   | 运行集成测试脚本                 | 终端输出或日志                   | ✅/❌ |
-> | **E2E测试**  | 运行 E2E 测试脚本              | 测试报告或截图                   | ✅/❌ |
-> | **冒烟测试**   | 运行最小真实路径检查               | 关键路径日志、截图或终端输出            | ✅/❌ |
-> | **回归测试**   | 运行受影响能力的最小回归测试集          | 明确列出复验范围 + 测试输出           | ✅/❌ |
-> | **编译检查**   | 运行 `npm run build` 或等效命令 | 终端输出：`Build succeeded`    | ✅/❌ |
-> | **Lint检查** | 运行 `npm run lint` 或等效命令  | 终端输出：`0 problems`         | ✅/❌ |
-> | **手动验证**   | 人工检查                     | 用户确认                      | ⏳   |
+> | **单元测试**   | 运行 `npm test` 或等效命令      | 终端输出：`X passed, 0 failed` | 通过/未通过 |
+> | **集成测试**   | 运行集成测试脚本                 | 终端输出或日志                   | 通过/未通过 |
+> | **E2E测试**  | 运行 E2E 测试脚本              | 测试报告或截图                   | 通过/未通过 |
+> | **冒烟测试**   | 运行最小真实路径检查               | 关键路径日志、截图或终端输出            | 通过/未通过 |
+> | **回归测试**   | 运行受影响能力的最小回归测试集          | 明确列出复验范围 + 测试输出           | 通过/未通过 |
+> | **编译检查**   | 运行 `npm run build` 或等效命令 | 终端输出：`Build succeeded`    | 通过/未通过 |
+> | **Lint检查** | 运行 `npm run lint` 或等效命令  | 终端输出：`0 problems`         | 通过/未通过 |
+> | **手动验证**   | 人工检查                     | 用户确认                      | 待确认 |
 >
 
 ```markdown
-### ✅ 验证报告: T{X.Y.Z}
+### 验证报告: T{X.Y.Z}
 
 **验证类型**: [单元测试 | 集成测试 | E2E测试 | 冒烟测试 | 回归测试 | 编译检查 | Lint检查 | 手动验证]
 
 **自动验证** (单元测试/集成测试/E2E/冒烟/回归/编译/Lint)：
 | 验收标准 | 命令 | 输出摘要 | 状态 |
 | -------- | ---- | -------- | :--: |
-| 测试通过 | `npm test` | 12 passed, 0 failed | ✅ |
-| 构建成功 | `npm run build` | Build succeeded | ✅ |
+| 测试通过 | `npm test` | 12 passed, 0 failed | 通过/未通过 |
+| 构建成功 | `npm run build` | Build succeeded | 通过/未通过 |
 
 **手动验证**：
 | 验收标准 | 说明 | 状态 |
 | -------- | ---- | :--: |
-| 页面显示正确 | 需要打开浏览器确认渲染效果 | ⏳ |
+| 页面显示正确 | 需要打开浏览器确认渲染效果 | 待确认 |
 ```
 
 按任务的 `**验证类型**` 和 `**验证说明**` 字段执行检查。
@@ -365,8 +365,8 @@ T{X.Y.Z}, T{X.Y.Z}, T{X.Y.Z}
 > - 回归测试必须显式写出本次复验覆盖了哪些既有能力，避免泛化成“随便跑点测试”
 > - 若任务声明了冒烟测试或回归测试，但 `验证说明` 无法指导执行，应视为验证定义不完整，先修任务定义或回流 `/change`
 
-- 自动验证类型有 ❌ → **修复后重新验证**，不得跳过
-- 自动验证类型全部 ✅ → 按下方 **「3.4.5 / 3.4.6 频控」** 决定是否在本任务执行 **3.4.5 / 3.4.6**，然后进入 **3.5 → 3.6**。跳过或顺延须在任务备注 / Wave 记录中写明依据（与对应 **skill** 的跳过协议一致）。
+- 若任一自动验证类型未通过 → **修复后重新验证**，不得跳过
+- 若全部自动验证类型通过 → 按下方 **「3.4.5 / 3.4.6 频控」** 决定是否在本任务执行 **3.4.5 / 3.4.6**，然后进入 **3.5 → 3.6**。跳过或顺延须在任务备注 / Wave 记录中写明依据（与对应 **skill** 的跳过协议一致）。
 
 ### 3.4.5 / 3.4.6 频控（默认）
 
@@ -404,6 +404,8 @@ T{X.Y.Z}, T{X.Y.Z}, T{X.Y.Z}
 
 完整遵从 `**e2e-testing-guide`** skill（触发条件、guide-only、证据规则均以 skill 为准）。
 
+验证以**用户旅程**为主线：步骤、断言、证据与 `PASS` / `FAIL` / `BLOCKED` / `NOT RUN` 状态规则均以 skill 为准。
+
 若宿主具备浏览器自动化：**先 Guide、后实机（用户授权）**；无工具则 guide-only，不得冒充已测。
 
 未触发 → `E2E guide skipped` + 一行原因 → **3.5**。
@@ -417,17 +419,17 @@ T{X.Y.Z}, T{X.Y.Z}, T{X.Y.Z}
 
 | #   | 检查项                       | 通过？ |
 | --- | ------------------------- | --- |
-| 1   | 代码接口与 SYSTEM_DESIGN 定义一致？ | ✅/❌ |
-| 2   | 未引入 ADR 未批准的依赖？           | ✅/❌ |
-| 3   | 未添加任务范围外的功能？              | ✅/❌ |
-| 4   | 代码风格与项目一致，lint 通过？        | ✅/❌ |
-| 5   | 所有验收标准已验证通过？              | ✅/❌ |
-| 6   | 所有可执行验收标准有足够证据（终端/日志/截图）？ | ✅/❌ |
-| 7   | 需人工确认的验收标准已标记 ⏳？          | ✅/❌ |
+| 1   | 代码接口与 SYSTEM_DESIGN 定义一致？ | 是/否 |
+| 2   | 未引入 ADR 未批准的依赖？           | 是/否 |
+| 3   | 未添加任务范围外的功能？              | 是/否 |
+| 4   | 代码风格与项目一致，lint 通过？        | 是/否 |
+| 5   | 所有验收标准已验证通过？              | 是/否 |
+| 6   | 所有可执行验收标准有足够证据（终端/日志/截图）？ | 是/否 |
+| 7   | 需人工确认的验收标准已标记 ？          | 是/否 |
 
 
-- 全部 ✅ → 继续 3.6
-- 有 ❌ → **修复**
+- 若检查清单全部通过 → 继续 3.6
+- 若任一项未通过 → **修复**
 
 ---
 
@@ -464,10 +466,10 @@ T{X.Y.Z}, T{X.Y.Z}, T{X.Y.Z}
 
 **更新 `AGENTS.md`**：
 
-1. 更新 `🌊 Wave` 块为下一波的初始状态（如果已知下一波任务），或标记当前波已完成：
+1. 更新 `Wave` 块为下一波的初始状态（如果已知下一波任务），或标记当前波已完成：
 
 ```markdown
-### 🌊 Wave {N} ✅ — {波次目标简述}
+### Wave {N}  — {波次目标简述}
 T{X.Y.Z}, T{X.Y.Z}, T{X.Y.Z}
 ```
 
@@ -478,7 +480,7 @@ T{X.Y.Z}, T{X.Y.Z}, T{X.Y.Z}
 向用户简要汇报：
 
 ```markdown
-## 🌊 Wave {N} 完成
+## Wave {N} 完成
 
 **已完成**: T{X.Y.Z}, T{X.Y.Z}, ...
 **验证状态**: 全部通过 / 部分通过
@@ -498,7 +500,7 @@ chore(wave): settle wave {N} progress
 
 ### 4.4 下一步判定
 
-**签名检查点** ⚠️：
+**签名检查点** ：
 
 - 还有未完成任务 → 询问："继续下一波？"；普通模式等待用户签名，AUTO 模式以 `AUTO` 签名继续 → 回到 **Step 1**
 - 当前 Sprint 所有任务完成 → 进入 **Step 5**
@@ -535,12 +537,12 @@ chore(wave): settle wave {N} progress
 
 ---
 
-- ✅ 每个任务的验收标准全部通过
-- ✅ 每个任务的遵从性检查全部通过
-- ✅ **3.4.5**：按 Wave 末次任务 / 约 2～3 Wave 兜底 / skill 例外执行 `code-reviewer`，或在任务与 Wave 记录中写明跳过或顺延依据
-- ✅ **3.4.6**：按 `e2e-testing-guide` 触发；有浏览器工具则先 Guide 后实机；否则 guide-only；未触发则写明原因
-- ✅ 所有代码已 git commit，message 包含 Task ID
-- ✅ 所有任务已完成持久化（`05_TASKS.md`）
-- ✅ `AGENTS.md` 当前状态已更新
-- ✅ 用户已确认波次完成
+- 每个任务的验收标准全部通过
+- 每个任务的遵从性检查全部通过
+- **3.4.5**：按 Wave 末次任务 / 约 2～3 Wave 兜底 / skill 例外执行 `code-reviewer`，或在任务与 Wave 记录中写明跳过或顺延依据
+- **3.4.6**：按 `e2e-testing-guide` 触发；有浏览器工具则先 Guide 后实机；否则 guide-only；未触发则写明原因
+- 所有代码已 git commit，message 包含 Task ID
+- 所有任务已完成持久化（`05_TASKS.md`）
+- `AGENTS.md` 当前状态已更新
+- 用户已确认波次完成