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-performance-optimization
description: "测量、定位并优化固件底层的吞吐、延迟、抖动、CPU、内存、带宽、功耗、温度和恢复时间。用于已有可量化目标与负载的 BSP/PSP/运行链路性能任务;不自行发明目标、不用单一峰值替代统计证据,也不自动取得任意组件修改权。"
---
# 固件底层开发_性能优化
以可重复基线、profiling 和可证伪实验推进性能优化。
## 进入条件
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. 确认产品/技术/硬件约束或测试负责人提供的目标、负载矩阵、取舍、环境和验收责任。缺少目标时可以建立基线和 profiling,但不能宣称优化成功。
4. 读取 [性能优化工作流](references/workflow.md)。
## 范围
负责测量设计、环境基线、profiling、trace/计数器分析、瓶颈假设、优化实验、统计比较和功能/稳定性/功耗/温度回归。
只有目标组件、仓库、所有权和修改范围已明确批准时才直接修改;否则把修复路由给 BSP、PSP、应用或其他所有者,再负责前后比较。
## 不可绕过的门禁
- 不使用厂商宣传值、经验百分比或最好一次结果作为默认验收线。
- 优先单变量实验;耦合修改必须说明不可拆分原因。不能只保留成功实验或隐藏代价。
- 项目测试规范优先。没有规范时先估计波动,再提出样本数、统计量和接受阈值供用户确认。
- 超频、超压、故障注入、热/功耗边界和共享实验设备按风险等级授权;R4 不执行。
- 完成时按 [记录规范](../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-performance-optimization 帮我测量并优化这个固件性能瓶颈。"
policy:
allow_implicit_invocation: false
@@ -0,0 +1,31 @@
# 性能优化工作流
## 目标与负载
记录主指标、阈值、负载矩阵、功能边界、允许取舍、责任人和验收环境。候选指标包括吞吐、端到端/阶段延迟、抖动、丢帧、CPU、内存峰值、DDR/总线带宽、功耗、温度、频率和错误恢复时间;只选择与当前任务相关的指标,不适用项说明理由。
## 基线
锁定硬件/板卡、固件、BSP/PSP、应用、模型、配置、工具链、仪器、供电、温度、DVFS、预热和后台负载。记录原始数据路径和 hash。无法排除并发干扰时,不升级验证状态。
## 测量计划
项目测试规范优先。没有规范时先做预实验估计波动,再向用户提出采样次数、预热、统计量、置信或接受标准。只比较一次或只看峰值不足以证明提升。
## 优化循环
1. 采集 profiling、trace/ftrace/RTOS trace、性能计数器、日志或波形。
2. 建立可证伪瓶颈假设,并说明预测的主/副指标变化。
3. 优先实施单变量、可回退的最小变更;耦合变更说明原因。
4. 在同一基线和负载下重复测量,保存失败和无效实验。
5. 比较分布/离散程度,确认改善超过测量噪声。
6. 回归功能、稳定性、错误恢复、CPU/内存/带宽、功耗、温度和相关实时性;未测项标记未验证。
7. 根据已确认目标接受或回退,不通过降低阈值制造成功。
## 代码所有权
性能 skill 负责实验和判定,不自动获得任意仓库权限。目标组件未在当前工作包明确批准时,输出包含证据、预测和验收条件的修复请求,由对应所有者实施后回交测量。
## 交付
交付目标/负载矩阵、软硬件环境、原始数据路径/hash、profiling、瓶颈假设、变更、前后统计、副指标回归、接受/回退、未测维度和可复现步骤。未达到目标的实验可以作为有效调查结果,但不能标记优化成功。