@haaaiawd/anws 1.0.1 → 1.1.0

package/lib/init.js

@@ -2,6 +2,7 @@
 
 const fs = require('node:fs/promises');
 const path = require('node:path');
+const crypto = require('node:crypto');
 const { copyDir } = require('./copy');
 const { MANAGED_FILES, USER_PROTECTED_FILES } = require('./manifest');
 const { success, warn, info, fileLine, skippedLine, blank, logo } = require('./output');
@@ -25,6 +26,7 @@ async function init() {
     }
     // 仅覆盖托管文件（用户自有文件不受影响）
     const { written: updated, skipped } = await overwriteManaged(srcRoot, cwd);
+    await storeAgentsTemplateHash(srcRoot, cwd);
     printSummary(updated, skipped, 'updated');
     return;
   }
@@ -36,6 +38,9 @@ async function init() {
 
   const written = await copyDir(srcRoot, destRoot);
 
+  // 存储 agents.md 模板指纹，供后续 update 检测模板变化
+  await storeAgentsTemplateHash(srcRoot, cwd);
+
   // 打印文件列表
   for (const absPath of written) {
     const rel = path.relative(cwd, absPath).replace(/\\/g, '/');
@@ -159,4 +164,23 @@ function printNextSteps() {
   info('  2. Run /genesis in your AI assistant to start a new project');
 }
 
+/**
+ * 存储 agents.md 模板的 MD5 指纹。
+ * 供 `anws update` 检测模板是否在版本间发生了变化。
+ * @param {string} srcRoot  模板 .agent/ 目录绝对路径
+ * @param {string} cwd      项目根目录
+ */
+async function storeAgentsTemplateHash(srcRoot, cwd) {
+  const templatePath = path.join(srcRoot, 'rules', 'agents.md');
+  const hashPath = path.join(cwd, '.agent', 'rules', '.agents-template-hash');
+
+  try {
+    const content = await fs.readFile(templatePath, 'utf-8');
+    const hash = crypto.createHash('md5').update(content).digest('hex');
+    await fs.writeFile(hashPath, hash, 'utf-8');
+  } catch {
+    // 模板文件不存在时静默失败（不应该发生）
+  }
+}
+
 module.exports = init;

package/lib/update.js

@@ -2,6 +2,7 @@
 
 const fs = require('node:fs/promises');
 const path = require('node:path');
+const crypto = require('node:crypto');
 const { MANAGED_FILES, USER_PROTECTED_FILES } = require('./manifest');
 const { success, warn, error, info, fileLine, skippedLine, blank, logo } = require('./output');
 
@@ -66,10 +67,24 @@ async function update() {
       skippedLine(rel.replace(/\\/g, '/'));
     }
   }
+
+  // 检查 agents.md 模板是否有变更，提供 .new 文件供用户合并
+  const agentsMerged = await checkAgentsTemplate(cwd, srcRoot);
+
   blank();
   success(`Done! ${updated.length} file(s) updated${skipped.length > 0 ? `, ${skipped.length} skipped` : ''}.`);
   info('Managed files have been updated to the latest version.');
   info('Your custom files in .agent/ were not touched.');
+
+  if (agentsMerged) {
+    blank();
+    warn('agents.md template has changed!');
+    info('A new template has been saved to:');
+    info('  .agent/rules/agents.md.new');
+    blank();
+    info('Please review and merge the changes into your agents.md.');
+    info('After merging, delete agents.md.new.');
+  }
 }
 
 /**
@@ -95,4 +110,44 @@ async function askUpdate() {
   });
 }
 
+/**
+ * 检查 agents.md 模板是否相比上次安装/更新有变化。
+ * 用 hash 文件记录上次模板指纹，与新模板比较。
+ * 如果有变化 → 写入 agents.md.new + 更新 hash。
+ *
+ * @param {string} cwd       项目根目录
+ * @param {string} srcRoot   模板 .agent/ 目录
+ * @returns {Promise<boolean>} 是否产生了 .new 文件
+ */
+async function checkAgentsTemplate(cwd, srcRoot) {
+  const templatePath = path.join(path.dirname(srcRoot), '.agent', 'rules', 'agents.md');
+  const hashPath = path.join(cwd, '.agent', 'rules', '.agents-template-hash');
+  const newPath = path.join(cwd, '.agent', 'rules', 'agents.md.new');
+
+  const templateExists = await fs.access(templatePath).then(() => true).catch(() => false);
+  if (!templateExists) return false;
+
+  const templateContent = await fs.readFile(templatePath, 'utf-8');
+  const newHash = crypto.createHash('md5').update(templateContent).digest('hex');
+
+  // 读取上次存储的 hash
+  let oldHash = null;
+  try {
+    oldHash = (await fs.readFile(hashPath, 'utf-8')).trim();
+  } catch {
+    // hash 文件不存在（首次 update 或旧版本安装）
+  }
+
+  if (oldHash === newHash) {
+    return false; // 模板没变化
+  }
+
+  // 模板有变化 → 写入 .new 供用户合并
+  await fs.writeFile(newPath, templateContent, 'utf-8');
+  // 更新 hash 记录
+  await fs.writeFile(hashPath, newHash, 'utf-8');
+
+  return true;
+}
+
 module.exports = update;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haaaiawd/anws",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Antigravity Workflow System CLI — one command to install AI collaboration workflows into your project",
   "keywords": [
     "ai",

package/templates/.agent/rules/agents.md

@@ -34,13 +34,16 @@
 
 ## 📍 当前状态 (由 Workflow 自动更新)
 
-> **注意**: 此部分由 `/genesis` 和 `/blueprint` 自动维护。
+> **注意**: 此部分由 `/genesis`、`/blueprint` 和 `/forge` 自动维护。
 
 - **最新架构版本**: `尚未初始化`
 - **活动任务清单**: `尚未生成`
 - **待办任务数**: -
 - **最近一次更新**: `-`
 
+### 🌊 Wave 1 — 待 /blueprint 或 /forge 设置
+_尚未开始执行_
+
 ---
 
 ## 🌳 项目结构 (Project Tree)
@@ -69,11 +72,11 @@
 | `/genesis` | 新项目 / 重大重构 | PRD, Architecture, ADRs |
 | `/scout` | 变更前 / 接手项目 | `genesis/v{N}/00_SCOUT_REPORT.md` |
 | `/design-system` | genesis 后 | 04_SYSTEM_DESIGN/*.md |
-| `/blueprint` | genesis 后 | 05_TASKS.md |
-| `/forge` | blueprint 后 | 实际代码实现 |
+| `/blueprint` | genesis 后 | 05_TASKS.md + agents.md 初始 Wave |
 | `/change` | 微调已有任务 | 更新 TASKS + SYSTEM_DESIGN (仅修改) + CHANGELOG |
 | `/explore` | 调研时 | 探索报告 |
-| `/challenge` | 决策前质疑 | 07_CHALLENGE_REPORT.md |
+| `/challenge` | 决策前质疑 | 07_CHALLENGE_REPORT.md (含问题总览目录) |
+| `/forge` | 编码执行 | 代码 + 更新 agents.md Wave 块 |
 | `/craft` | 创建工作流/技能/提示词 | Workflow / Skill / Prompt 文档 |
 
 ---
@@ -87,4 +90,4 @@
 
 ---
 
-> **状态自检**: 准备好了？运行 `/genesis` 开始你的第一个项目设计吧。
+> **状态自检**: 准备好了？运行 `/genesis` 开始你的第一个项目设计吧。

package/templates/.agent/skills/task-planner/SKILL.md

@@ -101,7 +101,7 @@ description: 使用WBS方法将系统设计文档分解为层次化任务。支
 - [ ] **T1.1.1** [基础]: 设置 Vite + React 项目
   - **描述**: 初始化前端项目，配置Vite、React、TypeScript
   - **输入**: PRD (React技术栈要求)
-  - **输出**: 可运行的Hello World应用
+  - **输出**: 可运行的Hello World应用 (`src/App.tsx`, `vite.config.ts`)
   - **验收标准**: 
     - [ ] `npm run dev` 正常启动
     - [ ] 页面显示"Hello World"
@@ -111,6 +111,16 @@ description: 使用WBS方法将系统设计文档分解为层次化任务。支
   - **优先级**: P0
 ```
 
+### 接口追溯规则
+
+> [!IMPORTANT]
+> **任务间的输入/输出必须对齐。**
+>
+> 如果任务 B 依赖任务 A，则 B 的「输入」必须明确引用 A 的「输出」的具体产物（文件路径、接口名、数据格式）。
+>
+> - ✅ 好: B 输入 = “T1.1.1 产出的 `App.tsx` 组件 + `vite.config.ts` 配置”
+> - ❌ 差: B 输入 = “前端项目”
+
 ---
 
 ## 📋 任务元数据完整性
@@ -338,6 +348,50 @@ graph TD
 
 ---
 
+## 🎯 Sprint 退出标准与集成验证任务
+
+### Sprint 退出标准
+
+> [!IMPORTANT]
+> **每个 Sprint/里程碑必须有明确的退出标准。**
+>
+> 退出标准定义"什么算做完"，它不是模糊的"任务都打勾了"，而是**可演示、可验证的具体状态**。
+
+**Sprint 路线图格式**:
+```markdown
+| Sprint | 代号 | 核心任务 | 退出标准 | 预估 |
+|--------|------|---------|---------|------|
+| S1 | Hello World | 基础设施+数据 | headless 运行 2 国 5 回合 + 基本渲染可见 | 3-4d |
+| S2 | 功能成型 | 实体+交互 | 完整功能可演示 + HUD 显示资源 | 5-6d |
+```
+
+**退出标准要求**:
+- 必须是可客观验证的（可截图/录屏/日志证明）
+- 必须涵盖跨系统集成（而非单个组件）
+- 描述用户/开发者能观察到的行为，而非内部实现细节
+
+### 集成验证任务 (INT Task)
+
+每个 Sprint 末尾生成一个 **INT-S{N}** 任务，专门验证退出标准：
+
+```markdown
+- [ ] **INT-S{N}** [MILESTONE]: S{N} 集成验证 — {代号}
+  - **描述**: 验证 S{N} 退出标准
+  - **输入**: S{N} 所有任务的产出
+  - **输出**: 集成验证报告（通过/失败 + Bug 清单）
+  - **验收标准**:
+    - Given S{N} 所有任务已完成
+    - When 逐条执行退出标准中的检查
+    - Then 全部通过 → Sprint 完成; 有失败 → 记录 Bug
+  - **验证说明**: 按退出标准逐条执行，截图/录屏/日志确认
+  - **估时**: 2-4h
+  - **依赖**: S{N} 最后一个任务
+```
+
+INT 任务是该 Sprint 的"关门任务"。**未通过 INT 任务的 Sprint 不得标记为完成。**
+
+---
+
 ## 💡 常见场景与模式
 
 ### 场景1: 新功能开发

package/templates/.agent/skills/task-planner/references/TASK_TEMPLATE.md

@@ -50,21 +50,32 @@
 
 ---
 
+## 📊 Sprint 路线图
+
+| Sprint | 代号 | 核心任务 | 退出标准 | 预估 |
+|--------|------|---------|---------|------|
+| S1 | Foundation | T001-T002 | DB 可连接 + 环境变量生效 | 1d |
+| S2 | Core Logic | T003-T005 | 完整认证流程可运行 | 2d |
+
+---
+
 ### Phase 3: Integration
 
 #### T005 - Login Endpoint
 - **User Story**: US01
 - **Description**: Implement `POST /api/login` that validates credentials and returns JWT.
 - **Dependencies**: T003 (User table populated), T004 (JWT generator ready)
+- **Input**: T003 产出的 `users` 表 + T004 产出的 `generate_token()` 函数
+- **Output**: `/api/login` 端点 (`src/routes/auth.js`)
 - **Done When**: 
   1. Valid login returns `{token: "..."}`.
   2. Invalid login returns 401.
 
-#### T005-CHK - [Verification] Verify US01 - User Authentication
+#### INT-S2 - [MILESTONE] S2 集成验证 — Core Logic
 - **User Story**: US01
-- **Type**: Checkpoint (Story Milestone)
-- **Description**: Validate entire authentication flow works end-to-end.
-- **Dependencies**: All US01 tasks (T001-T005)
+- **Type**: Integration Verification (Sprint Gate)
+- **Description**: 验证 S2 退出标准：完整认证流程可运行
+- **Dependencies**: All S2 tasks (T003-T005)
 - **Done When**:
   1. Run `npm run dev` or equivalent
   2. Register a new user via `/api/register`

package/templates/.agent/workflows/blueprint.md

@@ -75,8 +75,8 @@ description: 将架构设计拆解为可执行的 WBS 任务清单，每个任
 ```markdown
 - [ ] **T{X}.{Y}.{Z}** [REQ-XXX]: 任务标题
   - **描述**: 具体要做什么
-  - **输入**: 依赖的文件/接口
-  - **输出**: 产出的文件/组件
+  - **输入**: 依赖的文件/接口（如依赖前置任务，必须引用其具体输出产物）
+  - **输出**: 产出的文件/组件/接口
   - **验收标准**: 
     - Given [前置条件]
     - When [执行动作]
@@ -86,6 +86,16 @@ description: 将架构设计拆解为可执行的 WBS 任务清单，每个任
   - **依赖**: T{A}.{B}.{C} (如有)
 ```
 
+### 接口追溯规则
+
+> [!IMPORTANT]
+> **任务间的输入/输出必须对齐。**
+>
+> 如果任务 B 依赖任务 A，则 B 的「输入」必须明确引用 A 的「输出」的具体产物（文件路径、接口名、数据格式）。
+>
+> - ✅ 好: B 输入 = “T2.1.2 产出的 `MapGenerator` 类（`src/core/map_gen.py`）的 `generate()` 方法返回的 `World` 对象”
+> - ❌ 差: B 输入 = “地图数据”
+
 ### 验证说明格式指南
 
 > [!IMPORTANT]
@@ -106,7 +116,50 @@ description: 将架构设计拆解为可执行的 WBS 任务清单，每个任
 
 ---
 
-## Step 3: 依赖分析 (Dependency Analysis)
+## Step 3: Sprint 路线图与退出标准 (Sprint Roadmap)
+
+**目标**: 将任务分组为 Sprint/里程碑，每个 Sprint 必须有明确的退出标准和集成验证任务。
+
+> [!IMPORTANT]
+> **每个 Sprint 必须有退出标准和集成验证任务。**
+>
+> Sprint 不只是“一堆任务”，而是一个有明确入口和出口的工作单元。
+> 退出标准定义“什么算做完”，集成验证任务负责“证明做完”。
+
+### Sprint 路线图格式
+
+```markdown
+## 📊 Sprint 路线图
+
+| Sprint | 代号 | 核心任务 | 退出标准 | 预估 |
+|--------|------|---------|---------|------|
+| S1 | Hello World | 基础设施+核心数据 | headless 运行通过 + 基本渲染可见 | 3-4d |
+| S2 | 功能成型 | 实体+交互 | 完整功能可演示 + HUD 正常 | 5-6d |
+```
+
+### 集成验证任务 (INT Task)
+
+每个 Sprint 末尾必须生成一个 **INT-S{N}** 集成验证任务，专门负责验证该 Sprint 的退出标准：
+
+```markdown
+- [ ] **INT-S{N}** [MILESTONE]: S{N} 集成验证 — {代号}
+  - **描述**: 验证 S{N} 退出标准，确认所有跨系统功能正常协作
+  - **输入**: S{N} 所有任务的产出
+  - **输出**: 集成验证报告（通过/失败 + Bug 清单）
+  - **验收标准**:
+    - Given S{N} 所有任务已完成
+    - When 执行退出标准中的每一项检查
+    - Then 全部通过 → Sprint 完成; 有失败 → 记录 Bug 并触发修复波次
+  - **验证说明**: 按土出标准逐条执行，截图/录屏/日志确认
+  - **估时**: 2-4h
+  - **依赖**: S{N} 所有任务
+```
+
+> INT 任务是该 Sprint 的“关门任务”。未通过 INT 任务的 Sprint 不得标记为完成。
+
+---
+
+## Step 4: 依赖分析 (Dependency Analysis)
 
 **目标**: 生成 Mermaid 依赖图。
 
@@ -121,7 +174,7 @@ graph TD
 
 ---
 
-## Step 4: 复杂度审计
+## Step 5: 复杂度审计
 
 调用 `complexity-guard` 确保:
 - 单个任务 ≤ 8 小时
@@ -130,7 +183,7 @@ graph TD
 
 ---
 
-## Step 5: 生成文档
+## Step 6: 生成文档
 
 **目标**: 保存最终的任务清单，并**更新 AGENTS.md**。
 
@@ -140,20 +193,26 @@ graph TD
 2.  **验证**: 确保文件包含所有任务、验收标准和依赖图。
 3.  **更新 .agent/rules/agents.md "当前状态"**:
     - 活动任务清单: `genesis/v{N}/05_TASKS.md`
-    - 待办任务数: `{X}` (计算 total tasks)
     - 最近一次更新: `{Today}`
+    - 写入初始波次建议，让 `/forge` 可以直接启动：
+    ```markdown
+    ### 🌊 Wave 1 — {S1 的第一批任务目标}
+    T{X.Y.Z}, T{X.Y.Z}, T{X.Y.Z}
+    ```
 
 ---
 
 ## 检查清单
+- ✅ 每个 Sprint 有退出标准和 INT 集成验证任务？
 - ✅ 05_TASKS.md 是否包含所有 WBS 任务？
 - ✅ 每个任务是否有 Context 和 Acceptance Criteria？
+- ✅ 任务间的输入/输出是否对齐（接口追溯）？
 - ✅ 是否生成了 Mermaid 依赖图？
-- ✅ 已更新 .agent/rules/agents.md？
+- ✅ 已更新 .agent/rules/agents.md（含初始波次建议）？
 
 ---
 
-## Step 6: 最终确认
+## Step 7: 最终确认
 
 **展示统计**:
 ```markdown
@@ -179,7 +238,9 @@ graph TD
 - ✅ 定位到最新架构版本 `v{N}`
 - ✅ 任务清单 `05_TASKS.md` 已生成
 - ✅ 每个 Level 3 任务包含验证说明
+- ✅ 任务间输入/输出已对齐（接口追溯）
+- ✅ 每个 Sprint 有退出标准和 INT 集成验证任务
 - ✅ 生成了 Mermaid 依赖图
-- ✅ 已更新 .agent/rules/agents.md
+- ✅ 已更新 .agent/rules/agents.md（含初始波次建议）
 - ✅ 用户已确认
 </completion_criteria>

package/templates/.agent/workflows/challenge.md

@@ -320,8 +320,21 @@ description: 对项目决策进行系统性挑战，通过三维度审查框架
 
 > **审查日期**: {YYYY-MM-DD}  
 > **审查范围**: {TARGET_DIR} 全部设计文档  
-> **审查者**: AI Challenger  
-> **总计发现**: X 项问题
+> **累计轮次**: {N}
+
+---
+
+## 📋 问题总览
+
+> 此目录随每轮审查同步维护。已解决的轮次仅保留此摘要行，详细内容在确认修复后删除。
+
+### 第一轮（{日期}，{X}/{Y} 已修复）
+
+| ID | 严重度 | 摘要 | 状态 |
+|----|--------|------|------|
+| C1-CX | 🔴 | [同级别问题的精简一行摘要] | ✅ 全部修复 / ⏳ 待修复 |
+| H1-HX | 🟠 | [同级别问题的精简一行摘要] | ✅ 全部修复 / ⏳ 待修复 |
+| M1-MX | 🟡 | [同级别问题的精简一行摘要] | ✅ 全部修复 / ⏳ 实现时处理 |
 
 ---
 
@@ -333,15 +346,11 @@ description: 对项目决策进行系统性挑战，通过三维度审查框架
 2. **运行模拟维度** - 时序正确性、状态同步、边界条件
 3. **工程实现维度** - 可测试性、可维护性、性能、安全
 
-每个问题按以下结构描述:
-- **严重度**: Critical / High / Medium / Low
-- **问题描述**: 具体不足
-- **影响**: 对系统的影响
-- **建议**: 解决方案
-
 ---
 
-## 📊 问题统计
+## 🔥 第{N}轮详细审查（当前活跃）
+
+### 📊 本轮问题统计
 
 | 严重度 | 数量 | 占比 |
 |--------|------|------|
@@ -359,9 +368,7 @@ description: 对项目决策进行系统性挑战，通过三维度审查框架
 
 ---
 
-# 第一部分: 系统设计问题
-
-## 🔴 Critical 级别
+# 🔴 Critical 级别
 
 ### C1. [问题标题]
 
@@ -387,45 +394,22 @@ description: 对项目决策进行系统性挑战，通过三维度审查框架
 
 ---
 
-# 第二部分: 运行模拟问题
-
-## 🔴 Critical 级别
+## 🟡 Medium / 🟢 Low 级别
 
 ...
 
 ---
 
-# 第三部分: 工程实现问题
-
-...
-
----
-
-# 总结与建议
-
-## 🎯 核心发现
-
-**Critical 问题**: [总结最严重的问题]
-
-**High 问题**: [总结高风险问题]
-
-**系统性风险**: [是否存在系统性的设计缺陷]
-
----
-
 ## 📋 建议行动清单
 
 ### P0 - 立即处理 (阻塞)
 1. [C级问题] - [建议方案]
-2. ...
 
 ### P1 - 近期处理 (重要)
 1. [H级问题] - [建议方案]
-2. ...
 
 ### P2 - 持续改进 (优化)
 1. [M/L级问题] - [建议方案]
-2. ...
 
 ---
 
@@ -456,12 +440,47 @@ description: 对项目决策进行系统性挑战，通过三维度审查框架
 
 ---
 
+## Step 6: 轮次归档协议 (Round Archive Protocol)
+
+**目标**: 保持报告精简，已解决的轮次只保留摘要。
+
+> [!IMPORTANT]
+> **此步骤在每轮新审查开始时自动执行，不需要单独触发。**
+
+### 归档规则
+
+1.  **新轮审查开始时**，检查上一轮的所有问题是否已解决（由用户确认修复）
+2.  **如已解决** →
+    - 在 `📋 问题总览` 中将该轮的状态全部标为 ✅
+    - **删除该轮的详细审查章节**（`## 🔥 第{N-1}轮详细审查`）
+    - 问题总览中的摘要行即为该轮的永久存档
+3.  **如部分解决** →
+    - 已解决的问题在总览中标 ✅
+    - 未解决的问题保留 ⏳ 并在新轮中继续跟踪
+    - 上一轮详情中仅保留未解决问题的描述
+4.  **报告中同一时刻只有一轮详细内容**（当前活跃轮）
+
+### 总览行合并规则
+
+同严重度的已解决问题合并为一行，格式：
+```markdown
+| C1-C4 | 🔴 | 条约矛盾/毁约逻辑/升级公式/领地缺失 | ✅ 全部修复 |
+```
+
+未解决问题保持独立行，格式：
+```markdown
+| R2-C1 | 🔴 | executor v2 动作缺失 | ⏳ 待修复 |
+```
+
+---
+
 <completion_criteria>
 - ✅ 深度阅读了项目设计文档
 - ✅ Pre-Mortem 分析有逻辑依据
 - ✅ 每个质疑点都有证据支撑
 - ✅ 技术健壮性审计已完成
 - ✅ Top 3 假设已尝试验证
-- ✅ 质疑报告格式完整
+- ✅ 质疑报告格式完整（含问题总览目录）
+- ✅ 上一轮已解决问题的详情已归档（仅保留总览行）
 - ✅ 用户已阅读并决定下一步
 </completion_criteria>

package/templates/.agent/workflows/forge.md

@@ -108,9 +108,12 @@ description: 按照架构文档和任务清单将设计锻造为代码，通过
 5. **如果必需文件缺失**: 报错并提示运行 `/genesis` + `/blueprint`。
 
 6. **断点续做判定**:
-   - 读取 `.agent/rules/agents.md` 的 "当前状态"
-   - 如果存在 "当前波次" 信息 → **断点续做** → 跳入 Step 3 继续未完成的波次
-   - 如果没有 → **新开始** → 继续 Step 1
+   - 读取 `.agent/rules/agents.md` 的 `🌊 Wave` 块
+   - 如果存在波次信息：
+     - 查看波次任务列表，对照 `05_TASKS.md` 中的 checkbox
+     - 如有未完成任务 → **断点续做** → 跳入 Step 3 继续未完成的任务
+     - 如全部完成 → **新波次** → 继续 Step 1
+   - 如果不存在 → **新开始** → 继续 Step 1
 
 ---
 
@@ -157,7 +160,14 @@ description: 按照架构文档和任务清单将设计锻造为代码，通过
 确认此波次？或调整任务组合？
 ```
 
-**人类检查点** ⚠️: 用户确认后才进入 Step 2。
+**人类检查点** ⚠️: 用户确认后，将确认的波次写入 `.agent/rules/agents.md` 的 `🌊 Wave` 块：
+
+```markdown
+### 🌊 Wave {N} — {波次目标简述}
+T{X.Y.Z}, T{X.Y.Z}, T{X.Y.Z}
+```
+
+然后进入 Step 2。
 
 ---
 
@@ -293,15 +303,14 @@ description: 按照架构文档和任务清单将设计锻造为代码，通过
 
 ### 4.1 更新状态
 
-**更新 `.agent/rules/agents.md` "当前状态"**:
+**更新 `.agent/rules/agents.md`**:
+
+1. 更新 `🌊 Wave` 块为下一波的初始状态（如果已知下一波任务），或标记当前波已完成：
 ```markdown
-- **最新架构版本**: `genesis/v{N}`
-- **活动任务清单**: `genesis/v{N}/05_TASKS.md`
-- **当前波次**: Wave {N} ✅ 已完成
-- **已完成任务**: T{...}, T{...}, ...
-- **待办任务数**: {剩余数}
-- **最近一次更新**: {YYYY-MM-DD}
+### 🌊 Wave {N} ✅ — {波次目标简述}
+T{X.Y.Z}, T{X.Y.Z}, T{X.Y.Z}
 ```
+2. 更新 `最近一次更新` 日期
 
 ### 4.2 波次回顾