SuperAPI AI Directory

milestone-gate

General & other

View repository

Updated 10-16 09:31

About this skill

Milestones and Delivery Gates (Milestone Gates)

Reference sources: Stage-Gate Process, PMBOK Phase Gates

Applicable Scenarios

  • Project phase division
  • Phase review checkpoints
  • Final pre-launch check
  • "Pass/Fail" decisions at important milestones

Core Principles

1. 里程碑 = 阶段性可验证的交付节点
   不是"做完一半",而是"完成了某个完整产物"
  1. Gate = mandatory check If the gate is not passed, do not enter the next phase Even when time is tight, it cannot be skipped

  2. Each milestone must be independently verifiable It cannot be considered passed only "when downstream says there are no problems"

  3. Gates are the project's "braking system" It is better to pause than to let problems flow downstream


## 好的里程碑 vs 坏的里程碑

```text
好的里程碑:
  ✓ 有明确的验收标准
  ✓ 有具体的时间点
  ✓ 有负责工作流
  ✓ 可以独立验证(不依赖后续工作)

坏的里程碑:
  ✗ "开发完成 50%"(不可验证)
  ✗ "基本可用"(标准模糊)
  ✗ 没有时间点的里程碑
  ✗ "等所有人都觉得 OK"

Standard Gate Checklist

Requirements gate

□ PRD 已评审通过
□ 验收标准已定义(可测试)
□ 技术可行性已确认
□ 非目标范围已明确
□ 优先级已排序
□ 关键风险已识别

Design gate

□ UI/UX 设计已完成(含状态说明)
□ API 契约已定义(OpenAPI)
□ 数据库设计已完成(DDL)
□ 关键决策已记录
□ 设计评审通过
□ 前后端能据此独立开发

Development gate

□ 核心功能已完成
□ 单元测试通过
□ 接口联调通过
□ 代码评审完成
□ 没有阻塞性 Bug
□ 文档同步更新

Testing gate

□ 核心路径测试通过
□ 关键 Bug 已修复
□ 回归测试通过
□ 边界条件测试通过
□ 性能符合要求
□ 测试报告已输出

Security gate

□ 代码安全评审通过
□ 依赖漏洞已修复
□ 敏感数据保护已检查
□ 鉴权权限已验证
□ OWASP Top 10 已检查
□ 安全报告已输出

Launch gate

□ 安全检查通过
□ 部署文档就绪
□ 回滚方案就绪(5 分钟内可回滚)
□ 监控告警配置完成
□ 健康检查端点正常
□ 相关方已通知
□ 上线时间窗口确认

Gate pass decision

通过:所有项打勾
  → 进入下一阶段

部分通过:核心项打勾,非核心项有 1~2 项不通过
  → 评估风险后决定:
    - 风险可控 → 通过 + 标注待办
    - 风险高 → 不通过

不通过:有核心项不打勾
  → 退回上游修复
  → 重新进入门禁

Milestone Design Template

## 项目里程碑计划

| 里程碑 | 时间点 | 验收标准 | 门禁类型 | 负责工作流 |
|--------|--------|---------|---------|----------|
| M1: 需求确认 | +15min | PRD + 验收标准已定义 | 需求门禁 | product-manager |
| M2: 接口就绪 | +50min | API 契约 + 数据库设计完成 | 设计门禁 | api-designer + database-engineer |
| M3: 开发完成 | +2h | 前后端联调通过 | 开发门禁 | backend + frontend |
| M4: 测试通过 | +2.5h | QA + 安全检查通过 | 测试 + 安全门禁 | qa + security |
| M5: 上线 | +3h | 服务上线,监控正常 | 上线门禁 | devops + sre |

### M1: 需求确认

**时间点**:项目开始 +15min
**负责工作流**:product-manager

**门禁清单**:
□ PRD 已输出(docs/prd.md)
□ 14 节结构完整
□ 至少 5 个用户故事 + 验收标准
□ 非目标范围已明确
□ 关键风险已列出(≥ 5 个)
□ 未决问题清单 ≤ 3 条

**通过后产出**:
- PRD 文档
- 风险清单
- 转交项目经理拆任务

**不通过处理**:
- 退回 product-manager 工作流
- 标注具体哪些项不通过
- 限定修复时间(不超过原计划 50%)

Workflow

1. 项目启动时:
   - 根据 WBS 和关键路径识别里程碑
   - 一般 5~7 个里程碑(XL 项目可以更多)
   ↓
2. 每个里程碑定义:
   - 时间点(基于关键路径)
   - 验收标准(可测试)
   - 门禁清单(标准 + 项目特定)
   - 负责工作流
   ↓
3. 项目执行中:
   - 每个里程碑前一步开始准备门禁检查
   - 到达里程碑时执行门禁检查
   - 通过 → 进入下一阶段
   - 不通过 → 退回 + 修复
   ↓
4. 里程碑数据沉淀:
   - 通过率
   - 平均门禁检查耗时
   - 不通过的常见原因
   - 沉淀到 field-journal

Quality self-check

□ 每个里程碑是否有时间点(不能"开发完成后")
□ 每个验收标准是否可测试
□ 门禁清单是否覆盖了关键风险
□ 是否标注了负责工作流
□ 不通过处理路径是否明确
□ 是否有强制门禁(不能跳过)

Common pitfalls

  1. Too many milestones——20 milestones = no milestones
  2. Too few milestones——Only "launch," and only then discovering a pile of problems
  3. Vague acceptance criteria——"Development complete" → should be "API callable + tests passed"
  4. Gates optional——"Skip if time is tight" → loses the meaning of gates
  5. Gate checklist not updated——The previous checklist does not apply to this project
  6. Failure reasons not recorded——The same pitfall will be stepped into again
  7. "100% pass rate"——Either the gates are too loose, or the team is cheating

Supporting templates

  • templates/milestone-plan-template.md — Milestone plan template
  • templates/delivery-gate-checklist.md — Gate checklist + gate review record template

Collaboration with other skills

上游:
  critical-path → 关键路径节点是天然的里程碑
  risk-management → 高风险点需要门禁拦截

下游:
  progress-tracking → 追踪门禁状态
  retrospective → 复盘门禁有效性