AE 上手指南（5 分钟）

你不需要懂 YAML / Git / CI —— 只需要在本地装好 Claude Code，用中文说清楚要改什么就行。

一次性准备

1. 装 Claude Code（Cursor 扩展 / VS Code 扩展 / 桌面版 / CLI 任选一）
2. 克隆本仓到本地：

   git clone https://github.com/conntek-liyandong/conntek_design_center_BU1.git
   cd conntek_design_center_BU1

3. 在 Claude Code 里打开这个目录。skill 会自动加载。

日常改数据（90% 的情况）

直接用自然语言告诉 Claude 要改什么，例如：

• "把 KTH7801 的典型工作电流改成 11.2 mA"
• "给 KTH5502 加一档 AQ2 工业级封装，部件号 KTH5502BQ2QNS，温度 -40~+105°C"
• "KTH3601 停产了，把状态改成 eol"
• "KTH5772 的 datasheet 换成 v1.2 版"
• "新增 KTH9999 产品，参考 KTH5772 的格式，datasheet 路径 datasheet_md/070501-BU1/..."

Claude 会自动：

1. 找到对应的 YAML 文件
2. 按 schema 修改（不越界）
3. 跑本地校验（scripts/validate-products.py）
4. 把 diff 给你看
5. 问你"是否要开 PR？"
6. 同意后帮你开 PR

PR 开出来之后

1. GitHub 自动跑 Schema + cross-ref check —— 几秒后出结果
   • ✅ 绿 = 可以合并
   • ❌ 红 = 有字段没写对，点"Details"查看具体哪一行；告诉 Claude 让它再改一版
2. 你自己或同 BU 同事 Approve —— 参考 .github/CODEOWNERS 看你能审哪些产品
3. 合并 到 main
4. 2-3 分钟后 AI Chat / 产品页自动用上新数据
   • 查看部署进度：https://github.com/conntek-liyandong/conntek-aibridge/actions

遇到这些情况找 @lyd639827127

• schema 字段不够用（比如要加一个从来没有的参数维度）
• 想做跨 BU / 跨产品线的批量改动
• PR 的校验器提示你不会修
• 竞品替代（cross-reference）数据
• 新建 BU / 新建产品类别

调试技巧

在 Claude Code 里本地预检（不推到 GitHub）：

python3 scripts/validate-products.py --files data/products/BUx/YOURPART.yaml

看 PR 给你标了什么问题： 打开 PR → "Files changed" tab → 红色 / 黄色图标直接在 diff 行上。

看自动部署是否跑完： https://github.com/conntek-liyandong/conntek-aibridge/actions → 找最近一次 "Redeploy from YAMLs" → 绿勾 = 已上线。

进一步阅读

• GOVERNANCE.md —— 详细流程、审批规则、分支保护
• .claude/skills/product-data/SKILL.md —— Claude 在处理你的请求时遵循的规则（技术同学可看）
• data/schema/product.schema.yaml —— YAML 字段规范（技术同学可看）