菜单
PACE polish stage. Refactor/System 路径强制. 5 检查项 + worktree 清理 + 触发 architecture 更新. 含 finishing-a-development-branch 流程 (借 Superpowers) + compound/ 触发.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | polish |
| description | PACE polish stage. Refactor/System 路径强制. 5 检查项 + worktree 清理 + 触发 architecture 更新. 含 finishing-a-development-branch 流程 (借 Superpowers) + compound/ 触发. |
| effort | high |
review_pass1 VERDICT ∈ {PASS, CONCERNS} 且 path ∈ {Refactor, System} → 主 agent 进 polish.
或 next_action = "polish" (evaluator 写入).
| # | 检查 | 例 |
|---|---|---|
| 1 | 临时代码 / 调试痕迹 | console.log / print / debugger / TODO/FIXME |
| 2 | 注释完整性 | 公开 API 缺 docstring / 复杂逻辑缺解释 |
| 3 | 冗余 / 重复代码 | 复制粘贴 / 相似函数 |
| 4 | 低效模式 | N+1 query / 阻塞 IO / 无谓循环 |
| 5 | 过度设计 | YAGNI 违反 / 没必要的抽象 |
polish 完成后 必须:
# Step 1: 跑测试验证
npm test # 或 pytest / cargo test / ...
# 若失败 → 回 impl
# Step 2: 提示用户选项
echo "polish 完成. 选择:"
echo " [1] merge 到主分支"
echo " [2] 创 PR"
echo " [3] 继续工作 (留 worktree)"
echo " [4] 丢弃 (回滚 worktree)"
read choice
case "$choice" in
1) git checkout main && git merge worktree-{slug} ;;
2) gh pr create --base main ;;
3) echo "保留 worktree, 主 agent 继续" ;;
4) git worktree remove --force ../worktree-{slug}
git branch -D worktree-{slug} ;;
esac
# Step 3: 清理 worktree (若 1/2/4 选择)
[ "$choice" != "3" ] && git worktree remove "$wt_path" 2>/dev/null
Task(
subagent_type="polish_worker",
prompt="""
Polish sprint {slug}. Refactor/System 路径.
检查 5 项: 临时代码 / 注释 / 冗余 / 低效 / 过度设计.
读 sprints/{slug}/reviews/pass1.md 处理 P1/P2 findings.
完成后:
1. 写 sprints/{slug}/cleanup-pass.md
2. 触发 finishing-a-development-branch (跑测试 + 用户选 merge/PR/继续/丢弃)
3. 触发 compound/ 沉淀 (learning + decision)
4. (若 ≥5 文件改动) 提示 /architect-doc update
""",
)
从 templates/sprints/cleanup-pass.md 复制, 填实际内容. 必含段:
## 5 检查项## Finishing-a-development-branch (借 Superpowers)## review 意见合并 (P1/P2 处理)## 归档到 compound/ (触发 learning + decision)## VERDICT (Pass / Concerns)polish 完成时, 主 agent 询问:
本 sprint 产生哪些值得沉淀的经验?
[1] learning (踩坑教训)
[2] trick (可复用模式)
[3] decision (技术决策)
[4] explore (调研结论)
[5] 全跳过
[m] 多选
选: _
按选择触发对应 /compound add {type} {slug}, 从 ~/.claude/skills/compound/templates/ 模板创建.
# delivery-gate 会在 ship 前强制检查, 这里主动触发
changed=$(jq '. | length' < .ai_state/sprints/{slug}/evidence.yaml 2>/dev/null || echo 0)
if [ "$changed" -ge 5 ]; then
echo "改动 $changed 文件, 触发 /architect-doc update"
read ~/.claude/skills/architect-doc/SKILL.md
fi
写 _index.next_action = "ship".
主 agent 下一 turn 进 ship stage.
ship 时 delivery-gate 会检查:
cleanup-pass.md 存在architecture/ 已更新 (≥5 文件改动时, 铁律[架构])design_changed_after_impl != true不满足任一 → block.
_index.skip_polish = true: 跳过 polish, 直接 ship (用户自负责)| 维度 | review | polish |
|---|---|---|
| 目标 | 找问题 | 清扫 + 沉淀 |
| 改代码? | 不改, 只评论 | 改 |
| subagent | reviewer + spec-compliance + evaluator | polish_worker |
| 产出 | reviews/pass1.md | cleanup-pass.md + compound/ + architecture/ 更新 |
| worktree? | read-only | 沿用 impl 的 worktree |
Athena 全局首次配置 (跨项目, 一次性). 从分发包部署 settings/config/rules/standards/hooks/agents/skills 到 ~/.claude/ (CC) 与 ~/.codex/ (CX). 和 athena-init 区别: setup 全局一次性, init 每项目一次. 已装则转 verify/upgrade (走 athena-migrate).
会话记忆固化 skill (v9.8.0 新). 会话结束/中途, agent 自己总结本会话增量写进 .ai_state (_index.md 当前状态 + sprints/{slug}/session-log.md), 免去用户每次手动描述一堆让它存. 手动 /checkpoint 触发. 与 compact-snapshot hook 互补 (hook 机械兜底, skill 做需推理的总结).
Athena 主入口 skill. 接收用户任务, 做 PACE 路由分诊 (brainstorm/roadmap/plan/...), 启动对应 stage. v9.7.0: 铁律引用名称化 (CC/CX 编号非对称, 引用一律用 铁律[名称]).
Athena 项目初始化 skill. 在项目中执行 /athena-init 时调用. 职责: 探测平台 / 工具可用性, 创建 .ai_state/ 目录 + 复制 _index.md 模板 + 填入探测结果.
Bugfix 路径的结构化问题流程: report → analyze → fix-note 三件套档案, 落在 sprints/{slug}/. 把"偏轻"的 Bugfix 升级成可复现 / 可追溯 / 可复盘. 借 CodeStable issue 实体, 适配 agent-in-loop.
Athena 版本迁移工具. v9.6.4 重写: 含 v9.6.2 → v9.6.4 破坏式重构 (sprints/ + compound/ + 4 新 ai_state 文件 + lessons.md 三选项交互).