质量标准规范 (Quality Standard)
质量标准 (skills/references/quality.md) 定义了在 tdd、review、ship、archive 及 onboard 中强制执行的质量标准。
三维质量校验
每次实现和重构循环都必须从以下维度进行严格校验:
1. 机械化检查 (Mechanical Checks)
- Lint 规则完全通过且零 Warning。
- 代码格式符合项目配置。
- 类型检查(Typecheck)完全通过,不使用
any绕过或抑制类型错误。
2. 约定遵循 (Convention Adherence)
- 严格遵循规范(
convention:)中声明的项目约定与技术栈最佳实践。 - 评估惯用结构、错误处理模式及命名规范。
3. 设计评估 (Design Assessment)
- 高内聚低耦合:函数与类具有高度内聚性,模块间耦合最小化。
- 抽象层级适度:防止过早或不必要的抽象;实现在满足契约前提下保持极致简洁。
4. 文档覆盖率 (Documentation Coverage)
- 所有公共函数、API 接口、导出定义、环境变量及异常模式均具备准确文档。
README.md中的命令与示例保持可运行且最新。- 未同步更新文档的代码修改将无法通过 Code Review。