acceptance-gate
分类: 工具与效率 | 上传者: 
当需要定义或更新验收门禁时，使用本 Skill 管理设计确认门、逻辑确认门、实现质量门、交付质量门和 parity-gate。 在任何完成声明之前强制执行验证铁律：没有新鲜证据，不得宣称完成。 --- # 验收门管理器 ## 验证铁律 ``` 没有在当前步骤运行验证命令并看到输出，不得宣称任何完成状态 ``` 这条铁律适用于所有完成声明、满意表达和正向状态描述。 ### 5 步验证门 在宣称任何完成状态之前，必须依次执行： 1. **IDENTIFY**：什么命令或证据能证明这个声明？ 2. **RUN**：执行完整命令（新鲜的、完整的，不是上一次的结果） 3. **READ**：完整阅读输出，检查退出码，数清失败数 4. **VERIFY**：输出是否确认了声明？ - 如果否 → 陈述实际状态和证据 - 如果是 → 带着证据陈述声明 5. **CLAIM**：只有在以上步骤全部完成后，才能做出声明 跳过任何一步 = 不诚实，不是高效。 ### 禁止措辞 以下措辞在没有对应验证证据时绝对禁止使用： - "应该可以了" - "应该没问题" - "大概通过了" - "看起来正确" - "基本完成了" - "应该能用了" - "问题应该解决了" - 任何包含"应该""大概""看起来""基本"的完成性表述 ### 常见完成声明的证据要求 | 声明 | 需要的证据 | 不够的证据 | |------|-----------|-----------| | 测试通过 | 测试命令输出：0 failures | 上一次运行结果、"应该通过" | | 构建成功 | 构建命令：exit 0 | Lint 通过、"看起来没问题" | | Bug 已修复 | 复现原始症状的测试通过 | 代码改了、"应该修好了" | | 需求已满足 | 逐条对照检查清单 | 测试通过（测试不等于需求） | | 子代理已完成 | 检查 VCS diff 确认变更 | 子代理报告"成功" | | 静态校验通过 | 项目构建命令（mvn compile / tsc / pnpm build 等）exit 0 | IDE ReadLints "无错误"、编辑器无标红 | | 无回归 | 全量测试通过 | 部分测试通过 | ### 自我合理化防御 | 借口 | 现实 | |------|------| | "应该能用了" | 运行验证命令 | | "我很有信心" | 信心不是证据 | | "就这一次" | 没有例外 | | "Lint 通过了" / "ReadLints 无错误" | IDE 诊断不等于编译、不等于测试；必须用项目构建工具链验证 | | "子代理说成功了" | 独立验证 | | "已经很晚了、很累了" | 疲劳不是借口 | | "部分检查够了" | 部分证据什么也证明不了 | ## 使用时机 - `/plan` 生成 acceptance - `/verify` 更新门禁状态 - `/ship` 前检查是否真的可以交付 - **任何即将宣称"完成"的时刻** ## 使用方式 1. 生成或更新 `.ai-os/acceptance.yaml` 2. 根据 `../../references/risk-triggers.md` 判断当前 `quality_tier`，并在高风险档写入 `required_special_reviews` 3. 确保存在以下门禁： - `design-confirmation` - `logic-confirmation` - `implementation-quality` - `delivery-readiness` - `parity-gate`（reverse-spec 适用） 4. 为每个门禁绑定检查项和证据，至少覆盖契约基准一致性、项目原生静态校验、人工动作显式化和 degraded-path 证据 5. 发现门未通过时，禁止宣称完成 ## 质量判断原则 - 页面像但逻辑错：不通过 - 逻辑对但体验和 IA 明显偏：不通过 - 关键技术栈、目标运行态或不可逆方案未确认：相关门禁不通过 - 只有入口、占位态或 demo，关键能力并不真实可用：不通过 - 未实现或未验证的能力被写成已完成：不通过 - 只有正常路径证据，没有异常 / 空数据 / 权限拒绝 / 超时证据：不通过 - fallback 结果充当正式交付：不通过 - 没有项目原生静态校验证据，且也没有显式记录仓库缺少入口：不通过 - 仍需人工执行 SQL / 重启 / 迁移 / 补数 / 环境变更，却没有在交付说明中显式列出：不通过 ## 危险信号 —— 立即停下 如果你正准备： - 使用上方禁止措辞中的任何表述 - 在跑命令前表达满意 - 准备提交 / 推送 / 创
更新日志: Source: GitHub https://github.com/royeedai/ai-os
还没有评论，快来第一个发言吧。