sync: 旅程定义新增技术验证(3T)节,覆盖后台 Worker/定时任务/中间件类 Story #60

Merged
d8dfun merged 1 commits from sync/d8d-skills-20260423-055945 into master 2026-04-23 14:02:01 +08:00
2 changed files with 52 additions and 1 deletions

View File

@@ -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` 中每条旅程涉及的技术验证步骤

View File

@@ -31,6 +31,7 @@ Story 验证全部通过 ≠ 用户能正常使用系统。旅程模式弥补这
- 从自然入口开始的完整用户操作流程
- FR 覆盖度评估 + 组件级覆盖校验
- 旅程真实性原则 R1-R5 校验
- 后台 Worker/定时任务/中间件类 Story 的技术验证(非用户旅程),确保所有 Story 均被覆盖
### 子模式 2旅程验证