纯文档版本，代码无改动。
参考 OpenAI《Rethinking skills and prompts for GPT-6 Astra》，对给代理看的两份文件做了最小化修改。文章的核心观点是：为了推动旧模型而写的强硬指令，会让能力更强的模型过度执行——在用户其实希望它继续的地方停下来。
改动
| 文章建议 | 之前 | 现在 |
|---|---|---|
| 技能描述要短、触发要窄 | 列了 8 种触发情况，包括「改动任何 STM32 源码」 | 只在需要编译、烧录、上板验证、定位崩溃或新建 F103C8 工程时触发 |
| 根文档当路由，不要一刀切的前置要求 | SKILL「第一步（必做）：读完规范，按它执行」 | 改成「什么情况查 AGENTS.md 的哪一节」；删掉 SKILL 里重复抄写的规则 |
| 事先定义完成标准，安全的操作明确授权 | 「严禁直接结束对话，必须跑完闭环」 | 「完成标准是退出码 0；闭环只作用于接好的开发板，可以直接反复运行、修复后重跑，不用每步请示」 |
| 去掉强硬的「先问再做」 | 「严禁盲目动手，新外设必须先追问 5 大分支，用户确认后才编码」 | 只在参数缺失且影响正确性时才问；清单保留在 templates/ 里按需查阅 |
| 保持更新 | 「第一次跑闭环前先自检，全部满足后再进闭环」 | 闭环从 v2.4.2 起每轮都会自动自检，文档改为如实描述 |
| 过细的指导会妨碍强模型 | 7 条通用嵌入式准则、「第一性原理 / YAGNI / 修脚本」一节 | 删除。只保留模型自己不可能知道的内容：退出码、报告字段、工程命令、AC5 中文字符串陷阱、测时间的方法，以及大电流负载要在软件里限幅这一条安全提醒 |
AGENTS.md 中的「严禁」从 11 处减到 0 处；剩下的「必须」都是附带原因的技术事实，例如「新建的 .c 必须注册进工程，否则链接报 L6218E」。
升级
git pull 后运行 python install_skill.py，刷新各编辑器里的 skill 副本。