plan-tasklisted

# Plan-Task（任务卡驱动的任务规划） ## Overview 动手写任何代码之前，先走「头脑风暴 → 调研 → 计划 → 批准 → 编码 → 编译自查 → 审查」。 计划必须写在任务卡里，**得到批准才动代码**。这是项目纪律，不是建议。 ## When to Use - 接到新任务卡 / 用户要求改固件 / 修 bug / 加功能 - 任何要写 C 代码的时刻（先计划，后动手） - 需要新增外设、改引脚、改宏开关、加模块 不用：纯读代码、查资料、回答问题。 ## Workflow ### 1. BRAINSTORM（头脑风暴） - 读项目 `CLAUDE.md` + 任务卡 + 相关文档。 - 向项目负责人提问澄清：涉及哪些外设、允许改哪些文件、宏开关怎么设、验收标准。 - 列出已知硬件事实，标出「未确认项」。不确定的引脚/接线/API 必须停下提问，禁止猜测。 ### 2. RESEARCH（调研） - 只读允许范围内的源码；用 Explore/Plan 子代理扫代码。 - 重点核对：条件编译当前值、引脚复用、外设寄存器参数、API 签名。 ### 3. PLAN（写计划到任务卡） 至少包含： - 目标 + 验收标准（**编译验收**与**硬件验收分开**） - 允许修改的文件清单（精确到文件名） - 禁止修改的文件清单 - 要改的宏开关及互斥检查 - 实施步骤（每步可验证） - 构建命令 + 日志验收 - 风险点（坐标越界、周期写死、方向符号等常见坑） ### 4. APPROVE（批准） **得到批准后才开始写代码。** 未批准不动代码。 ### 5. IMPLEMENT（实施） - 严格只改批准的文件，不顺手重构无关代码。 - 遵循项目现有风格（C90 声明置顶、注释密度一致）。 ### 6. BUILD + SELF-CHECK（编译 + 自查） - 命令行**完整 Rebuild**（不是增量），解析日志。 - Error / Warning 逐条记录（历史警告也要记）。 - 检查产物时间戳晚于本次全部源码修改。 - 用 superpowers:verification-before-completion 确认通过后再交付。 ### 7. REVIEW（交付审查） - 更新任务卡状态为 `CODE_REVIEW`；自我对抗审查（代入审查者视角找问题），通过后转 `HARDWARE_TEST` 交硬件实测（用 hardware-test skill）。 ## 通用红线（任何项目都要写进 CLAUDE.md 并遵守） 1. **不声称硬件测���通过**——硬件实测只能由真人完成，实测记录才算数。 2. **不确定的引脚/接线/API → 停下提问，禁止猜测硬编码。** 3. **不修改禁止文件**（每个项目在 CLAUDE.md 里列明，如驱动/工程配置）。 4. 安全相关宏（如电机使能）默认关闭，除非任务卡明确授权并附验收标准。 ## Common Mistakes | 错误 | 现实 | |------|------| | "这个改动很小，直接改" | 小改动没计划 = 没验收标准 = 返工 | | "引脚我觉得是 PA1" | 猜测硬编码 = 烧板风险，必须停下问 | | "先写代码再补计划" | 违反纪律，重写 | | "编译过了就算完成" | 编译通过 ≠ 硬件正确，硬件验收是另一关 |