dev-lifecycle Skill

长任务开发流程 Skill，为 Claude Code 提供端到端开发生命周期管理。主 agent 作为纯调度器，通过 Artifact 契约链驱动各阶段 subagent 执行。

系统架构

流程总览

flowchart TB
    subgraph P0["Phase 0: 启动评估"]
        A[用户描述任务] --> B{规模判断}
        B -->|1-5文件,需求明确| C[lite]
        B -->|6-15文件,中等功能| D[standard]
        B -->|15+文件,跨系统| E[thorough]
    end

    subgraph P1_3["Phase 1-3: 规划"]
        C --> F[需求确认 ★]
        D --> G[快速规划] --> F
        E --> H[P1需求] --> I[P2设计] --> J[P3计划] --> F
    end

    subgraph P4["Phase 4: 执行"]
        F --> K[任务分解]
        K --> L{执行模式}
        L -->|瀑布| M[Batch顺序执行]
        L -->|迭代| N[反馈循环]
        M --> O[Subagent并行]
        N --> P[主Agent直接]
    end

    subgraph P5["Phase 5: 验证"]
        O --> Q[测试验证]
        P --> Q
        Q -->|PASS| R[质量判定]
        Q -->|FAIL| S[Self-Healing] --> Q
    end

    subgraph P6["Phase 6: 交付"]
        R --> T{规模}
        T -->|thorough| U[经验沉淀]
        T -->|standard| V[按需总结]
        T -->|lite| W[完成]
    end

Loading

规模路由

规模	文件数	流程	文档产出
lite	1-5	需求确认 → P4 → P5	tasks.json + progress.md
standard	6-15	P0 → 快速规划 → P4 → P5 → P6(按需)	spec.md + tasks.json + progress.md
thorough	15+	P0-P6 完整	完整文档套件

亮点

1. Artifact 契约链 — 每个阶段的输出文件是下一阶段的唯一输入，文件即状态。中断/compact 后恢复只需读文件，不依赖对话历史
2. 调度器模式 — 主 agent 不做具体工作，只做调度决策。所有执行委派给 subagent，天然支持并行和隔离
3. 三级规模路由 — lite/standard/thorough 自动匹配任务复杂度，lite 3 轮内进入编码，thorough 完整 6 阶段。避免小任务走重流程、大任务缺规划
4. Sprint Contract — 每个阶段有明确验收条件，subagent 必须满足才能结束，杜绝"差不多就行"
5. P5 验证抗中断 — p5-checklist.json 持久化验证进度，修复循环被 compact 或中断后可无缝恢复
6. P1.5 调研固化 — 调研成果写入 research/ 目录，后续迭代跳过已验证内容，避免重复探索浪费 token
7. P2.5 MVP 方向验证 — PRD 后 30 分钟快速验证技术方向，错了早掉头，避免在错误方向上深入
8. 圆桌评审 — Round 0 强制知识注入（AI 知识 + 记忆 RAG + 全网搜索），然后按知识源分权重：项目经验×3 > 外部证据×2 > 纯推理×0.5，避免同一模型自说自话
9. 完备的逃逸机制 — skip/降级/事后补录/规模升级，流程严谨但不僵硬
10. Script-First 状态管理 — 11 个 shell 脚本管理状态/迁移/校验，版本升级自动迁移
11. 主动 Token 管理 — 按规模预估预算，超 80% 提醒，阶段切换建议 compact

Artifact 链

