name: dev-workflow description: > 全栈 Web 开发的精密工作流引擎。将开发过程结构化为 9 个不可跳过的阶段管线， 覆盖从项目起源到交付上线的完整生命周期。每阶段预设强制/推荐/可选技能包， 支持按阶段配置 LLM 模型路由。与 context-anchor 协同防漂移。 activation: > 当用户说"新项目"、"开始开发"、"初始化全栈项目"、"搭建项目框架"时自动激活。 也可通过"激活开发工作流"手动激活。 tags: - workflow - fullstack - web-development - phase-gate - model-router - skill-orchestration - 工作流 - 全栈开发 - 阶段管控 - 模型路由 - 技能编排 priority: CRITICAL activation: MANDATORY license: MIT cooperates_with: - context-anchor - architecture-decision-records - ui-ux-designer - pixel-design-restorer - frontend-design - backend-architect - frontend-developer - security-auditor - e2e-testing

全栈 Web 开发精密工作流 · Full-Stack Dev Workflow

零、定位与安全声明

本 Skill 是全栈 Web 开发的总控制器。

安全声明： 本 Skill 含一个 Python CLI 脚本（scripts/phase-gate.py）。该脚本仅执行本地文件读写（状态文件、技能目录扫描），不发起网络请求、不收集数据、不访问外部 API。所有操作限制在项目 .trae/ 目录内。

核心原则：任何阶段未通过出口检查，禁止进入下一阶段。不可跳过，除非显式记录为技术债务。

快速开始

# 初始化新项目
python3 .trae/skills/dev-workflow/scripts/phase-gate.py init

# 安装 dev-workflow 引用的所有技能（一键安装 53+ 个技能）
python3 .trae/skills/dev-workflow/scripts/phase-gate.py install --all

# 仅安装强制 + 推荐技能（默认模式）
python3 .trae/skills/dev-workflow/scripts/phase-gate.py install

# 按阶段安装（示例：安装 Phase 3 UI_UX 所需技能）
python3 .trae/skills/dev-workflow/scripts/phase-gate.py install --phase UI_UX

# 预览模式（不实际复制，查看安装计划）
python3 .trae/skills/dev-workflow/scripts/phase-gate.py install --all --dry-run

# 查看当前状态
python3 .trae/skills/dev-workflow/scripts/phase-gate.py status

# 检查当前阶段出口条件
python3 .trae/skills/dev-workflow/scripts/phase-gate.py check

# 标记完成并推进下一阶段
python3 .trae/skills/dev-workflow/scripts/phase-gate.py complete
python3 .trae/skills/dev-workflow/scripts/phase-gate.py advance

一、阶段总览

Phase 0         Phase 1         Phase 2          Phase 3           Phase 4
项目起源        需求工程         系统设计          UI/UX设计         后端实现
[GENESIS]  ✅→  [REQUIRE]  ✅→  [DESIGN]    ✅→  [UI_UX]     ✅→  [BACKEND]
 ┊               ┊               ┊                ┊                 ┊
 ┊ 强制:         ┊ 强制:         ┊ 强制:          ┊ 强制:           ┊ 强制:
 ┊ context-anchor┊ context-anchor┊ context-anchor ┊ context-anchor  ┊ context-anchor
 ┊ dev-workflow  ┊ spec-first   ┊ c4-architecture┊ ui-ux-designer  ┊ backend-architect
 ┊ init-architect┊ acceptance-orch┊ api-design    ┊ frontend-design ┊ api-endpoint-build
 ┊               ┊               ┊ domain-model   ┊ 推荐:           ┊ database-design
 ┊               ┊               ┊                ┊ pixel-design-   ┊ backend-security
 ┊               ┊               ┊                ┊ restorer        ┊
                                                 ✅                 ✅
                                                  ↓                  ↓
