黄金原则（Entropy / Garbage Collection）

Status: Active Updated: 2026-02-25

目标

把“人类品味”一次性沉淀为可执行规则，持续对抗代码库熵增，而不是周期性大扫除。

核心原则

1. 优先共享能力，不重复造轮子

• 倾向复用共享工具包与统一抽象。
• 禁止在业务域零散复制手写 helper 破坏一致性。

2. 禁止 YOLO 式数据探测

• 不允许基于“猜测结构”的访问方式。
• 必须通过边界校验、Schema、typed SDK 或明确契约读取数据。

3. 小步清理，持续偿还

• 每次清理变更保持小而可审阅。
• 优先可以在 1 分钟内完成审阅的定向改造。

4. 规则先于口头约定

• 发现重复问题后，优先补规则、脚本或 lint，而不是只修一次代码。
• 规则必须进仓库、可追踪、可复用。

5. 每天治理，而非周末“还债日”

• 通过周期任务持续扫描漂移。
• 及时修复，避免坏模式在数周内扩散。

Garbage Collection Agent 职责

1. 扫描偏离黄金原则的代码与文档模式。
2. 生成清理报告与可执行重构清单。
3. 必要时更新 docs/quality/domain-grades.md 与 docs/quality/verification-status.md。
4. 高风险漂移无法安全修复时，返回 retry 并给出最小下一步。

最小验收标准

• 每次交付流水线后至少产生一条“可执行清理建议”（即使无改动也要有“无漂移”结论）。
• 质量评分文档能反映最近一次清理结果。
• 同类问题复发时，必须新增机械约束（脚本/lint/检查项）而非重复人工提醒。