用户需求 → p0-output.json → spec.md → research/*.md → design.md → tasks.json + plan.md
  → p4-task-{id}-result.json → test-report.md + p5-checklist.json → summary.md + lessons-learned.md

审核模式

• auto：需求确认必须，其余全自动
• guided：需求确认必须，用户选择额外 checkpoint（设计+执行 / 仅执行 / 自定义）

Token 预算

规模	不含探索	含探索
lite	5-20K	5-20K
standard	40-80K	60-120K
thorough	150-300K	200-400K

跳过/降级机制

• skip：除需求确认外，任何阶段可跳过
• 直接做：任何阶段可跳到 P4 执行
• 降级：用户说"别评审了直接做" → 流程降级
• 逃逸阀：连续 skip 2 个阶段 → 自动建议降级 lite
• 事后补录：已跳过 P0 开始编码 → 允许事后补录评估结果

文件结构

Skill 仓库

dev-lifecycle-skill/
├── SKILL.md                          # Skill 定义（触发条件、完整流程、约束）
├── README.md                         # 本文件
├── docs/
│   ├── design-v2.md                  # v2 设计方案
│   ├── upgrade-plan.md               # 升级计划
│   └── reference-analysis.md         # 13 个参考项目分析
├── evals/
│   └── evals.json                    # 评估用例（lite/standard/thorough）
└── references/                       # 阶段 reference 文件（运行时按需加载）
    ├── artifacts-schema.md           # Artifact 契约规范（v3 核心）
    ├── dispatcher-protocol.md        # 调度器协议（v3 核心）
    ├── extensions.md                 # 可选扩展索引
    ├── frameworks.md                 # 框架参考
    ├── quick-plan.md                 # 快速规划模板（standard）
    ├── research-template.md          # 调研模板（P1.5）
    ├── phase-1-requirements.md       # P1 需求阶段
    ├── phase-2-design.md             # P2 设计阶段
    ├── phase-2.5-mvp.md              # P2.5 MVP 方向验证
    ├── phase-3-planning.md           # P3 规划阶段
    ├── phase-4-execution.md          # P4 执行阶段
    ├── phase-5-verification.md       # P5 验证阶段
    ├── phase-6-delivery.md           # P6 交付阶段
    ├── domain-checklists/
    │   └── web-automation.md         # 领域检查清单
    └── scripts/                      # 状态管理脚本
        ├── init.sh                   # 项目初始化
        ├── status.sh                 # 状态查询
        ├── validate.sh               # 验证
        ├── update-phase.sh           # 阶段更新
        ├── migrate.sh                # 版本迁移
        ├── next.sh                   # 下一步建议
        ├── enforce-phase.sh          # 阶段门控
        ├── check-file-scope.sh       # 文件范围检查
        ├── validate-tasks-edit.sh    # 任务编辑校验
        ├── p5-checklist-update.sh    # P5 检查清单更新
        └── worktree-bootstrap.sh     # Worktree 引导

项目运行时生成

.dev-lifecycle/
├── .phase-state              # 当前阶段状态
├── .skill-version            # 版本号（自动迁移用）
├── p0-output.json            # P0 评估结果
├── tasks.json                # 任务列表（含 effort/batch/file_scope）
├── progress.md               # 进度记录
├── spec.md                   # 规划文档（standard）
├── requirements.md           # 需求文档（thorough）
├── design.md                 # 设计文档（thorough）
├── plan.md                   # 计划文档（thorough）
├── p4-task-{id}-result.json  # P4 任务执行结果
├── p5-checklist.json         # P5 验证清单（抗中断）
├── test-report.md            # 测试报告
├── summary.md                # 交付总结
├── lessons-learned.md        # 经验总结
├── research/                 # 调研固化（P1.5）
│   └── {topic}.md
└── scripts/                  # 从 references/scripts/ 复制

安装

将仓库克隆到 Claude Code skills 目录：

git clone https://github.com/Alex-dev-spec/dev-lifecycle-skill.git ~/.claude/skills/dev-lifecycle

使用

描述任务时提到"开发流程"、"长任务"、"从零开发"、"完整开发"、"项目开发"等关键词，Skill 自动触发。

涉及 3+ 文件修改时也会自动提示建议走流程。

不适用场景（直接做，不走流程）

• 紧急修复 / 热修复
• 探索式开发
• 纯重构
• 单文件小改
• 学习 / 调研

可选扩展

详见 references/extensions.md：

扩展	说明
圆桌评审	按知识源分权重（外部证据×2，项目经验×3，纯推理×0.5）
量化质量评分	BLOCKER/CONCERN/NIT 公式
需求追溯 ID	R-xxx/T-xxx 双向追溯
INVEST 检查	需求质量评估
STRIDE 安全检查	安全深度审查
阶段级成本追踪	Token 消耗跟踪

Git 版本控制（默认关闭）

P0 时指定 git_checkpoint: true 或中途说"开启 git 版本控制"。开启后每 Batch 完成 + 测试通过自动 commit。

文档索引

文档	内容
SKILL.md	Skill 完整定义（触发条件、流程、约束、Hooks 配置）
references/artifacts-schema.md	Artifact 契约规范（v3 核心）
references/dispatcher-protocol.md	调度器协议（v3 核心）
references/extensions.md	可选扩展索引
docs/design-v2.md	v2 设计方案
docs/upgrade-plan.md	升级计划
docs/reference-analysis.md	13 个参考项目分析
evals/evals.json	评估用例

版本

• 当前版本: 3.0.0
• 升级日期: 2026-04-06
• v3 核心改动: Artifact 契约 / 调度器模式 / Task 系统 / Sprint Contract / 验证抗中断 / Compact 升级

参考项目

核心模式借鉴了以下项目：

• CCPM — Script-First 状态管理
• claude-code-skills — 防投机门控
• claude-code-workflows — 复杂度路由
• Anthropic Best Practices — Token 效率

详见 docs/reference-analysis.md