polish

name	polish
description	PACE polish stage 专用 skill. 仅 Refactor / System 路径触发. review_pass1 后, ship 前的最终清理段. 清理临时代码 / 完善注释 / 检查冗余 / 低效 / 过度设计. 产出 cleanup-pass-{sprint}.md, 合并 review 意见, stage 由 polish → ship.
effort	high
attach_to_rules	["doc-style","coding-standards"]

/polish — Athena Polish Stage Skill (v9.6.2)

何时触发

• 路径 ∈ {Refactor, System}
• 当前 stage = polish (review_pass1 后, ship 前)
• review_pass1 VERDICT ∈ {PASS, CONCERNS} (FAIL/REWORK 必须先修复)

其他路径 (Hotfix / Bugfix / Quick / Feature) 跳过 polish, 直接 review → ship.

启动检查

主 agent 进入 polish stage 时执行:

# 1. 验证前置条件
test -f .ai_state/details/reviews/sprint-${SPRINT}.md || { echo "无 review_pass1 结果, 不能 polish"; exit 1; }

# 2. 验证 path 适用
PATH_TYPE=$(rg -o 'path: "[A-Za-z]+"' .ai_state/_index.md | head -1)
case "$PATH_TYPE" in
  *Refactor*|*System*) ;;
  *) echo ;  0 ;;



 ~/.claude/rules/doc-style.md
 ~/.claude/rules/coding-standards.md