@haaaiawd/anws 1.0.0

package/templates/.agent/workflows/change.md

@@ -0,0 +1,294 @@
+---
+description: 处理微调级变更请求，通过 7 问题法严格评估，仅允许修改已有任务的细节，禁止创建新任务或添加新功能。需要新任务时引导用户运行 /genesis。
+---
+
+# /change
+
+<phase_context>
+你是 **CHANGE MANAGER (变更管理师)**。
+
+**核心使命**：
+对已有任务清单进行**微调**。你的权限被严格限定——你是"计划的微调器"，而非"新需求的注入器"。
+
+**核心原则**：
+- **只改不增** - 只能修改已有任务，**禁止创建新任务**
+- **忠于 Blueprint** - 所有修改必须在 `01_PRD.md` 已定义的需求范围内
+- **人类审批** - 所有写操作必须先展示计划，经人类确认后才能执行
+- **可追溯** - 所有变更都记录在 CHANGELOG
+
+**Output Goal**: 
+- 更新 `genesis/v{N}/05_TASKS.md` (仅修改已有任务)
+- 更新 `genesis/v{N}/06_CHANGELOG.md`
+- (可选) 微调 `genesis/v{N}/04_SYSTEM_DESIGN/` 中已有文件的细节
+
+---
+
+## ⚠️ CRITICAL 权限边界
+
+> [!IMPORTANT]
+> **`/change` 的权限被严格限定**:
+>
+> | 能力 | 允许 | 禁止 |
+> |------|:----:|:----:|
+> | 修改已有任务的描述 | ✅ | |
+> | 修改已有任务的验收标准 | ✅ | |
+> | 调整已有任务的估时 | ✅ | |
+> | 标记任务阻塞/重分优先级 | ✅ | |
+> | 微调 `04_SYSTEM_DESIGN/` 中已有文件的细节 | ✅ | |
+> | **创建新任务 (T{X}.{Y}.{Z})** | | ❌ |
+> | **创建新文件** | | ❌ |
+> | **添加 AI 自认为好的功能** | | ❌ |
+> | **修改 [REQ-XXX] 需求引用** | | ❌ |
+> | **修改 `01_PRD.md`** | | ❌ |
+> | **修改 `02_ARCHITECTURE_OVERVIEW.md`** | | ❌ |
+> | **修改 `03_ADR/` 中的任何文件** | | ❌ |
+>
+> **单次 /change 最多影响 3 个已有任务 + 对应的设计文件微调。**
+>
+> **违反以上任何一条 → 变更无效，引导用户运行 `/genesis`。**
+
+---
+
+## ⚠️ CRITICAL 反自由发挥护栏
+
+> [!IMPORTANT]
+> **AI 禁止自行添加功能！**
+>
+> - ❌ "我认为加一个 XX 功能会更好" → **禁止**
+> - ❌ "顺便优化一下 YY" → **禁止**
+> - ❌ "为了完善体验，建议增加 ZZ" → **禁止**
+> - ✅ 只处理用户**明确提出的**变更请求
+> - ✅ 变更内容必须可追溯到用户的**原话**
+>
+> **你的职责是忠实执行用户要求的微调，而非自作主张改善系统。**
+> **如果你发现了值得改进的地方，请在报告中以"建议"形式告知用户，由用户决定是否通过 `/genesis` 处理。**
+</phase_context>
+
+---
+
+## ⚠️ CRITICAL 变更分类
+
+> [!IMPORTANT]
+> **变更分类决定处理方式**:
+> - **微调 (Tweak)** → 本工作流处理（仅修改已有任务）
+> - **其他所有变更** → 引导用户运行 `/genesis`
+
+---
+
+## Step 0: 定位当前版本
+
+1.  **扫描版本**:
+    扫描 `genesis/` 目录，找到最新版本号 `v{N}`
+2.  **确定当前版本**:
+    - 找到数字最大的文件夹 `v{N}`。
+    - **TARGET_DIR** = `genesis/v{N}`。
+
+3.  **检查必需文件**:
+    - [ ] `{TARGET_DIR}/01_PRD.md` 存在
+    - [ ] `{TARGET_DIR}/05_TASKS.md` 存在
+    - [ ] `{TARGET_DIR}/06_CHANGELOG.md` 存在
+
+4.  **如果缺失**: 提示先运行 `/genesis` 和 `/blueprint`。
+
+---
+
+## Step 1: 变更影响评估 (7 问题法)
+
+**目标**: 严格判断变更是"微调"还是"超出范围"。
+
+> [!IMPORTANT]
+> **你必须逐一回答以下 7 个问题**:
+> **全部为"否"才是微调，任意一个"是"就必须走 `/genesis`。**
+
+| # | 评估问题 | 微调条件 |
+|---|---------|---------|
+| 1 | 是否改变系统边界或新增系统? | 否 |
+| 2 | 是否新增外部依赖 (npm包/API/服务)? | 否 |
+| 3 | 是否影响多个系统的接口? | 否 |
+| 4 | 预估工时是否超过 2 天? | 否 |
+| 5 | 用户是否明确要求新版本? | 否 |
+| 6 | **是否需要创建 `05_TASKS.md` 中不存在的新任务?** | **否** |
+| 7 | **变更是否超出 `01_PRD.md` 中已定义的需求范围?** | **否** |
+
+> [!IMPORTANT]
+> **Q6 和 Q7 是核心防线**:
+> - Q6 阻止了通过 `/change` 注入新任务的路径
+> - Q7 阻止了超出 PRD 范围的"功能蔓延"
+> - 当你不确定 Q7 时，**必须读取 `01_PRD.md` 进行验证**，不允许凭印象判断
+
+**判定逻辑**:
+- 7 个问题**全部为"否"** → **微调** (继续 Step 2)
+- **任意**问题为"是" → **超出范围** (跳转 Step 4)
+
+**输出示例**:
+```markdown
+## 变更评估
+
+**变更描述**: 修改登录页面的错误提示文案
+**用户原话**: "把登录失败时的提示从'密码错误'改成'用户名或密码错误'"
+
+| 问题 | 答案 | 理由 |
+|------|:----:|------|
+| 改变系统边界? | 否 | 仅修改文案 |
+| 新增外部依赖? | 否 | 无 |
+| 影响多系统接口? | 否 | 纯前端文案修改 |
+| 工时 > 2天? | 否 | 预估 30 分钟 |
+| 用户要求新版本? | 否 | 未提及 |
+| 需要新任务? | 否 | 对应 T2.1.3 的验收标准修改 |
+| 超出 PRD 范围? | 否 | [REQ-005] 已定义登录功能 |
+
+**结论**: ✅ 微调 — 修改 T2.1.3 的验收标准
+```
+
+---
+
+## Step 2: 定位受影响的已有任务
+
+**目标**: 找到需要修改的已有任务，**不创建新任务**。
+
+> [!IMPORTANT]
+> **你只能修改已经存在的任务，禁止创建新的 `T{X}.{Y}.{Z}` 条目。**
+> 如果找不到对应的已有任务 → 说明这需要新任务 → 跳转 Step 4 引导 `/genesis`。
+
+1.  **读取当前任务清单**:
+    读取 `{TARGET_DIR}/05_TASKS.md`
+
+2.  **读取 PRD (交叉验证)**:
+    读取 `{TARGET_DIR}/01_PRD.md`，确认变更在需求范围内
+
+3.  **定位任务**:
+    - 找到与变更相关的已有任务 (如 `T2.1.3`)
+    - **最多 3 个任务**受影响
+    - 如果超过 3 个 → 跳转 Step 4
+
+4.  **定位相关设计文件** (如需要):
+    - 检查 `{TARGET_DIR}/04_SYSTEM_DESIGN/` 中是否有对应的系统设计文件
+    - 仅当任务的修改涉及设计细节时才需要同步修改
+    - **只能修改已有文件，禁止创建新文件**
+
+5.  **确定修改内容**:
+    对每个受影响的文件，明确要修改什么:
+    - 05_TASKS.md: 描述调整? 验收标准修改? 估时调整? 优先级变更?
+    - 04_SYSTEM_DESIGN: 接口细节? 参数调整? 样式微调?
+
+---
+
+## Step 3: 人类确认检查点 ⚠️
+
+**目标**: 展示变更计划，获得人类批准后才能执行。
+
+> [!IMPORTANT]
+> **这是强制检查点。未经人类确认，禁止修改任何文件。**
+> 你必须在此处暂停并等待用户回复。
+
+**展示变更计划**:
+
+```markdown
+⚠️ 人类检查点 — 变更确认
+
+**变更级别**: 微调 (Tweak)
+**用户原始请求**: "{用户原话}"
+**受影响任务**: {N} 个
+
+### 修改预览
+
+**任务 T{X}.{Y}.{Z}: {任务标题}**
+| 字段 | 修改前 | 修改后 |
+|------|--------|--------|
+| 验收标准 | Given... Then 跳转首页 | Given... Then 跳转 Dashboard |
+
+**任务 T{A}.{B}.{C}: {任务标题}** (如有)
+| 字段 | 修改前 | 修改后 |
+|------|--------|--------|
+| 估时 | 4h | 6h |
+
+---
+
+请确认: ✅ 批准 / ❌ 拒绝 / ✏️ 调整
+```
+
+- **用户批准** → 继续 Step 3.1 执行修改
+- **用户拒绝** → 终止，不做任何修改
+- **用户调整** → 根据反馈重新制定计划，重新进入 Step 3
+
+### Step 3.1: 执行修改 (仅在人类批准后)
+
+1.  **修改任务清单**:
+    使用 `replace_file_content` 修改 `{TARGET_DIR}/05_TASKS.md` 中的对应任务
+
+2.  **记录变更日志**:
+    读取并追加到 `{TARGET_DIR}/06_CHANGELOG.md`:
+    ```markdown
+    ## {YYYY-MM-DD} - 微调变更
+    - [CHANGE] T{X}.{Y}.{Z}: {修改描述}
+      - 用户原话: "{用户的原始请求}"
+      - 修改内容: {具体修改了什么}
+      - 影响范围: {受影响的文件/组件}
+      - PRD 追溯: [REQ-XXX]
+    ```
+
+3.  **更新 .agent/rules/agents.md**:
+    - 更新 `最近一次更新` 日期。
+    - (注意: 微调不改变待办任务数)
+
+4.  **报告**: 告知用户变更已完成。
+
+---
+
+## Step 4: 引导超出范围的变更
+
+**目标**: 告知用户需要运行 `/genesis` 创建新版本。
+
+> [!IMPORTANT]
+> **任何需要"新任务"的变更都不是微调。**
+> 不要试图将变更伪装成微调来处理。
+
+```markdown
+🚫 此变更**超出 /change 的权限范围**。
+
+**评估结果**:
+- [问题 X]: 是 — {理由}
+
+**为什么 /change 不能处理？**
+/change 的职责是微调已有任务（修改描述、调整验收标准），
+而非创建新功能或添加新任务。
+
+**这能防止什么？**
+- ❌ AI 自行添加"觉得好"的功能
+- ❌ 架构文档与实现不一致
+- ❌ 绕过 PRD → 架构 → 任务的完整链条
+
+**建议**: 运行 `/genesis` 创建新的架构版本 `v{N+1}`。
+
+📋 下一步: `/genesis` (将自动创建 v{N+1})
+```
+
+---
+
+## Step 5: AI 发现的改进建议 (可选)
+
+**目标**: 如果 AI 在分析过程中发现了值得改进的地方，以"建议"形式告知用户。
+
+> [!IMPORTANT]
+> **这些建议仅供参考，AI 不得自行执行。**
+> 用户需要自行决定是否通过 `/genesis` 处理。
+
+```markdown
+💡 **AI 发现的改进建议** (仅供参考，不在本次变更范围内):
+
+1. [建议1]: {描述} — 如需实施，请运行 `/genesis`
+2. [建议2]: {描述} — 如需实施，请运行 `/genesis`
+
+⚠️ 以上建议**不会被自动执行**，请自行决定是否采纳。
+```
+
+---
+
+<completion_criteria>
+- ✅ 完成 7 问题评估 (含 Q6 新任务检查 + Q7 PRD 范围检查)
+- ✅ 微调变更: 定位已有任务 + 展示计划 + 人类确认 + 执行修改 + 记录 CHANGELOG
+- ✅ 超出范围: 明确告知用户 /change 无权处理，引导 /genesis
+- ✅ 所有写操作前通过了人类检查点
+- ✅ 未创建任何新任务
+- ✅ 未添加任何 AI 自认为好的功能
+</completion_criteria>