docs: add harness coding documentation

2026-07-08 15:27:21 +08:00
parent e5d10577c0
commit d2eeb049d0
24 changed files with 1119 additions and 0 deletions
@@ -0,0 +1,38 @@
+# 评估标准
+
+用于 code review、交接和 AI 输出自检。
+
+## 必须满足
+
+- 能说明本次改动对应哪个任务。
+- 没有超出任务范围。
+- 版本、命令、路径和当前代码事实一致。
+- 相关构建或测试命令已运行并记录结果。
+- 没有提交构建产物、依赖目录或本地配置。
+
+## 代码质量
+
+| 等级 | 标准 |
+| --- | --- |
+| A | 改动小、边界清楚、测试充分、文档同步、无明显维护风险 |
+| B | 功能正确、构建通过、文档基本同步，仍有少量后续优化空间 |
+| C | 可运行但边界或错误处理薄弱，需要安排后续任务 |
+| D | 构建失败、范围失控、接口不一致或缺少关键验证 |
+
+## UI 质量
+
+| 等级 | 标准 |
+| --- | --- |
+| A | 布局稳定、信息密度合适、窗口尺寸变化时无溢出 |
+| B | 主要路径可用，局部样式可继续优化 |
+| C | 功能可用但有明显布局问题或交互不清 |
+| D | 关键控件不可用、文本重叠或页面无法加载 |
+
+## 文档质量
+
+| 等级 | 标准 |
+| --- | --- |
+| A | 文档能直接指导新维护者执行任务和验证 |
+| B | 主要事实正确，少量细节需要补充 |
+| C | 有导航但缺少真实命令或验收标准 |
+| D | 文档与代码冲突，可能误导维护者 |