feat: 发布固件底层开发 Skill 套件

This commit is contained in:
tangfahong committed 2026-09-11 15:06:55 +08:00
commit c7ae3b4ce1
72 files changed
+10212

No files matched your search

@@ -0,0 +1,29 @@
---
name: firmware-lowlevel-integration-debugging
description: "复现和定位固件底层跨 BSP、PSP、应用、硬件或测试环境的集成问题,并组织证据、责任路由和回归验证。用于跨组件时序、接口、版本或设备行为问题;不自动取得被诊断模块的修改权,也不替代整机测试和业务验收。"
---
# 固件底层开发_联调
以可复现事实、观测和可证伪实验推进跨模块联调。
## 进入条件
1. 先读取并遵守统一的[流程文档写法](../firmware-lowlevel-development/references/chinese-process-docs.md),所有面向人的流程文档使用简体中文和直白表达。
2. 读取 [项目所有权契约](../firmware-lowlevel-development/references/ownership-contract.md)、[治理工作流](../firmware-lowlevel-development/references/governance.md) 和 [风险等级](../firmware-lowlevel-development/references/risk-levels.md)。
3. 先从项目、日志和安全只读工具补齐版本矩阵、设备、配置和既有证据。信息不全时可进入只读分诊;设备操作或代码修改前必须确认目标、基线、复现、期望/实际行为和范围。
4. 读取 [联调工作流](references/workflow.md)。
## 范围
负责最小复现、版本/配置矩阵、日志/trace/波形和时间线关联、假设树、区分实验、已排除分支、责任/路由建议、专项诊断产物和集成回归。
可以在明确批准范围内修改公共测试桩、诊断配置或专项固件。真正的 BSP、PSP、应用或硬件修复必须由对应所有者工作包承担;联调不成为跨仓库超级权限。
## 不可绕过的门禁
- 未复现不等于可以猜测性修改。先输出事实、未知项、假设和下一项低风险区分实验。
- 责任争议时不伪造组织裁决;Etunel 项目交给当前 Hub/技术负责人,普通项目交给指定负责人。
- 高日志、绕过逻辑和专项固件必须隔离、标记启停方式;最终移除或保留在非生产配置。生产保留需要单独批准并回归。
- 设备、串口、电源、调试器和仪器未证明隔离时状态操作串行。
- 完成时按 [记录规范](../firmware-lowlevel-development/references/records.md) 和 [交付契约](../firmware-lowlevel-development/references/deliverable-contract.md) 报告。
@@ -0,0 +1,6 @@
interface:
display_name: "固件底层开发_联调"
short_description: "复现、观测并路由固件底层跨模块问题"
default_prompt: "使用 $firmware-lowlevel-integration-debugging 帮我复现并定位这个跨模块问题。"
policy:
allow_implicit_invocation: false
@@ -0,0 +1,33 @@
# 联调工作流
## 只读分诊
收集并校验产品/板卡/设备标识、处理器/OS、BSP/PSP/应用/模型/配置版本、构建产物 hash、连接拓扑、复现步骤、期望/实际行为、发生频率、最后良好版本和已有日志/波形。缺失项按影响排序,不要求用户重复可从环境发现的事实。
## 最小复现和时间线
1. 锁定单一可观察基线,隔离并发设备或服务。
2. 缩小触发条件,保留功能上足以重现问题的最小路径。
3. 对齐跨组件时间戳、时钟源、启动阶段和事件标记。
4. 记录日志、trace、寄存器、总线、波形或仪器采样的来源、条件、路径和 hash。
5. 把事实、推断、已排除分支和未知项分开。
## 假设与实验
构建可证伪假设树,优先选择区分力高、可恢复、低风险的单变量实验。设备探测按实际副作用分级;读清寄存器、未知寄存器、复位、故障注入和写入至少按 R3 处理。
相同实验失败且没有新证据时停止。结果不唯一时输出最小区分实验,不为了尽快结束而随意指定责任方。
## 修复路由
- BSP、PSP、应用、硬件和测试环境问题分别进入对应所有者工作包。
- 联调自身只直接修改已批准的诊断基础设施、测试桩和专项配置。
- 所有权争议交当前项目协调层;技术判断附证据和置信边界。
## 退出与回归
定位后移除或关闭临时绕过、高日志和专项修改;如需生产保留,单独确认维护接口和影响。使用原最小复现以及相关功能/错误恢复场景回归,并验证关闭诊断后问题仍已解决。
## 交付
交付版本矩阵、最小复现、期望/实际行为、时间线、日志/trace/波形摘要、已排除分支、剩余假设、责任/路由结论、专项产物、修复工作包引用和回归结果。组织责任由实际负责人确认。