project-setuplisted

# Project-Setup（新项目启动） ## Overview 新项目开始前，用它把 `kun-embedded-workflows` 这套通用规范铺进项目：复制 skills、按模板生成三类文档、初始化 git。让项目从一开始就有「计划→编译验证→硬件实测→git 维护」的纪律。 ## When to Use - 创建新项目目录 - 老项目想引入这套工作流 - 需要补 CLAUDE.md / 任务卡 / 引脚表 ## Workflow ### 1. 复制 skills ``` mkdir -p <新项目>/.claude/skills cp -r kun-embedded-workflows/.claude/skills/* <新项目>/.claude/skills/ ``` 按需取舍：不需要硬件实测的纯软件项目可删 `hardware-test`。 ### 2. 按模板生成文档 - `templates/CLAUDE.md.template` → `<新项目>/CLAUDE.md` - 填：项目介绍、协作模型、构建命令、**安全红线**、**关键硬件事实**（引脚/外设/时序）、已知坑。 - `templates/task-card-template.md` → `<新项目>/KUN_任务卡/KUN_TASK_001_<主题>.md` - `templates/pinout-template.md` → `<新项目>/<资料目录>/引脚总表.md` - **引脚表以代码为准**（从驱动源码提取），不要抄来路不明的原理图。 ### 3. 初始化 git ``` git init -b main git add .claude CLAUDE.md README.md git commit ``` （推送用 git-workflow skill。） ### 4. 首次任务 用 plan-task skill 开第一张任务卡，验证整条链路。 ## 模板说明 - `CLAUDE.md.template`：项目文档骨架，**安全红线/硬件事实/构建命令**三块必填，缺失会导致后续任务无法计划。 - `task-card-template.md`：任务卡骨架，验收标准必须**编译验收**与**硬件验收**分开。 - `pinout-template.md`：引脚总表骨架，含已占用/空闲/外设冲突/权衡表。 ## Common Mistakes | 错误 | 现实 | |------|------| | 没写安全红线就开工 | 后续 AI 可能默认开电机等危险动作 | | 引脚表抄原理图 | 原理图常有误，引脚以代码为准 | | 一次全铺不测试 | 先铺最小链路（plan-task→build-verify）跑通一张卡再扩展 | | 模板留空占位符 | 占位符=未定义，验收时无依据 |