Files
streamline/.claude/commands/cpd.md
T
2026-11-16 17:26:44 -08:00

51 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
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` 的授权范围内。