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:旅程验证