用途:dev-verify 是开发工作流的验证阶段(Phase 7),在用户要求“验证完成”“确认测试通过”“确认功能可用”时使用。核心原则是:没有全新验证证据,不得声称完成。
主要能力:
- 验证门(Gate Function):先确定哪条命令能证明断言,再全新执行、读取完整输出与退出码、确认输出支持结论,最后才下结论。
- 证据分级:结构证据(grep、文件存在、函数已定义)只证明代码存在,不证明可运行;日志、退出码属于可观测性,不等于验证。面向用户的声明需要 E2E 证据,单元测试不足。
- GUI 应用门:BUILD、LAUNCH(带文件日志)、WAIT、CHECK PROCESS、READ LOGS(强制不可跳过)、VERIFY LOGS,之后才做 E2E 测试或截图。
- 约束检查:运行 uv run python3 ${CLAUDE_SKILL_DIR}/../../references/constraints/check-all.py .,失败为硬阻塞,需先修复;通过后把运行器摘要行记入 .planning/LEARNINGS.md。
- 目标回溯验证:技术测试通过后,派生只读的 dev-verifier 子代理,对照 .planning/SPEC.md 的成功标准逐条验证,输出 GOAL、REQUIREMENT、STATUS、EVIDENCE。
- 用户验收:用 AskUserQuestion 询问需求是否满足;若回答“部分”或“否”,回到 dev-implement 修复,并强制重新调用 dev-verify、重跑全部验证门。迭代记录在 .planning/VERIFY_STATE.md,3 次未通过则升级询问。
使用方式:先检查剩余上下文(>35% 继续;25-35% 先完成当前步骤再调用 dev-handoff;≤25% 立即调用 dev-handoff)。加载适用于 dev-verify 的约束,重新读取 .planning/SPEC.md,然后按上述门与子代理流程执行。
适用场景:功能完成前的最终验证、回归测试、构建检查、面向用户功能的 E2E 确认。
限制:验证阶段为只读,不修改文件;子代理不得使用 Write 或 Edit;不得用缓存结果、假设、部分检查或代理报告替代独立确认;用户反馈后未重新验证不得声称完成。具体命令示例与脚本路径以资料为准。