From 3f5167647275fc16f3c2e5f3452c67f5dbe77fec Mon Sep 17 00:00:00 2001 From: Claude Code Date: Thu, 23 Apr 2026 06:00:02 +0000 Subject: [PATCH] =?UTF-8?q?sync:=20=E6=97=85=E7=A8=8B=E5=AE=9A=E4=B9=89?= =?UTF-8?q?=E6=96=B0=E5=A2=9E=E6=8A=80=E6=9C=AF=E9=AA=8C=E8=AF=81(3T)?= =?UTF-8?q?=E8=8A=82=EF=BC=8C=E8=A6=86=E7=9B=96=E5=90=8E=E5=8F=B0=20Worker?= =?UTF-8?q?/=E5=AE=9A=E6=97=B6=E4=BB=BB=E5=8A=A1/=E4=B8=AD=E9=97=B4?= =?UTF-8?q?=E4=BB=B6=E7=B1=BB=20Story?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 为无法通过用户 UI 旅程覆盖的 Story 类型提供技术验证机制： - 后台 Worker 任务、定时任务、中间件/拦截器、后台调度逻辑 - 独立的技术验证格式模板（区别于用户旅程） - 覆盖度评估中与用户旅程同等计分 - 追加到对应 Epic 的 journeys 文件中统一管理 Co-Authored-By: Claude Opus 4.7 --- .../modes/journey/journey-definition.md | 52 ++++++++++++++++++- .../d8d-dev/modes/journey/journey-index.md | 1 + 2 files changed, 52 insertions(+), 1 deletion(-) diff --git a/.claude/skills/d8d-dev/modes/journey/journey-definition.md b/.claude/skills/d8d-dev/modes/journey/journey-definition.md index 3b8bf9a..72b0638 100644 --- a/.claude/skills/d8d-dev/modes/journey/journey-definition.md +++ b/.claude/skills/d8d-dev/modes/journey/journey-definition.md @@ -57,7 +57,57 @@ - 不同 teammate 生成的旅程中引用同一标准模板时，步骤内容必须完全一致 - 主 agent 在步骤 3.5 后检查跨 Epic 一致性 - 不一致 → 主 agent 自动修复（以第一个生成结果的版本为准） - ↓ + ↓ + 3T. 生成技术验证（⛔ 当存在后台 Worker/定时任务/中间件类 Story 时必须执行） + 部分 Story 无法通过用户 UI 旅程覆盖（如异步删除 Worker、定时扫描任务、配额检查中间件）。 + 对这类 Story，生成「技术验证」而非「用户旅程」。 + + ⛔ 判断标准：以下类型的 Story 使用技术验证而非用户旅程： + - 后台 Worker 任务（由系统自动触发，无用户入口） + - 定时任务（Cron/Scheduler 触发） + - 中间件/拦截器（请求链路自动执行） + - 后台分配/调度逻辑（如 API 密钥智能分配） + + a. 技术验证格式模板： + + ```markdown + ## 技术验证 {N}.{M}: {名称} + + - **覆盖 Story**: S{N}.{M} + - **覆盖 FR**: FR{XX} + - **触发方式**: {自动/定时/请求拦截/条件触发} + - **前置条件**: {系统状态要求} + - **验证工具**: {MCP 工具名 / API 端点 / 管理后台页面} + + ### 验证步骤 + 1. {触发条件准备} + 2. {触发/等待执行} + 3. {结果验证} + + ### 数据状态变化 + | 阶段 | 状态 | + |------|------| + | 触发前 | {初始状态} | + | 执行后 | {预期变化} | + + ### 验收标准 + - [ ] {具体可量化断言} + ``` + + b. 技术验证与用户旅程的区别： + | 维度 | 用户旅程 | 技术验证 | + |------|---------|---------| + | 起始页 | 自然入口 URL | 无（非 UI 操作） | + | 用户视角步骤 | 必须 | 无 | + | 技术验证步骤 | 必须 | 必须 | + | R1-R5 规则 | 全部适用 | 仅 R4（凭据隔离）适用 | + | R6 自包含 | 必须 | 不适用（系统状态而非业务数据） | + | 覆盖度计分 | 与用户旅程相同 | 与用户旅程相同 | + + c. 技术验证追加到对应 Epic 的 `epic-N-journeys.md` 文件末尾， + 以 `## 技术验证 {N}.{M}` 为标题，与用户旅程同文件管理。 + d. 技术验证在步骤 3.5 覆盖度评估中与用户旅程同等计分。 + ↓ 3.5 覆盖度评估（FR 追踪矩阵交叉检查）: a. 读取 `03-epics-and-stories.md` 的 "FR 覆盖追踪矩阵" 表格 b. 读取所有 `epic-N-journeys.md` 中每条旅程涉及的技术验证步骤 diff --git a/.claude/skills/d8d-dev/modes/journey/journey-index.md b/.claude/skills/d8d-dev/modes/journey/journey-index.md index c641bc0..e00be4a 100644 --- a/.claude/skills/d8d-dev/modes/journey/journey-index.md +++ b/.claude/skills/d8d-dev/modes/journey/journey-index.md @@ -31,6 +31,7 @@ Story 验证全部通过 ≠ 用户能正常使用系统。旅程模式弥补这 - 从自然入口开始的完整用户操作流程 - FR 覆盖度评估 + 组件级覆盖校验 - 旅程真实性原则 R1-R5 校验 +- 后台 Worker/定时任务/中间件类 Story 的技术验证（非用户旅程），确保所有 Story 均被覆盖 ### 子模式 2：旅程验证 -- 2.49.1