快速开始

前置

• Claude Code（核心路由模型需是多模态长文本，如 Claude；队友 lane 可接 DeepSeek / GLM 的 API）
• Python 3 + git；可选 graphviz（渲染接线图）、C 编译器（固件主机自测）

1. 拉取仓库

git clone https://github.com/Jinchen-Yang/diansai-skill.git
cd diansai-skill

（国内可用 Gitee 镜像：https://gitee.com/yanjingc/electric-race-skill.git）

2. 装 host 依赖并自测

sh tools/bootstrap.sh      # 装运行工具所需的 Python 依赖（无 LLM 依赖）
sh tools/selftest.sh       # 一键自测，9 项应全绿

selftest.sh 会验证：协议两端一致、引脚门、供电门、接线图渲染、固件主机测试、跨语言契约、任务板 DAG。

3. 初始化任务板

python3 tools/board.py init

每台机器在仓库根建 .elec-lane（写 lead / 硬件 / 控制 / 算法，不入库）声明本机角色。

4. 比赛时：投喂题目与配件表

inputs/problem/      ← 放当年官方题目（PDF / 文本）
inputs/partslist/    ← 放主办方配件表

5. 在 Claude Code 里跑流水线

命令	作用
/elec-design	顶层编排：看全流程、当前该做哪一步、三 lane 怎么并行
/board	看派给本 lane 的就绪任务、领取、完成（自动交接）、推送
/read-problem	读题 → design/problem.yaml
/plan-solution	方案 + 签字需求表
/setup-env	三 lane 环境/工具链清单
/select-parts	从配件表选材 → design/bom.csv
/power-design	供电设计（按堵转电流算）
/interconnect	模块接线图 + 引脚映射
/firmware-scaffold	固件骨架
/vision-scaffold	K230 视觉骨架
/test-checklist	现场标定/验收清单

6. 近实时盯任务板（可选）

# Claude 原生：每 5 分钟 pull + 看板
/loop 5m /board
# 或纯终端：
sh tools/watch.sh 控制 300

看个真实样例

仓库里 examples/sending-medicine-2023/ 是一条端到端走查（题目 → 方案 → BOM → 供电 → 引脚 → 接线图 → 固件 → 视觉 → 验收清单），全部经 selftest.sh 验证。