Enforce Waterfall Phase Gates Skill 技能

功能简介

Enforce Waterfall Phase Gates 是一款针对 AI 编程助手的瀑布流阶段门控框架。当 AI 辅助开发时面临交付压力，容易跳过需求定义、设计评审或测试验证等环节，这款技能强制要求每个功能必须按阶段顺序推进，并在每个阶段之间完成本地门控验证，确保所有 gate 证据齐全后才能进入下一阶段，从而在保持 AI 编程效率的同时维护过程的规范性和可追溯性。

支持工具：Claude、Codex、Claude Code
开源许可：MIT License
作者：Chemiseblanc

核心能力

1. 瀑布五阶段门控：定义 Requirements（需求）、Design（设计）、Implementation（实现）、Testing（测试）、Complete（完成）五个严格顺序的阶段，每个阶段配备独立的验证门
2. 本地门控验证器：在本地运行 gate 验证逻辑，检查 feature 当前所处阶段和 gate 状态是否满足流转条件，无需网络调用
3. features.yml 驱动：通过项目根目录的 features.yml 文件管理所有功能的状态、阶段和 gate 证据，激活工作流后自动识别当前 feature 状态
4. 蓝图规划生成：运行 Create a waterfall implementation blueprint 命令，自动生成包含技术方案、关键文件、实施步骤、风险识别和测试计划的完整实现蓝图
5. 完成门审计：在标记功能完成前，执行 Verify all requirements, test links, and passing test flags 验证所有需求关联的测试证据和通过标志
6. 工作流程阻断：当工作内容与当前 feature 阶段不匹配时，主动阻断并提示正确的 gate 位置，防止错误跳阶段
7. 文档化 gate 标准：为每个阶段的流转提供明确的通过标准和修复指南，失败时返回具体修复建议

安装配置

1. 安装命令：通过 skillstore 工具直接安装

   npx skillstore add chemiseblanc/waterfall-development

2. 环境准备：确保工作目录存在 features.yml 文件，这是激活工作流的触发条件
3. 配套依赖：建议配合 feature-file 技能使用以获得完整的制品管理能力，单个技能可独立运行但功能受限
4. 验证配置：安装后运行一次 Use the waterfall workflow 验证配置是否正确激活

使用步骤

1. 创建或定位 features.yml：在工作区根目录创建 features.yml，或确认已有文件存在，工作流将在检测到该文件后自动激活
2. 定义功能条目：为每个功能添加条目，包括名称、当前阶段、关联需求和测试证据
3. 执行阶段流转验证：在实现每个功能时，调用 Validate whether my selected feature is ready to move from [Phase A] to [Phase B] 检查是否满足 gate 标准
4. 生成实现蓝图：通过 Create a waterfall implementation blueprint 命令生成包含技术方案、风险和测试计划的完整蓝图
5. 审计完成门：在功能接近完成时，执行 Verify all requirements, test links, and passing test flags 确保所有完成条件已满足后才标记为 Complete
6. 循环迭代：一个功能完成后，将下一个功能的状态更新到 features.yml 并重复以上步骤

适用场景

1. 需要严格合规的开发流程：金融、医疗、军工等行业的软件开发必须保留完整的阶段审批记录，waterfall gate 提供天然审计轨迹
2. 委托 AI 完成的较大功能：当功能跨越多个 sprint 且需要分阶段审查时，waterfall 流程可防止 AI 跳过必要的审查步骤
3. 需要对监管机构证明质量的项目：gate 证据和 features.yml 中的完整记录可作为软件质量审计的直接依据
4. 跨团队协作的复杂项目：多个团队在不同阶段工作时，通过 gate 控制确保依赖关系正确衔接，避免下游团队等待上游交付物

适用人群

• 需要向监管机构证明软件开发过程规范性的团队
• AI 辅助开发中需要防止需求、设计和测试被跳过的项目负责人
• 习惯瀑布式管理但希望借助 AI 提高执行效率的开发团队
• 需要为每个功能交付提供可追溯证据的项目经理

工作原理

该技能通过监听用户的自然语言指令来识别 feature 状态和预期的阶段流转。当用户表达要在某个功能上开始工作时，技能读取本地 features.yml 文件，判断当前功能所处阶段。然后激活对应的 gate 验证逻辑，验证通过才允许进入下一阶段；如果验证失败，工作流中断并返回具体的修复建议，等待开发者修正后再次验证。这种阻断式机制确保了每个阶段的交付物在进入下一阶段前都被完整记录。

官方链接

• Skill 主页：https://skillstore.io/skills/chemiseblanc-waterfall-development
• GitHub 仓库：https://github.com/Chemiseblanc/ai/tree/main/skill/waterfall-development
• 安装命令：npx skillstore add chemiseblanc/waterfall-development