scheme-design-skill

name	scheme_design_skill
description	电路/硬件类需求优先：方案骨架 + 可选 BOM 与系统元件库匹配；不自动创建或落盘元件 JSON。缺型号时可再调 completion_suggestion_skill；需外证时调 web_search_exa。
keywords	["方案设计","电路方案","硬件方案","BOM","元件选型","元件匹配","缺件","系统架构","模块搭配","需求分析"]
metadata	{"fasthardware":{"skillId":"scheme_design_skill","engineOps":["runSchemeDesign","runRequirementAnalysis"]}}

Scheme Design（方案设计 + BOM/库匹配）

串联 runSchemeDesign 与可选 runRequirementAnalysis：输出方案摘要、估算参数、与当前元件库的匹配结果（matchedKey / exists）及缺件时的文字建议。不自动生成或写入元件 JSON 文件。

何时调用

• 优先：用户描述电路/系统/模块级需求，需要对齐内置库、缺件提示与方案叙述时。
• 之后：缺具体采购型号 → completion_suggestion_skill；需实时网页/数据手册线索 → web_search_exa。

与 Agent Loop 的配合

要点	说明
精确名	skillName 必须为 scheme_design_skill。
输入核心	userRequirement（必填）；可将前序 tool 摘要放入 additionalContextFromAgent。
BOM 开关	runBomAnalysis 默认 true；仅需方案骨架、跳过库匹配时设 false。
失败与重试	runSchemeDesign 或 runRequirementAnalysis 抛错时返回 success: false 与可读 error；下一轮应缩小范围、改述需求或换工具，而非重复同一长文（对齐 reference/Agent-Loop-Core.md 错误处理思路）。
状态	返回中可含 skillState（阶段/中间态），供后续轮次引用。

参数

参数	类型	说明
userRequirement	string	用户原始需求（必填）。
additionalContextFromAgent	string	可选；前序 web_search_exa 等摘录，拼入方案 LLM。
runBomAnalysis	boolean	默认 true；false 时跳过库匹配/BOM 分析段。

返回要点

• schemeDesignResult：摘要、叙述、估算参数、webSearchQueries 等（引擎内可再拉 Exa，与 agent 侧检索互补）。
• analysisResult：runBomAnalysis:false 时为 null；否则含 components[]、summary。
• 库内 exists: 0 时以 recommendation 为文本建议，不自动落盘元件。

Tips

• System prompt 中宜强调：首轮需要工具时只输出 tool_calls，勿用 final_message 抢答（与主进程 loop 一致）。
• 复杂需求可在一轮内先本 skill，再 completion_suggestion_skill 填型号。
• 第三层实现参考：examples/implementation-reference.js。