polish

name	polish
description	PACE polish stage，Refactor/System 强制。review PASS 后做清理并触发 architecture 更新时触发。

/polish — Polish stage (v9.9.6)

触发

最新 reviews/passN.md VERDICT = PASS 且 path ∈ {Refactor, System} → 主 agent 进 polish.

或 next_action = "polish" (主 agent 根据 evaluator 返回结果写入).

5 检查项

#	检查	例
1	临时代码 / 调试痕迹	console.log / print / debugger / TODO/FIXME
2	注释完整性	公开 API 缺 docstring / 复杂逻辑缺解释
3	冗余 / 重复代码	复制粘贴 / 相似函数
4	低效模式	N+1 query / 阻塞 IO / 无谓循环
5	过度设计与过度防御 (铁律[反过度工程])	无消费者的抽象/配置项; 边界内死防御分支 (blanket try-catch / 静默 fallback / 逐层校验); 判据: 删掉后测试仍全绿 = 删

例外

• _index.skip_polish = true: 跳过 polish, 直接 ship (用户自负责)
• 路径 ∈ {Hotfix, Bugfix, Quick, Feature}: 不强制 polish (本身不进 polish stage)

详细 playbook

完整检查项细则、模板与联动见 references/playbook.md —— 按需 Read, 不进热路径。