写 Skill 时,很多人只写 SKILL.md。这能用,但如果任务里有稳定的机械步骤,我更建议放到 scripts/。
适合写进 scripts 的事
- 扫描文件。
- 生成固定模板。
- 解析 JSON / CSV / BibTeX。
- 批量重命名。
- 调 Playwright 截图。
- 检查 Markdown 链接。
- 统计测试覆盖率。
这些事让模型手写很容易出错,脚本更稳。
一个简单结构
my-skill/
SKILL.md
scripts/
collect_changes.py
render_preview.py
templates/
report.md
references/
style-guide.md
SKILL.md 里怎么写
When generating the report, run:
```bash
python scripts/collect_changes.py --since main > work/changes.json
Then summarize work/changes.json using templates/report.md.
这样模型负责判断和总结,脚本负责稳定执行。
## 不适合写 scripts 的事
1. 需要大量语义判断的内容。
2. 每次需求都不一样的写作。
3. 需要和用户讨论取舍的设计决策。
这些还是让模型处理比较好。
## 我的判断标准
如果一个步骤你能写成确定性命令,就放 scripts。
如果一个步骤需要理解上下文、权衡取舍,就留给模型。
好 Skill 不是把模型变成脚本,也不是所有事都靠模型。它应该让两者各干擅长的部分。
1 个帖子 - 1 位参与者