polish

name	polish
description	PACE polish stage. Refactor/System 路径强制. 5 检查项 + worktree 清理 + 触发 architecture 更新. v9.6.4 升级: 加 finishing-a-development-branch 流程 (借 Superpowers), 加 compound/ 触发.

/polish — Polish stage (v9.9.2, Codex)

触发

最新数字 passN VERDICT = PASS 且 path ∈ {Refactor, System} → 主 agent 进 polish；CONCERNS 不得进入 polish/ship.

或主 agent 根据 evaluator VERDICT 设置 next_action = "polish".

5 检查项 (沿用 v9.6.2)

#	检查	例
1	临时代码 / 调试痕迹	console.log / print / debugger / TODO/FIXME
2	注释完整性	公开 API 缺 docstring / 复杂逻辑缺解释
3	冗余 / 重复代码	复制粘贴 / 相似函数
4	低效模式	N+1 query / 阻塞 IO / 无谓循环
5	过度设计	YAGNI 违反 / 没必要的抽象

v9.6.4 新增: finishing-a-development-branch (借 Superpowers)

polish 完成后 必须:

# Step 1: 跑测试验证
npm test  # 或 pytest / cargo test / ...
# 若失败 → 回 impl

# Step 2: 提示用户选项
echo "polish 完成. 选择:"
echo "  [1] merge 到主分支"
echo "  [2] 创 PR"
echo 
 
 choice

  
  1) git checkout main && git merge worktree-{slug} ;;
  2) gh  create --base main ;;
  3)   ;;
  4) git worktree remove --force ../worktree-{slug}
     git branch -D worktree-{slug} ;;



[  !=  ] && git worktree remove  2>/dev/null