writing-skill
Installation
SKILL.md
writing-skill：把经验写成可移植的 skill
1. 先判定：这内容配不配做 skill
| 判定 | 去处 |
|---|---|
| 跨机器/跨项目会重复的方法（怎么做、怎么避坑） | skill |
| 只对本机/本项目成立的事实（路径、版本、状态） | 记忆系统或 host 层文档，不是 skill |
| 一次性任务、还没第二次发生 | 什么都不写，等它重复 |
| agent 本来就会的通识 | 不写；skill 只写它不知道的差异点（确切键名/命令/版本行/坑） |
混了本机事实的通用方法 → 写成 skill 时占位符化（{{路径}}），本机值进 host 层或记忆；platform-environment-skill-audit 管回流的脱敏底线。
2. 定形（写之前想清楚）
- 命名：kebab-case，动词或名词短语，≤64 字符，目录名=name；前缀可对齐家族（exp-、accel-）。
- 放哪：仓库 base 组（全机型通用）/ accel 组（算力场景）/ 本机
~/.agents/skills/（只此一机）。进仓库的记得进 setup 脚本对应名单（selfcheck 会查）。 - 分工：与相邻 skill 的边界一句话写进 description（"装环境用 X，写代码用本 skill"），避免双触发或都不触发。
- 演化性质：写时定档，明确更新约定。