@huaqiu/dsh-kicad 0.6.7 → 0.6.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@huaqiu/dsh-kicad",
3
- "version": "0.6.7",
3
+ "version": "0.6.9",
4
4
  "type": "module",
5
5
  "main": "./lib/index.mjs",
6
6
  "types": "./lib/index.d.mts",
@@ -22,7 +22,7 @@
22
22
  "@deepseek-ai/dsh-tools": "^0.2.1-rc.2"
23
23
  },
24
24
  "dependencies": {
25
- "@huaqiu/dsh-plugin-log": "0.6.7"
25
+ "@huaqiu/dsh-plugin-log": "0.6.9"
26
26
  },
27
27
  "files": [
28
28
  "lib",
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: hardware-design-brief
3
- description: "面向团队与 Maker,将产品想法或已有需求转成 MRD、硬件 PRD,以及可指导原理图和 PCB 设计的硬件方案;完成核心器件选型、电路拓扑、接口与引脚规划、电源预算和多 PCB 分解。支持文档审核与变更追溯,不直接代替 EDA 绘图和布局布线。"
3
+ description: "面向团队与 Maker,新建原理图项目先提问并等待用户确认需求,再将产品想法或已有需求转成 MRD、硬件 PRD,以及可指导原理图和 PCB 设计的硬件方案;完成核心器件选型、电路拓扑、接口与引脚规划、电源预算和多 PCB 分解。支持文档审核与变更追溯,不直接代替 EDA 绘图和布局布线。"
4
4
  ---
5
5
 
6
6
  # 硬件产品需求与方案定义
@@ -9,7 +9,25 @@ description: "面向团队与 Maker,将产品想法或已有需求转成 MRD
9
9
 
10
10
  ## 先确定范围与深度
11
11
 
12
- 先读已有资料,识别产品/单板边界、当前阶段、目标产物、关键约束及项目目录。信息足够时直接工作;不要要求用户重新填写已有信息。
12
+ 先读已有资料,识别产品/单板边界、当前阶段、目标产物、关键约束及项目目录。不要要求用户重新填写已有信息。新建原理图项目即使信息看似足够,也必须先执行下方的需求确认;已有且明确确认过的同一项目需求可直接沿用。
13
+
14
+ ## 原理图新项目:方案前必须确认需求
15
+
16
+ 只要任务包含新建原理图,必须按“需求摘要与提问 → 用户真实回复 → 保存确认后的需求基线 → 生成方案并读回 → 原理图设计”执行。简单电路、Maker 项目、用户指定芯片或只有一句话的产品想法,都不能跳过。用户只要求讨论、文档审核或已有设计的局部修改时不强制重新走新项目确认;但影响核心需求的变更仍须确认。
17
+
18
+ 1. **先展示具体内容再提问**:简述已知目标、本次交付范围、用户明确指定的条件;将缺口及推荐值明确区分。围绕会影响架构、接口、供电、尺寸、性能或预算的关键选择合并提问,通常每批 2–4 个。每题给可理解的推荐选项和影响,允许用户自由补充;信息完整时也应展示需求摘要,请用户确认该摘要。不要只问“是否开始设计”。
19
+ 2. **必须等待回答**:优先调用宿主 `ask_user_question` 并等待有效回答;工具不可用时在对话中提出同样的问题并结束当前轮,等待下一条用户回复。空回答、取消、超时、工具错误、默认选中或用户未回复均不算确认。等待期间只做为澄清所需的只读资料核实,不编写正式 MRD/PRD/硬件方案,不生成原理图脚本、电路副本或 EDA 工程,也不把“先写草案”作为绕过方式。
20
+ 3. **按实际回复建立基线**:用户选择选项、回答关键问题,或明确同意已展示的推荐参数,均可作为该范围的确认;关键问题已回答时不再追加一轮形式性“确认”。回复不完整或存在关键冲突时,只补问相关项。单独说“设计一个……”不是确认模型尚未展示的参数,不能把用户未指定的尺寸、续航、电池、通信方式或器件型号标为“用户确认”。
21
+ 4. **记录来源并继续**:确认后在现有 PRD 或精简方案的“需求基线”章节记录需求摘要、问题与用户实际回答、明确授权采用的推荐值;不另建签核文件。保留真实回复来源,不用模型自行填写的 `confirmed:true`、自述或其他代理消息冒充用户回复。之后连续完成方案与原理图,不逐份文档、逐个器件再要求批准。只有改变已确认的核心需求或硬约束时重新提问。
22
+
23
+ 典型问题范围(按实际项目裁剪,不作为固定规格):
24
+
25
+ | 输入 | 先澄清的关键选择 |
26
+ | --- | --- |
27
+ | “设计一个智能指环,可以测量心跳,可以把数据传到手机” | 演示板还是可佩戴产品;连续还是间歇测量;尺寸与续航目标;手机通信和 App 是否在交付范围。先列推荐值供选择,不自行把它们冻结为需求 |
28
+ | “使用 GDF32505 设计一个多足机器人主控板” | 核对用户所指芯片的完整型号,不自动改成相似型号;足数和关节数;舵机/电机及控制接口;电池电压和主板是否承担大电流驱动 |
29
+
30
+ 以下“自主决策”“合理假设”“不增加审批”的规则均在这一次需求确认之后适用,不能用于跳过该步骤。用户已经对同一份明确需求摘要确认过时,复用其回复,不机械重复提问。
13
31
 
14
32
  按项目风险、复杂度和协作需要裁剪,不按用户资历增加文档:
15
33
 
@@ -27,7 +45,8 @@ description: "面向团队与 Maker,将产品想法或已有需求转成 MRD
27
45
 
28
46
  ```mermaid
29
47
  flowchart LR
30
- A[需求来源:市场 / 用户任务 / 已有产品] --> B[MRD 或精简立项说明]
48
+ A[需求来源:市场 / 用户任务 / 已有产品] --> Q[新建原理图:提问并等待需求确认]
49
+ Q --> B[MRD 或精简立项说明]
31
50
  B --> C[产品需求与硬件 PRD]
32
51
  C --> D[硬件实施方案:分板 / 选型 / 电路 / 互连 / 预算]
33
52
  D --> E[原理图展开与 PCB 设计]
@@ -56,7 +75,7 @@ docs/
56
75
  └─ 03-design-brief.md 整机方案与单板实施方案,或多板方案索引
57
76
  ```
58
77
 
59
- **默认不创建或维护独立的 `decision.md` / `decisions.md`,也不建立决策编号、签核或逐阶段确认流程。** 选型理由写在选型处,假设注明在相关参数旁,关键未决项集中在受影响文档末尾。只有用户明确要求独立决策日志,或已提供的团队规范明确要求时才使用。既有日志保留历史和必要引用,不因其存在自动恢复逐项确认或要求用户批准迁移。
78
+ **默认不创建或维护独立的 `decision.md` / `decisions.md`,也不建立决策编号、签核或逐阶段确认流程;新建原理图项目在方案前的需求确认必须保留。** 选型理由写在选型处,假设注明在相关参数旁,关键未决项集中在受影响文档末尾。只有用户明确要求独立决策日志,或已提供的团队规范明确要求时才使用。既有日志保留历史和必要引用,不因其存在自动恢复逐项确认或要求用户批准迁移。
60
79
 
61
80
  保留 `03-design-brief.md` 文件名以兼容旧项目,标题与内容改为“硬件方案设计”。更新旧文件时保留仍有效的详细约束,并标注阶段归属,不擅自删除工程输入。
62
81
 
@@ -69,13 +88,15 @@ docs/
69
88
  ## 工作方式
70
89
 
71
90
  1. **选择入口**:记录本次阶段、采用的文档深度和已有输入。审核时先报告缺陷及影响,再在授权范围修改;小改动只更新受影响项。
72
- 2. **仅询问真正需要用户判断的缺口**:先利用已有输入和可查资料。只有无法据此确定、无法用可接受假设继续,且会实质改变产品目标、硬约束或关键方案的问题才询问;尽量合并一次提出,附推荐及影响。普通选型、可计算参数、文档结构与下一阶段是否继续,由模型在授权范围内直接处理。新问题出现时再补问,不将问答轮数当作流程。
73
- 3. **主动完成工程决策**:对已有充分条件的模块核对资料、选定推荐基线、规划连接并计算参数,直接用于后续文档,不逐项请求批准。可逆且不影响核心要求的缺口使用明示假设继续;真正缺少的关键外部条件只限制相关部分。资料核实、计算或试验任务由相应工作解决,不转换成让用户逐条“确认”的问题。缺少关键证据时如实标明范围,不编造完成状态。
91
+ 2. **先确认新项目需求,再按需补问**:新建原理图项目必须先执行方案前需求确认。确认后先利用已有输入和可查资料;只有无法据此确定、无法用已授权假设继续,且会实质改变产品目标、硬约束或关键方案的问题才补问;尽量合并一次提出,附推荐及影响。普通选型、可计算参数、文档结构与下一阶段是否继续,由模型在授权范围内直接处理。新问题出现时再补问,不将问答轮数当作流程。
92
+ 3. **主动完成工程决策**:对已有充分条件的模块核对资料、选定推荐基线、规划连接并计算参数,直接用于后续文档,不逐项请求批准。在需求基线已确认后,可逆且不影响核心要求的缺口使用明示假设继续;真正缺少的关键外部条件只限制相关部分。资料核实、计算或试验任务由相应工作解决,不转换成让用户逐条“确认”的问题。缺少关键证据时如实标明范围,不编造完成状态。
74
93
  4. **建立证据**:分别标明用户确认、外部资料事实、工程推算、建议、假设和待确认。核对当期竞品、价格、器件能力/供货及适用标准时记录链接、资料版本或查询日期;无法查证时说明局限。目标、计算估计与实测结果分别记录。
75
- 5. **连续编写和自检**:请求整套文档时按 MRD → PRD → 方案连续完成,阶段检查由模型内部执行,不在每份文件结束时停下要求确认。缺上游文件时引用用户输入或已有规格;冲突若已有优先级或授权可据此处理,否则只对确实需要用户取舍的部分提问,其他工作继续。
94
+ 5. **连续编写和自检**:完成必要的方案前需求确认后,请求整套文档时按 MRD → PRD → 方案连续完成,阶段检查由模型内部执行,不在每份文件结束时停下要求确认。缺上游文件时引用用户输入或已有规格;冲突若已有优先级或授权可据此处理,否则只对确实需要用户取舍的部分提问,其他工作继续。
76
95
  6. **检查并交付**:按交付清单核对需求→板卡→器件/电路→接口→验证,检查封装/引脚、资源与存储容量、电源兼容、板间针脚、成本加总、图表一致性。报告可进入原理图的具体板卡/模块与阻塞范围。仅有框图、候选类别和待办清单不算完成硬件方案。
77
96
 
78
- 用户只想讨论时先讨论,不强制落盘。只要没有新的实质冲突,不重复确认用户已给出的信息或已授权的选择,也不以“请确认后再生成下一份文档”收尾。文档保留版本/日期、来源和实际证据状态;“未由用户签核”本身不阻塞编写、推荐选型或方案交接,不能据此新增审批。不得把工程建议冒充用户要求,或把未执行试验写成通过。用户明确要求阶段审批时才按其要求暂停。
97
+ 用户只想讨论时先讨论,不强制落盘。只要没有新的实质冲突,不重复确认用户已给出的信息或已授权的选择,也不以“请确认后再生成下一份文档”收尾。文档保留版本/日期、来源和实际证据状态;不逐项签核器件和文档,但新建原理图项目未完成方案前需求确认时必须等待,不能用“未签核不阻塞”绕过。不得把工程建议冒充用户要求,或把未执行试验写成通过。除新建原理图项目必须等待一次需求确认外,只有用户明确要求其他阶段审批时才按其要求暂停。
98
+
99
+ 若本次任务还包括生成原理图,先检查本项目真实用户回复对应的需求基线,再保存足以指导本次电路实现的方案,再读回交接;不得等原理图生成后才首次补写方案。交给 `kicad-schematic-design` 时使用其 `run-design.mjs --read-plan <方案路径>` 返回的全文、路径和 SHA-256,按方案中的需求、实际器件、连接及预算编写生成脚本。方案发生实质变更时先更新文档、重新读回,再修改和生成电路。方案前需求确认完成后不新增逐阶段签核,沿用本技能的标准或精简文档结构。
79
100
 
80
101
  ## 按需读取
81
102
 
@@ -84,6 +105,6 @@ docs/
84
105
  - 每次生成或审核完整硬件方案,读取 [design-brief-guide.md](references/design-brief-guide.md) 和 [solution-deliverable.md](references/solution-deliverable.md)。后者将用户提供案例的深度转成通用交付规范,并链接案例全文。
85
106
  - 多 PCB 或产品组成尚需分板决策:[multi-board-guide.md](references/multi-board-guide.md);MRD、PRD 和方案阶段均适用。
86
107
  - 判断 PCB/装配细节是否属于当前阶段,或准备详细设计交接:[stage-boundaries.md](references/stage-boundaries.md)。
87
- - 整套文档、审核及跨文档变更的内部一致性与验证检查:[project-controls.md](references/project-controls.md),不据此增加审批流程。
108
+ - 整套文档、审核及跨文档变更的内部一致性与验证检查:[project-controls.md](references/project-controls.md),不据此增加方案前需求确认以外的审批流程。
88
109
 
89
110
  只加载本次工作相关指南。单文件任务也应保留最小追溯:稳定的需求编号(MRD 为 `M-001`,PRD 为 `H-001`)、来源、验收依据、未决项;普通叙述无需逐句编号。
@@ -8,7 +8,7 @@
8
8
 
9
9
  目标是形成**单一、可实施的推荐基线**。比较路线后应选出主方案;用户批准、供应商承认、实测验证分别记录。重要外部输入缺失时可以形成条件化分支,但不能将核心器件和接口全部留待原理图阶段。无法核实资料的器件只能作为待核实候选,相关模块不能宣称已具备完整设计输入。
10
10
 
11
- 推荐基线一旦有充分依据,直接用于电路、互连、预算及后续文档;不逐个询问用户是否同意料号、外围值或模块划分。理由写在对应选型/参数旁,不另建决策日志。资料、供应商或试验尚待核实不等于必须让用户回复“确认”;只有无法代决的关键需求冲突才需要询问。
11
+ 推荐基线一旦有充分依据,直接用于电路、互连、预算及后续文档;不逐个询问用户是否同意料号、外围值或模块划分。理由写在对应选型/参数旁,不另建决策日志。资料、供应商或试验尚待核实不等于必须让用户回复“确认”;新建原理图项目先按 SKILL.md 完成方案前需求确认;确认后只有无法代决的新增关键需求冲突才补问。
12
12
 
13
13
  ## 系统框图、电源树与工作过程
14
14
 
@@ -10,7 +10,7 @@ MRD 为是否做、先做什么提供依据,不预先设计电路。商业项
10
10
 
11
11
  ## 有选择地澄清
12
12
 
13
- 以下是内容检查维度,不是必须逐项询问的问卷。先使用已有信息;可合理假设的注明依据后继续,仅对无法代决且会改变产品目标的缺口集中提问:
13
+ 新建原理图项目先按 SKILL.md 完成方案前需求确认。以下是确认后的内容检查维度,不是必须逐项询问的问卷。先使用已有信息;可合理假设的注明依据后继续,仅对无法代决且会改变产品目标的缺口集中提问:
14
14
 
15
15
  - 谁使用、购买、安装或维护?在哪个地区、环境和场景使用?
16
16
  - 具体任务和痛点是什么,现有替代方案为何不足?“不做”会怎样?
@@ -1,6 +1,6 @@
1
1
  # 文档一致性与验证检查
2
2
 
3
- 本指南用于模型内部自检,不是审批流程。默认不生成独立决策日志、决策编号或签核表。保持方案的技术深度,减少重复记录和对用户的确认请求。
3
+ 本指南用于方案前需求确认完成后的模型内部自检。新建原理图项目必须先按 SKILL.md 提问并等待真实用户回复;后续内部检查不另设审批流程。默认不生成独立决策日志、决策编号或签核表。保持方案的技术深度,减少重复记录和对用户的确认请求。
4
4
 
5
5
  ## 信息放在对应位置
6
6
 
@@ -13,18 +13,19 @@
13
13
 
14
14
  ## 什么时候才需要问用户
15
15
 
16
- 先看已有输入、优先级和授权能否回答,再查资料或计算;只有关键取舍确实无法代决时提问。
16
+ 新建原理图项目先展示需求摘要、缺口与推荐选项并等待确认,不能因模型能够代决就跳过。完成该步骤后,先看已有输入、优先级和授权能否回答,再查资料或计算;只有新的关键取舍确实无法代决时补问。
17
17
 
18
18
  | 情况 | 处理方式 |
19
19
  | --- | --- |
20
- | 用户已给过信息、已选择或已授权模型决定 | 直接沿用;无新矛盾不再次询问 |
20
+ | 新建原理图项目,尚无对明确需求摘要的真实用户回复 | 提问并等待;不写正式方案或先生成电路,未回复/默认选项不视为确认 |
21
+ | 用户已对同一需求摘要回复、已选择或已授权模型决定 | 直接沿用;无新矛盾不再次询问 |
21
22
  | 常规选型、引脚/外围计算、文档组织、资料可查的事实 | 自行核实并决定推荐基线,说明依据,继续实施方案 |
22
- | 可逆、影响有限且可作合理假设的缺口 | 明示假设后继续,不要求每条都被确认 |
23
+ | 需求确认后,可逆、影响有限且可作合理假设的缺口 | 明示假设后继续,不要求每条都被确认 |
23
24
  | 待查手册、供应商资料或待实测项目 | 作为工程待办,记录取得证据的方法;用户回复“确认”不能替代证据 |
24
25
  | 核心需求冲突或缺少关键外部条件,且无既定取舍依据 | 尽量合并提问,给推荐及影响;只限制依赖该答案的部分,其他工作继续 |
25
26
  | 用户明确要求阶段审批 | 按用户规定的节点暂停,不追加其他审批节点 |
26
27
 
27
- 未回复不代表批准;也不意味着已经授权的独立工作都要停下。涉及供电、隔离或其他关键电气边界而无可靠依据时,不用随意默认值掩盖缺口,相关部分保持有范围限制的草案。
28
+ 未回复不代表批准。等待方案前需求确认时仅可只读核实澄清所需资料,不能开始正式文档和电路生成;确认后的局部补问不阻塞已有授权的独立工作。涉及供电、隔离或其他关键电气边界而无可靠依据时,不用随意默认值掩盖缺口,相关部分保持有范围限制的草案。
28
29
 
29
30
  ## 内部检查与验证计划
30
31