--- description: 提交 → 推 main → 部署到生产(控制面 + 卫星热部署),一条龙 argument-hint: "[可选的提交说明或补充要求]" --- # /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) `。 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` 的授权范围内。