quality-guidelines.md 2.5 KB
质量规范
版本：基线 1.0（2026-06-12）。依据：PRD §1.4 产品原则 2/5、§5 非功能需求、§7 发布判据；story-repo-spec 0.6 §2.2。
1. 运行时与依赖（硬约束）
1.1 Node ≥ 22；零第三方运行时依赖。新增依赖的 PR 必须被驳回，除非先修订 PRD。
1.2 禁止引入 Python、pip、.env；安装即用，无环境配置步骤。
1.3 开发期依赖（测试框架等）允许，但必须不进入发布产物。
2. 职责分界（宪法级，评审必查）
2.1 脚本能做的归脚本，做不到的归 AI 语义判断：可计数项（字数、频次、格式校验、关键词命中）必须用脚本实现，禁止让模型估算；语义判断（是否真泄密、正文是否写到了某事）必须归 AI，禁止用正则硬凑语义判断。
2.2 机检必须零 token；AI 调用次数每章有预算上限（实现时定数）。
2.3 精准读取：每类数据文件必须配"定位读到所需一段"的脚本接口；写作材料组装默认用片段，禁止默认整文件读取。
3. 编码与平台（CI 强制）
3.1 一切文件 IO 显式 UTF-8 无 BOM；禁止依赖系统 locale。
3.2 Windows 中文环境是一等公民：CI 必须含 Windows 中文路径全链路测试（建库→写章→定稿→重建缓存）。中文路径、中文文件名在任何代码路径上都必须正确处理。
3.3 书仓库初始化必须设置 git config core.quotepath false。
3.4 缩进两空格。
4. 测试要求
4.1 每个 CI 验收项对应 PRD/spec 的一条可验证承诺，最低集合：
- 删光
.cache/全量重建，查询结果不变； - Windows 中文路径全链路；
- 定稿原子性（中途失败时工作区原样保留）；
- 防呆方言（系统写出的 YAML 平铺/块列表/危险值引号）。
4.2 修 bug 必须附回归测试；同一问题第二次出现视为流程缺陷，必须复盘。
5. 评审清单（PR 必过）
- 不新增运行时依赖、不引入 Python
- 作者界面文案符合术语表（PRD §8），无废止词、无机器味
- 错误路径符合错误处理规范（永不带堆栈崩溃）
- 可计数逻辑在脚本里，语义判断不在正则里
- 行为变更先改了文档（PRD/spec），代码与文档一致
6. 待增量补充
- lint / 格式化工具选型与配置（首个代码任务时定）
- 测试框架选型（Node 内置 test runner 候选）与覆盖率要求
- commit message 在开发仓库（本仓库）的前缀约定沿用现状：feat/fix/docs/chore