升级产品规格书:8 步搞定 Upgrade a datasheet from your laptop to production · 15 minutes
以 AE @liaochongqi 升级 KTH5774 datasheet V1.3 → V2.0(BU1 产品)为例,从准备 PDF 到线上生效的完整流程。流程对所有 BU 通用。不需要 git、不需要 markdown、不需要碰任何代码。
一次性准备(5 分钟,只做一次) Once and done
进 repo 拿权限
钉钉 @ 管理员:"我 GitHub 是 @liaochongqi,把我加进 conntek_design_center repo,角色 Write"
每次更新:8 步流程 Step-by-step
本地准备 PDF
把新版 KTH5774 datasheet PDF 准备好,记住版本号(如 V2.0)+ 文件大小(MB)。
典型场景:CN 版 + EN 版各 1 个 PDF。
把 PDF 传到内部 archive(推荐)
浏览器打开内部 Gitea:http://10.10.10.218:3000/liyd/bu1-product-archive
- 导航到
products/KTH57/KTH5774/datasheet/ - 点 "上传文件" → 选
KTH5774_DS_CN_V2.0.pdf(及其它版本) - commit message:
feat(KTH5774): add datasheet V2.0 - push
在 GitHub 发 Issue
打开 📋 产品规格更新模板,填表:
| 字段 | 填什么(示例) |
|---|---|
| 型号 | KTH5774 |
| 所属 BU | BU1 (KTH5774 属 BU1;实际填写按你产品的归属) |
| 变更类型 | 更新文档/datasheet 链接(documents) |
| 具体改什么 + 数值 | Datasheet 升级到 V2.0(从 V1.3)。CN + EN 两个版本,已上传到 archive。主要变更: • 灵敏度典型值 25 → 28 mV/G • 新增 SOP-8 封装变体 |
| 数据来源 | http://10.10.10.218:3000/liyd/bu1-product-archive/src/main/products/KTH57/KTH5774/datasheet/ |
| 附件 / 配图 | (选填)拖 pinout 图、应用电路图等 |
| 首页展示策略 | ☑ 更新 launched_at(进 /news/) |
| 希望多久上线 | (空,或写"2026-06-01 前") |
点 Submit。GitHub 自动加标签 type:spec-update / bu:BU<N> / needs:claude,自动 @ 你 + 对应 BU 的 PM。
钉钉 @ 管理员告知 Issue 号
对应 BU 的 AE 钉钉群里 @ 管理员:
"#issue 12 麻烦走一下,KTH5774 datasheet 升级 V2.0"
试跑阶段必须手动 ping,以后会上钉钉机器人自动转发。
等 Claude Code 起 PR(后台,5-15 分钟)
你不用做任何事。Claude 拿到 Issue 后自动:
- clone bu1-product-archive,找到 V2.0 PDF
- 拷到设计中心
docs/public/downloads/KTH5774/ - 改
data/products/BU<N>/<PN>.yaml(本例:BU1/KTH5774.yaml)4-5 个字段 - 跑
npm run sync-matrix(矩阵 + 链接 + 下载自动重生) - push,开 PR,自动 @ 你 + 对应 BU 的 PM
你会在 GitHub 邮箱收到 review 请求邮件。
看 Preview(关键!3-5 分钟)
邮件链接进 PR → 评论里有个 cloudflare-workers-and-pages bot 留言,贴了 Preview URL,类似:
https://issue-12-kth5774....conntek-design-center.pages.dev
点开 → 导航到 /products/3d-hall/KTH5774/,看真实上线效果:
- ✓ 资源下载区显示 V2.0(不是 V1.3)
- ✓ 点 CN/EN 都能下到对应 PDF
- ✓ 灵敏度新值显示正确
- ✓ Hero 部分各项参数对得上
Review · Approve 或 Comment
✅ 全对
点 Files changed 标签 → Review changes → 选 Approve → Submit。
💬 有错
在错误行点 "Add a suggestion" 直接改文字。
或者在 PR 评论里说"灵敏度应该是 30 不是 28,麻烦改一下"。Claude 收到 comment 会自动改并 push 新 commit。
等 PM Approve → Merge → 上线
对应 BU 的 PM 关心命名 / 定位 / 是否要发新闻,他也会 Approve 或 comment。
双方都 Approve 后,任一人点 Squash and merge(GitHub 三个 merge 选项里选这个 —— 一个 PR 在 main 上表现为 1 个 commit,干净)。
2-3 分钟后:
chat.connteck.com/products/3d-hall/KTH5774/显示 V2.0 ✓- 选型矩阵自动更新 ✓
- AI 助手
/chat/知道新版本 ✓ - llms-ctx.txt 同步重生 ✓
谁干啥,各花多久 Who does what, how long
| 角色 | 干啥 | 耗时 |
|---|---|---|
| liaochongqi(AE) | 上传 PDF 到 archive | 5 分钟 |
| liaochongqi(AE) | 发 Issue | 3 分钟 |
| liaochongqi(AE) | 钉钉 @ 管理员 | 30 秒 |
| Claude Code | 起 PR(后台,无需操作) | 5-15 分钟 |
| liaochongqi(AE) | 看 Preview + Approve | 5 分钟 |
| 对应 BU 的 PM | 看定位 + Approve | 2 分钟 |
| 自动化 | Merge → 部署 → 线上生效 | 2-3 分钟 |
AE 实际花费 ~15 分钟,全程不写一行 git 命令、不碰 YAML、不动 Vue。
实操中可能遇到的疑问 Real questions from AE
Q1. 我能不能跳过 archive,直接拖 PDF 到 Issue?
可以(方式 B),Claude 会从 GitHub attachment URL 下载。但 archive 还是建议传一份,作为权威归档 —— 以后查历史版本时方便。
Q2. Issue 模板里勾错了"上首页"怎么办?
PR 评论说一下,Claude 改 YAML 的 featured 字段即可。或者你也可以在 PR diff 里点击直接改 YAML 字段(GitHub 网页支持直接编辑文件)。
Q3. 我没 PM 怎么 Approve?
试跑阶段 你一个人 Approve 即可。真实推广后需对应 BU 的 PM 也 Approve,你可以钉钉催。如果 PM 长期不在,管理员可以 Override Merge(留下记录)。
Q4. 上线后发现还有错怎么办?
再发一个 Issue,15 分钟改完上线。git 历史保留,可以回滚任何一次改动。不用担心。
Q5. 同时改 2 个产品怎么办?
发两个 Issue。Claude 会开两个 PR 互不干扰。一个 Issue 只对应一个产品,出错也好回滚。
Q6. Preview URL 显示的是旧版本?
等 1-2 分钟,CF Pages 部署需要时间。Cmd+Shift+R 强刷一下。还不行就在 PR 评论说一声,可能是 build 失败 —— Claude 会去 CF dashboard 看 log 重修。
Q7. Merge 选哪个? Create / Squash / Rebase?
永远选 Squash and merge。这样 main 历史就是"1 行 = 1 个业务变更",看历史 / 回滚都最方便。
Q8. 我能不能不发 Issue,直接联系 Claude 改?
不能。Issue 是 正式留痕 + 自动审签链 + 自动跟踪状态 的入口。直接联系会跳过审签 / 跟踪 / 回溯。流程上必须走 Issue。