docevilOck
docevilOck/agent-skills-hook
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/docevilOck/agent-skills-hook --skill ddev-hardware命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | ddev-hardware |
| description | 固件/嵌入式项目硬件资源分析与文档化。从 sdkconfig、peripheral_cfg.h、分区表等文件中提取 MCU 算力、存储、外设、GPIO 信息，输出结构化硬件规格文档。 |
从固件仓库的配置文件中提取硬件资源信息，输出结构化的 Markdown 硬件规格文档。
用户请求分析硬件资源、硬件规格、主板资源、外设清单、引脚定义，或要求"硬件文档""hardware spec""板级资源""GPIO 汇总"。
执行前需确认两个信息（若用户未提供则主动扫描）：
prt_cfg.h、board_cfg.h、*_cfg.h 中 #define 的宏）在项目根目录下搜索机型定义：
grep -rn "^#define TP\|^#define BOARD_\|^#define PRODUCT_" --include="*_cfg.h" --include="*board*.h" | head -30
规则：
#define <NAME> 行为准GEN、DEV、V2、MT 等版本/变体后缀的宏从 ESP-IDF 的 sdkconfig 或等效内核配置文件中提取：
# CPU 核数与频率
grep -E "UNICORE|DEFAULT_CPU_FREQ|NUMBER_OF_CORES" sdkconfig
# 缓存配置
grep -E "INSTRUCTION_CACHE_SIZE|DATA_CACHE_SIZE|CACHE" sdkconfig
# Flash 配置
grep -E "FLASHSIZE|FLASHMODE|FLASHFREQ|FLASH_SIZE" sdkconfig
# PSRAM / 外部 RAM
grep -E "SPIRAM|PSRAM|EXTERNAL_RAM" sdkconfig
必须回答的关键问题：
IDF_TARGET 或 CMakeLists 推导）嵌入式 MCU 的片内 ROM/SRAM 值可从芯片 datasheet 常量获取，不需要从配置文件推导。
搜索项目中的分区表文件：
find . -name "partitions*.csv" -o -name "partitions*.h" | head -10
根据当前机型选择对应的分区表文件，解析 CSV 格式的分区表：
# 注释行必须注明：固件写入的起始偏移、最大可用空间。
在项目中搜索外设配置文件（常见文件名：prt_peripheral_cfg.h、peripheral_cfg.h、board_pin.h、pin_mux.h）：
find . -name "*peripheral*" -o -name "*pin_mux*" -o -name "*board_pin*" | head -10
从该文件中逐段扫描，每个 // ===== 或明显的注释分隔块对应一类外设。提取以下信息：
通信接口：
执行机构（若为打印机/电机控制类设备）：
传感器与检测：
音频：
人机交互：
电源与系统：
将所有 GPIO 整理成统一表格：GPIO 号、功能、方向（I/O）、备注（复用/特殊说明）。
过滤规则：
PRT_GPIO_UNVALID、-1、0xFF 等无效值不列出若 prt_cfg.h 中存在多个 #if defined(MODEL_A) ... #elif defined(MODEL_B) 分支，提取当前机型所在分支的 #define 列表，并与相邻机型分支对比，总结功能差异。
写入 docs/spec/<MODEL>-hardware-spec.md，按以下结构：
# <MODEL> 硬件资源规格
> 整理自: <源文件列表>
> 日期: <当前日期>
## 一、主控与计算资源
- MCU 型号、内核架构和说明、核数、主频
- I-Cache / D-Cache 大小
- 片内 SRAM / ROM 大小
## 二、存储资源
- 片内存储（SRAM、ROM、RTC 内存）
- 片外 Flash（容量、接口类型、频率、用途）
- 片外 PSRAM（容量、接口类型、频率、用途）
- 明确指出固件烧录到哪个物理介质
## 三、Flash 分区布局
- 主分区表（名称、偏移、大小、用途）
- 子分区（如有）
## 四、通信接口
## 五、打印/执行子系统（根据实际硬件调整标题）
## 六、音频子系统
## 七、人机交互
## 八、电源与系统
## 九、系统参数（任务栈、RTOS 配置等）
## 十、GPIO 汇总
## 十一、机型差异对比（如有多个变体）
find / grep 搜索得到# 注释行，正确处理 hex 偏移值PRT_GPIO_UNVALID / -1 等占位符，视为"未使用"，不写入汇总