Files
2026-11-16 17:26:44 -08:00

3.0 KiB
Raw Permalink Blame History

description, argument-hint
description argument-hint
提交 → 推 main → 部署到生产(控制面 + 卫星热部署),一条龙 [可选的提交说明或补充要求]

/cpd — commit, push, deploy

把当前工作区的改动一路送到生产:验证 → 提交 → 推 main → 部署控制面 → 推卫星节点。

用户输入的额外说明(可能为空):$ARGUMENTS

这条命令本身就是授权。 CLAUDE.md 要求写操作先确认,用户敲下 /cpd 即已确认这次 提交、推 main 和部署;不要再问一遍"要不要执行"。但下面每一步的失败都要停下来报告, 不要绕过。

步骤

  1. 先看清楚再动。 git status + git diff(含已暂存)。只提交本次工作相关的改动; 看到不属于这次任务的文件,列出来问,不要顺手打包进去。

  2. 验证。 至少跑 bun run typecheck(shared / control-server / satellite / control-web 四个包)和 bun run build(前端)。有失败就停在这里修好, 不要"先提交再说"。

  3. 提交。 提交信息用中文,遵循仓库惯例 [类型] 一句话摘要(Feat / Fix / Refactor / Tool / Chore),正文说明为什么这么改、以及踩过的坑,而不是复述 diff。结尾带上 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>。

  4. rebase 到最新的 main 再推。 origin/main 经常在你干活时前进了好几个提交: git fetch origin main 然后 git rebase origin/main,冲突就停下来报告,别硬解。 rebase 之后重跑一次 typecheck + build——上游动过的文件可能和你的改动打架。

  5. 推到 main。 就在 main 上时 git push origin main;在 worktree / 特性分支上时 git push origin HEAD:main,并把分支本身也推一份留痕。永远不要 --force:被拒绝就 重新 fetch + rebase。

  6. 部署。 走 streamline-deploy skill:bash .claude/skills/streamline-deploy/deploy.sh。 它自己做完:devbox 拉代码 → 构建前端 → 重启 streamline-server → 验证 asset hash → 重建卫星 bundle → 推到 3 台卫星节点(忙节点自动走「空档部署」,不打断在跑的任务)。 脚本在预检阶段会挡住脏工作区之类的问题;报错就照它的提示处理,不要自己手搓 ssh 命令 (SKILL.md 里那六个反直觉的点都是踩出来的)。

汇报时必须说清楚的

  • 控制面到底跑在哪个 commit 上了。
  • 卫星节点的真实状态:换装重启了、还是「已排队」等空档?排队的节点仍在跑旧代码, 直到它当前的任务结束——这时候说"已全量上线"是错的。有节点离线也要点名,它回来后 不会自动补装。
  • 改了 prompt / 报告生成逻辑的话:历史数据不会被追溯重写,需要回填;而回填是对线上 记录的写操作,必须另行征得用户同意,不在 /cpd 的授权范围内。