完成前验证
概述
在声明"完成"之前,必须逐项过这个验证清单。任何一项不通过 = 未完成。
开始时声明: "我将用 verification-before-completion 技能做最终验证。"
验证清单
1. 测试验证
- 所有测试通过(全量套件,非仅新增)
- 新增测试覆盖所有新功能
- 边界情况和错误路径有测试
- 测试用真实代码(mock 只在不可避时)
# Python
pytest -q --cov
# Node/TS
pnpm test -- --coverage
2. 规范合规
- 所有规格要求已实现
- 没有规格外的功能(YAGNI)
- 行为和设计文档描述一致
3. 代码质量
- 无死代码
- 无重复代码(DRY)
- 命名清晰
- 错误处理完整
- Lint 干净
# Python
ruff check .
# Node/TS
npx eslint .
4. 文件整洁
- 无临时文件、调试日志
- 无注释掉的代码
- 无
console.log/print遗留
5. 文档同步
- 相关文档已更新
- 如有 README,已反映变更
- 如有 API 变更,已记录
6. Git 状态
- 所有变更已提交
- 提交信息清晰
- 无遗漏的未跟踪文件
git status
git log --oneline -5
不通过的处理
任何一项不通过:
- 列出问题清单
- 逐项修复
- 重新运行完整验证
- 全部通过后才说"完成"
通过后
- 移交
finishing-a-development-branch做分支收尾