NextBoard — Hardware Solution Agent
面向硬件产品的PCB方案设计 AI Agent。输入产品需求，输出可评审、可落地的PCB原理图的方案。
使用说明
按需求输入:
- 设计一个无人机方案
- 设计一个FOC控制器
- 设计一个记单词的墨水屏卡片
Agent会自动帮你进行需求确认，实时分析国内外各类芯片技术方案，进行器件选型，下载datasheet，输出BOM表，计算价格，输出模块原理图，最终整合成可落地技术方案。
功能概览
- 结构化的 7 阶段设计流程：需求冻结 → 架构候选 → 系统分解 → 器件选型 → 输出生成 → 评审 → 验证门控
- 三类架构候选对比：国产优先、海外主流、混合折中
- 5 道验证门控，阶段性拦截质量问题
- 独立评审 agent，从完整性、风险、可实施性、成本、验证覆盖 5 个维度打分
- 供应链风险评估与国产替代参考
- 产出markdown、datasheet、封装库、pdf方案
快速开始
在 Claude Code、Codex 或 Cursor 会话中调用：
$hardware-solution
输入产品需求即可进入设计流程。
安装
安装后需重启 AI IDE 会话，让客户端重新加载 skill 列表。
AI 安装指引
本节供 AI 助手（Claude Code、Codex、Cursor 等）阅读。当用户要求安装本插件时，按以下流程引导。
第一步：确认当前环境
运行 ./scripts/install.sh --status 查看是否已安装。
第二步：引导用户选择安装方式
向用户说明三种方式的区别，让用户选择：
| 方式 | 适用场景 | 可用组件 | 限制 |
|---|
| 全局安装 | 希望所有项目都能用 | skill + agent | hooks 不生效 |
| --plugin-dir | 开发调试或临时使用 | skill + agent + hooks | 每次启动需指定路径 |
| Marketplace | 正式分发 | skill + agent + hooks | 需要 GitHub 访问 |
第三步：执行安装
用户选择后，运行对应命令：
# 全局安装（Claude Code，含 agent）
./scripts/install.sh --global --platform claude
# 全局安装（Codex，skill + agent）
./scripts/install.sh --global --platform codex
# --plugin-dir（单次会话加载，skill + agent + hooks 全部可用）
claude --plugin-dir /path/to/NextBoard
# Marketplace 安装
claude plugin marketplace add LeoKemp223/NextBoard
claude plugin install nextboard-hardware-solution
如果 scripts/install.sh 不可用（例如用户未克隆本仓库），按下方"手动安装"章节的命令执行。
第四步：验证
安装完成后提醒用户重启会话，然后调用 $hardware-solution 验证是否生效。
交互式安装
git clone <NextBoard-repo-url>
cd NextBoard
./scripts/install.sh
脚本会显示当前安装状态，引导你选择安装方式。
手动安装
方式一：全局安装
从 NextBoard 仓库复制文件到全局目录，所有项目都能使用 $hardware-solution。
git clone <NextBoard-repo-url>
cd NextBoard
Claude Code：
# 基础安装（skill）
mkdir -p "$HOME/.claude/skills"
rm -rf "$HOME/.claude/skills/hardware-solution"
cp -r skills/hardware-solution "$HOME/.claude/skills/"
# 增强安装（额外安装独立评审 agent）
mkdir -p "$HOME/.claude/agents"
cp agents/hardware-reviewer.md "$HOME/.claude/agents/"
Codex：
mkdir -p "$HOME/.codex/skills"
rm -rf "$HOME/.codex/skills/hardware-solution"
cp -r skills/hardware-solution "$HOME/.codex/skills/"
mkdir -p "$HOME/.codex/agents"
cp agents/hardware-reviewer.md "$HOME/.codex/agents/"
全局安装的局限：hooks 无法生效（缺少插件上下文）。
方式二：--plugin-dir（推荐开发调试）
直接从 NextBoard 仓库加载插件，skill + agent + hooks 全部可用，无需复制文件。
claude --plugin-dir /path/to/NextBoard
每次启动 Claude Code 时需要指定 --plugin-dir 参数。
方式三：Marketplace 安装
通过 Claude Code 插件市场安装，适合正式分发。
# 添加 NextBoard marketplace
claude plugin marketplace add LeoKemp223/NextBoard
# 安装插件
claude plugin install nextboard-hardware-solution
更新
# 全局安装：pull 后重新执行安装
cd NextBoard && git pull
./scripts/install.sh --global --platform claude
# --plugin-dir：pull 即可，下次启动自动加载最新版
cd NextBoard && git pull
卸载
# 全局卸载
./scripts/install.sh --uninstall
# 项目级卸载
./scripts/install.sh --uninstall-project /path/to/your-project
# 或手动卸载全局安装
rm -rf "$HOME/.claude/skills/hardware-solution"
rm -f "$HOME/.claude/agents/hardware-reviewer.md"
rm -rf "$HOME/.codex/skills/hardware-solution"
rm -f "$HOME/.codex/agents/hardware-reviewer.md"
项目结构
NextBoard/
├── skills/hardware-solution/
│ ├── SKILL.md # 技能入口，定义工作流和输出原则
│ └── references/
│ ├── design-workflow.md # 4 阶段设计工作流
│ ├── output-template.md # 方案输出标准结构
│ ├── verification-gates.md # 5 道验证门控
│ ├── review-checklists.md # 原理图/PCB/BOM/方案评审清单
│ ├── sourcing-and-risk.md # 供应链风险评估指南
│ └── domestic-sources.md # 国产芯片与元器件参考
├── agents/
│ └── hardware-reviewer.md # 独立评审 agent（增强安装）
├── hooks/
│ ├── hooks.json # Claude Code 会话启动 hook 配置
│ └── session-start # 会话启动提醒脚本
├── scripts/
│ └── install.sh # 交互式安装/卸载脚本
├── tests/
│ └── validate.py # 结构与内容一致性验证脚本
├── .claude-plugin/ # Claude Code 插件配置
├── .codex-plugin/ # Codex 插件配置
├── .cursor-plugin/ # Cursor 插件配置
├── CLAUDE.md # Claude Code / 通用 AI 会话项目指令
└── AGENTS.md # Cursor Agent Mode / 通用 Agent 指令
验证
修改 skill 或 reference 文档后，运行验证脚本检查结构完整性和内容一致性：
# 验证仓库源文件
python3 tests/validate.py
# 验证已安装的副本
python3 tests/validate.py --installed
验证覆盖三层检查：
