Skip to content

嵌入式工具箱 v1.22.0：知识技能并入与深化（决策树 v1.1.0 / 避坑清单 v1.1.0）

Choose a tag to compare

View all tags
@liujycode liujycode released this 19 Oct 10:37
· 16 commits to main since this release
v1.22.0
6929eb2

嵌入式工具箱 v1.22.0：知识技能并入与深化（debug-trees v1.1.0 / peripheral-pitfalls v1.1.0）

工具箱从"查 + 验"扩成四个技能：新增的排障决策树与外设配置坑清单两个知识技能
并入本仓库，按与查/验相同的质量标准完成深化与量化验收。

一、并入工具箱仓库

  • skills/embedded-debug-trees、skills/embedded-peripheral-pitfalls 与查/验两技能同仓：
    同一套质量门（SKILL.md 规范、触发用例正 ≥20 反 ≥10、仅标准库、禁 eval/exec、Python 3.9 语法）、
    同一条 CI（三平台 × Python 3.9/3.12）；npx skills add liujycode/embedded-toolkit 一次装四个。

二、内容扩容

  • 排障决策树 5→6 棵、24→39 节点：新增"低功耗与唤醒"整树（睡死叫不醒/唤醒后时钟回落/
    进不了低功耗/调试器影响）；HardFault 补 FPU/NOCP 与 LOCKUP 双重故障；通信补 RS485 方向切换
    时机（等 TC 再切，TXE 不行）；DMA 补 DMAMUX 请求映射；RTOS 补时基没跑（vTaskDelay 卡住）；
    启动失败补 SWD 连不上（Connect under Reset）。
  • 外设避坑清单 9→11 类、38→61 坑：新增低功耗 PWR（唤醒时钟/唤醒标志/SRAM 保持/引脚漏电）
    与看门狗 WDG（调试冻结/喂狗路径/WWDG 窗口/选项字节硬件看门狗）两类；既有九类补 EXTI 线映射
    （EXTICR）、NVIC 两层使能、定时器 CEN、多定时器主从同步、ADC 序列长度与"带使能校准"顺序、
    RS485 方向、I2C 超时恢复、SPI 软件片选、CAN 环回自测与 FDCAN 内核时钟等 23 坑。

三、检索质量（对 AI 使用最关键）

  • 中文整句反向关键词匹配：中文不做分词，"任务卡死""定时器周期不对"这类整句查询通过
    "节点关键词出现在查询串"反向命中——不再要求查询恰好包含关键词。
  • 全命令 --format json；search --tree/--category 限定范围；demo 升级为检索探针自检
    （14 条典型症状必须命中对应树/类）。
  • 两脚本补 stdout UTF-8 输出重配置（管道/Agent 场景不再乱码）。

四、量化验收（与查/验同标准）

  • tools/knowledge_check.py：schema 校验（必填字段/唯一 id/keywords 非空）+ references 与
    JSON 同源    （references/trees.md、pitfalls.md 由 JSON 自动生成，杜绝手抄漂移）。
  • tools/knowledge_bench.py：检索评测 106/106 = 100%（46 条决策树场景 + 60 条坑位场景，
    逐条 ground truth，被测代码 = 技能脚本里的检索函数本体）；CI 强制；结果见
    benchmarks/knowledge-recall.md。
  • tests/test_knowledge.py 5 项（schema/评测/CLI 自检/JSON 输出/版本一致）；全仓 410 项测试全过。
  • 诚实化："覆盖 80% 故障面"改为具体覆盖描述；根因排行标注"按实战经验排序（非实测统计）"。

五、安装（不变）

  • Claude Code：/plugin marketplace add liujycode/embedded-toolkit 后 /plugin install embedded-toolkit@embedded-toolkit
  • 其他 Agent：npx skills add liujycode/embedded-toolkit
Assets 2
Loading