51 lines
3.0 KiB
Markdown
51 lines
3.0 KiB
Markdown
---
|
||
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) <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` 的授权范围内。
|