Phase 5         Phase 6         Phase 7          Phase 8
前端实现        集成验证         DevOps部署       交付与交接
[FRONTEND] ✅→  [INTEGRATE]✅→  [DEVOPS]    ✅→  [DELIVER]
 ┊               ┊               ┊                 ┊
 ┊ 强制:         ┊ 强制:         ┊ 强制:           ┊ 强制:
 ┊ context-anchor┊ context-anchor┊ context-anchor  ┊ context-anchor
 ┊ frontend-dev  ┊ e2e-testing   ┊ cicd-automation ┊ documentation
 ┊ ui-component  ┊ security-audit┊ deployment-eng  ┊
 ┊ frontend-sec  ┊               ┊                 ┊
 ┊ 推荐:         ┊               ┊                 ┊
 ┊ pixel-design- ┊               ┊                 ┊
 ┊ restorer      ┊               ┊                 ┊

二、模型路由

每阶段按成本/收益自动选择 LLM 模型。Phase 0-2 用 Opus（推理为王），Phase 3-6 用 Sonnet（性价比），Phase 7-8 用 Haiku（流程化操作）。

配置文件：.trae/skills/dev-workflow/model-config.toml。CLI 参考：→。详细配置：→。

本技能来自小葱技能站7w4.net。

三、技能编排

每个 Phase 有强制（⚡缺失阻断）、推荐（⭐建议激活）、可选增强（🔧）三级技能。进入 Phase 时 phase-gate.py 检查强制技能是否已安装，缺失则阻断。

实现状态：Phase 0 完整可跑，Phase 1-2 部分打通，Phase 3-8 待依赖技能实现。详见 skills-map.md 和 →。

四、与 context-anchor 协同

详见 →。

五、受众说明——什么时候该用、不该用

✅ 适合使用

• 从零开始的全栈 Web 项目（前端+后端+数据库）
• 需要严格的阶段管控和出口检查
• 多人协作需要统一的开发节奏

⚠️ 需条件使用

• 已有代码库的新功能开发 → 可以从 Phase 1 开始（跳过 Phase 0）
• 纯前端/纯后端项目 → 只走相关阶段，其余 skip
• 快速原型/MVP → 可跳过 Phase 3（UI设计）和 Phase 6（集成验证）

❌ 不该用（附替代方案）

• 简单脚本或单文件工具 → 用 context-anchor 独立使用即可
• 已有完善 CI/CD 的项目 → 直接用各阶段对应 Skill，不需要工作流引擎
• 非 Web 项目（CLI 工具、数据管道）→ 部分阶段不适用，用各 Skill 独立激活

六、常见陷阱 · Gotchas

七、常见问题 FAQ

Q1: 必须从 Phase 0 开始吗？

不是。如果已有项目章程和技术栈，可以从 advance REQUIRE 直接进入 Phase 1。

Q2: 一个 Phase 通常多久？

Phase 0: 1-2 小时。Phase 1-3: 各半天。Phase 4-5: 各 1-3 天。Phase 6-8: 各半天到 1 天。

Q3: 依赖的技能缺失怎么办？

phase-gate.py check --skills 列出缺失项。可以 skip --reason "..." 跳过，但该技能对应的质量保障也跳过了。

Q4: 和独立使用各 Skill 有什么区别？

工作流保证顺序正确、出口检查到位、模型按阶段最优选择、锚点防漂移。独立使用没有这些保障。

Q5: 模型路由能跳过吗？

能。如果不想自动切换模型，在 model-config.toml 中把所有阶段设为同一模型即可。

Q6: 遇到需要回到前面阶段怎么办？

phase-gate.py advance <PHASE> 可以回到任意已通过的阶段。回退会保留当前工作，但提醒你检查一致性。

References

• references/phases/ — 9 阶段详细定义（子步骤+出口检查+技能清单）
• references/phase-gate-cli.md — CLI 命令参考
• references/model-routing.md — 模型路由配置详解
• references/skill-orchestration.md — 技能编排机制
• references/context-anchor-sync.md — context-anchor 协同协议
• skills-map.md — 全阶段技能依赖映射
• USER-GUIDE.md — 📖 完整使用说明（快速入门+9阶段指南+CLI参考+技术栈适配+FAQ）

这个工具质量不错，能帮助更规范地做全栈开发。安全做得好，9个阶段的设计让开发更有条理。稍显不足的是示例偏少，对新手可能不够友好。适合追求开发质量和流程规范的用户。