# 质量标准规范 (Quality Standard)

质量标准 (`skills/references/quality.md`) 定义了在 `tdd`、`review`、`ship`、`archive` 及 `onboard` 中强制执行的质量标准。

## 三维质量校验

每次实现和重构循环都必须从以下维度进行严格校验：

### 1. 机械化检查 (Mechanical Checks)
- Lint 规则完全通过且零 Warning。
- 代码格式符合项目配置。
- 类型检查（Typecheck）完全通过，不使用 `any` 绕过或抑制类型错误。

### 2. 约定遵循 (Convention Adherence)
- 严格遵循规范（`convention:`）中声明的项目约定与技术栈最佳实践。
- 评估惯用结构、错误处理模式及命名规范。

### 3. 设计与边界评估 (Design & Boundaries)
- **依赖单向性（Inward Dependencies）**：核心业务逻辑严禁直接依赖易变的 I/O、UI 或数据库适配器。
- **副作用隔离（Isolated Side-Effects）**：纯计算与业务决策与 I/O 读写及状态突变明确隔离。
- **高内聚与极简（Cohesion & Simplicity）**：单函数/单模块职责单一；消除臃肿函数与泄露的抽象。

### 4. 文档覆盖率 (Documentation Coverage)
- 所有公共函数、API 接口、导出定义、环境变量及异常模式均具备准确文档。
- `README.md` 中的命令与示例保持可运行且最新。
- 未同步更新文档的代码修改将无法通过 Code Review。