# 评估标准

用于 code review、交接和 AI 输出自检。

## 必须满足

- 能说明本次改动对应哪个任务。
- 没有超出任务范围。
- 版本、命令、路径和当前代码事实一致。
- 相关构建或测试命令已运行并记录结果。
- 没有提交构建产物、依赖目录或本地配置。

## 代码质量

| 等级 | 标准 |
| --- | --- |
| A | 改动小、边界清楚、测试充分、文档同步、无明显维护风险 |
| B | 功能正确、构建通过、文档基本同步，仍有少量后续优化空间 |
| C | 可运行但边界或错误处理薄弱，需要安排后续任务 |
| D | 构建失败、范围失控、接口不一致或缺少关键验证 |

## UI 质量

| 等级 | 标准 |
| --- | --- |
| A | 布局稳定、信息密度合适、窗口尺寸变化时无溢出 |
| B | 主要路径可用，局部样式可继续优化 |
| C | 功能可用但有明显布局问题或交互不清 |
| D | 关键控件不可用、文本重叠或页面无法加载 |

## 文档质量

| 等级 | 标准 |
| --- | --- |
| A | 文档能直接指导新维护者执行任务和验证 |
| B | 主要事实正确，少量细节需要补充 |
| C | 有导航但缺少真实命令或验收标准 |
| D | 文档与代码冲突，可能误导维护者 |