AE 本地 Agent 入门

适用人群:负责产品数据的 AE 工程师(人手一个本地 Claude Code)。不碰 git 的角色(PM / QA / SCM)不用看本页,走 AE 入门指南里的 Issue 表单路径。
核心体验:你说人话,agent 干活。改参数从"学 YAML + 记流程"变成"说一句话 + 看一眼 diff"。

一次性环境准备(约 10 分钟)

只做一次,以后每天直接用。

bash

# 1. 基础工具(macOS;已装的跳过)
brew install node gh            # Node 18+ 与 GitHub CLI
pip3 install pyyaml             # 校验器依赖

# 2. GitHub 登录(公司账号)
gh auth login                   # 选 github.com → HTTPS → 浏览器登录

# 3. 安装 Claude Code 并登录
npm install -g @anthropic-ai/claude-code
claude                          # 首次启动按提示登录 Anthropic 账号

# 4. 拿代码(以后只需要偶尔 git pull)
git clone https://github.com/conntek-sensors/conntek_design_center.git
cd conntek_design_center
npm install                     # 会自动启用 git pre-push 护栏(防误推 main),属正常现象

日常使用:说人话

在仓库根目录启动 claude,直接说需求。三个真实例子:

例 1 · 改参数

把 KTH5761 的工作电流 typ 改成 1.85mA,依据 datasheet V2.0 第 8.3 节

例 2 · 加封装档位

KTH5502 加一档 AQ2 工业级 SOP-8L 封装,料号 KTH5502AQ2,温度 -40~+105°C,Reel 包装

例 3 · 升级 datasheet

KTH5772 的 datasheet 升到 V1.2,PDF 在 ~/Downloads/KTH5772_DS_CN_V1.2.pdf

agent 会自动完成:定位 YAML → 修改(带出处引用)→ 校验(报错自己修)→ 重生派生文件 → 给你看 diff → 你确认 → 开 PR。

你唯一要认真做的一步:看 diff。 确认两件事:① 数值和你要的一致;② 出处章节号对得上 datasheet。确认无误回一句 "ok" 即可。

边界:你(和你的 agent)能改什么

✅ 允许	❌ 不允许(admin 范畴)
`data/products/**` 产品 YAML	站点代码(theme / config)
`docs/public/downloads/<型号>/` PDF	生成器与脚本(scripts/)
`docs/public/diagrams/<型号>/` 验证图	CI(.github/)与 schema
`r2-assets/<型号>/` 视频大文件	别人 BU 的产品(除非明确协商)

越界的 PR 会被 CI「PR Path Guard」直接红灯,红灯信息里写了怎么处理。确有站点级需求 → 找 @conntek-liyandong。

PR 之后会发生什么

CI 自动跑:数据校验 / 构建 / 全站审计 / 路径检查(约 2 分钟);
AI 预审自动在 PR 下留结构化审核意见(结论 + 问题清单);
admin 看结论合并;合并后 2-3 分钟自动上线,产品页 / 选型矩阵 / AI 问答同步更新。

全程不需要你做任何事,盯着 PR 页面就行。

FAQ

CI 红了怎么办? 把失败日志(或 PR 页面截图)贴给 agent,说"修一下"。报错信息都写了修法,agent 基本能自己搞定。

改错了想撤回? 告诉 agent "关掉这个 PR 并撤销改动"。合并前一切可撤,零风险。

有一批小改动,要开好几个 PR 吗? 不用。一句话说完所有改动(同一产品或同族产品),agent 会合成一个 PR。

权限弹窗特别多? 确认你是在仓库根目录启动的 claude(预置的权限白名单只在仓库内生效)。

agent 问我 datasheet 章节号,我不知道? 打开该产品的 datasheet 查一下再答。这是产品数据的"法律依据",不能空着,也别猜。

不是 macOS 怎么办? Windows 用 winget install OpenJS.NodeJS.LTS GitHub.cli,Linux 用发行版包管理器装 node 与 gh,其余步骤完全相同。团队目前主力验证的是 macOS,其他平台卡住直接找 @李炎东。

15 分钟验收(第一次使用)

[ ] 环境准备四步完成,claude 能启动
[ ] 用例 1 的句式对自己名下产品发起一个真实小改动
[ ] 看懂 agent 给的 diff,确认后 PR 链接出现在终端
[ ] 在 GitHub 上看到 CI 全绿 + AI 预审 comment

卡在任何一步超过 5 分钟 → 钉钉找 @李炎东。

AE 本地 Agent 入门 ​

一次性环境准备(约 10 分钟) ​

日常使用:说人话 ​

边界:你(和你的 agent)能改什么 ​

PR 之后会发生什么 ​

FAQ ​