1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | legacy-circuit-mockups |
| 项目自述名称 | Legacy Circuit Mockups |
| 作者/维护者 | John Haugabook（GitHub: jhauga），个人贡献者，合集仓库归属 GitHub 官方组织 |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/legacy-circuit-mockups |
| 许可证 | MIT（仓库级，来自 GitHub API） |
| GitHub Stars / Forks | 合集仓库整体 39,302 / 5,004（来自 GitHub API）；该数字属整个合集，不代表本技能自身热度 |
| 第三方装机量 | skills.sh 收录，9.0K 次安装（截至查询时） |
| 最新版本 | 无语义化版本号；最近一次内容维护提交 2026-08-07（修复引用与格式问题） |
| 安装方式 | npx skills add https://github.com/github/awesome-copilot --skill legacy-circuit-mockups，或手动复制 skills/legacy-circuit-mockups/ 目录（含 SKILL.md 与 20 份 references 参考文件）到 agent 的 skills 目录 |
2. 功能介绍与亮点
该技能教 agent 用 HTML5 Canvas 绘制面包板电路模型图与元件布局示意图，服务复古计算机自制（如 6502 单板机）、555 定时器电路、TTL 逻辑门电路等电子爱好者场景。核心能力：
- 元件库覆盖广：内置 W65C02S 微处理器、28C256 EEPROM、W65C22 VIA、62256 SRAM 等复古芯片，以及 555 定时器、7400 系列逻辑门、LED/电阻/电容/晶振/开关等基础元件的引脚定义与渲染规格。
- 结构化渲染规范：给出网格系统、元件坐标结构、导线连接格式的统一 JSON/JS 描述方式，便于 agent 生成可复用的 Canvas 绘图代码。
- 配套公式与故障排查：内置欧姆定律、555 定时器振荡频率公式、LED 正向压降表、导线配色约定，以及一份常见电路故障排查表。
- 20 份独立参考文档：每个元件（555、6502、6522、28256-EEPROM 等）都有单独的 references 文件，另含汇编语言/编译器、EEPROM 烧录器（minipro、T48）等配套资料，文档深度远超一般单文件 skill。
主要亮点：内容由具名个人贡献者提交，经过多轮 GitHub Copilot 代码审查（Apply suggestions from code review）迭代打磨，并非一次性批量生成；仓库本身持续活跃维护（最近推送为查询当日）。
3. 适用场景
所属分类：数据分析与可视化（该技能产出电路结构图与可视化布局，与库内 excalidraw-diagram-generator、antv-g2-chart 等图表/图解类技能同类，经 --neighbors 核验，32 条命中中 19 条落在本分类，含同仓库的 excalidraw-diagram-generator 直接先例）。
具体场景：
- 电子爱好者搭建 Ben Eater 风格的 6502 复古计算机项目时，用 agent 生成面包板接线示意图
- 教学场景中为 555 定时器、TTL 逻辑门等基础电路生成可视化讲解图
- 电子项目文档编写者需要为博客/教程配套结构化电路布局图
- 受益人群：硬件爱好者、电子工程入门学习者、技术教程作者
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——纯 Markdown 指令 + 参考文件，符合 Agent Skills 规范，放入 skills 目录即可被发现
- Codex：⚠️ 需适配——Codex 不会自动扫描
~/.codex/skills，需在对话中手动引用 SKILL.md 路径 - OpenClaw：❓ 未验证——未找到官方文档说明其 skills 发现机制
- Hermes Agent：✅ 原生支持——按路径扫描子目录探测 SKILL.md，兼容合集仓库的嵌套目录结构
判断依据：技能本身无 MCP 依赖、无需外部工具，纯文本指令+参考文档，兼容性瓶颈仅在于各 agent 的 skills 发现机制本身，非该技能设计所限。
5. 推荐理由
同类图表/图解生成工具大多面向软件架构、数据流程或 UI 原型，专精电路/面包板可视化这一硬件爱好者场景的并不常见。该技能内容详实（20 份独立参考文件覆盖元件规格、公式、故障排查），经多轮具名审查打磨，第三方平台 9.0K 次独立安装验证了真实需求，且技能本身零代码执行、零外部依赖，安全画像干净。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 第三方平台 skills.sh 记录 9.0K 次独立安装（合集子技能场景下，安装量是仓库 star 数之外的独立热度证据） |
| 可用性 | 9 | SKILL.md 内容完整含分步示例、公式与故障排查表，20 份参考文件覆盖每个元件；零外部依赖、零付费依赖；最近一次维护在查询前约 47 天，仓库整体查询当日仍有推送 |
| 安全性 | 9 | 纯文本指令 + Canvas 绘图代码生成，无 shell 执行、无网络外发、无需任何凭据；MIT 许可证明确；作者为具名个人贡献者，提交历史显示经多轮代码审查迭代，无刷量或误导性措辞迹象 |
综合评分：8.67
安全检查清单逐项结果：① 不执行 shell 命令 ② 运行时不联网外发数据（纯本地生成 Canvas 绘图代码）③ 不要求任何 API key 或凭据 ④ SKILL.md 与参考文件中未发现可疑指令或隐蔽外发 ⑤ 作者为具名个人开发者，提交记录显示真实迭代过程，无造假迹象 ⑥ MIT 许可证明确 ⑦ 最近维护发生在约 47 天前，仓库整体持续活跃。
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| excalidraw-diagram-generator | 通用 Excalidraw 风格图表生成（流程图、架构图等九种图表类型） | 面向通用软件/流程图表，不含任何电子元件、引脚定义或电路公式知识 |
| draw-io-diagram-generator | 基于 draw.io 格式的通用图表生成 | 同为通用图表工具，无电子硬件领域知识沉淀 |
| architecture-blueprint-generator | 软件架构蓝图图解 | 面向代码库架构可视化，与电路/硬件场景无关 |
legacy-circuit-mockups 的差异化在于领域深度：它不是一个通用绘图工具，而是内置了完整的复古计算机硬件知识库（芯片引脚表、时序公式、元件规格），这是通用图表生成类技能不具备的。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；已确认的独立第三方证据为 skills.sh 平台记录的 9.0K 次安装量。
9. 安装使用方式
- npx 一键安装：
npx skills add https://github.com/github/awesome-copilot --skill legacy-circuit-mockups - 手动安装：从仓库
skills/legacy-circuit-mockups/复制SKILL.md与references/目录到所用 agent 的 skills 目录 - 安装后注意事项：无需重启或额外配置；触发方式为在对话中提出“生成面包板电路图”“设计 6502 电路布局”“画 555 定时器电路”等请求，agent 会自动引用该技能的元件规格与渲染规范生成 Canvas 绘图代码
10. 注意事项
- 技能产出的是 Canvas 绘图代码/静态图示意，不做实际电路仿真或电气规则检查，复杂电路仍需人工核对连线正确性
- 元件库覆盖以 6502 复古计算机生态与基础 TTL/555 电路为主，不含现代 SMD 贴片元件或高速数字电路布局知识
- Codex、OpenClaw 用户需按各自 agent 的 skills 加载方式手动确认该技能已被正确引用