【ClaudeCode/Codex通用】Skill 里什么时候该放 scripts,而不是只写说明

写 Skill 时,很多人只写 SKILL.md 。这能用,但如果任务里有稳定的机械步骤,我更建议放到 scripts/ 。 适合写进 scripts 的事 扫描文件。 生成固定模板。 解析 JSON / CSV / BibTeX。 批量重命名。 调 Playwright 截图。 检查 Markdo...
【ClaudeCode/Codex通用】Skill 里什么时候该放 scripts,而不是只写说明
ClaudeCode/Codex通用】Skill 里什么时候该放 scripts,而不是只写说明

写 Skill 时,很多人只写 SKILL.md。这能用,但如果任务里有稳定的机械步骤,我更建议放到 scripts/

适合写进 scripts 的事

  1. 扫描文件。
  2. 生成固定模板。
  3. 解析 JSON / CSV / BibTeX。
  4. 批量重命名。
  5. 调 Playwright 截图。
  6. 检查 Markdown 链接。
  7. 统计测试覆盖率。

这些事让模型手写很容易出错,脚本更稳。

一个简单结构

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 位参与者

阅读完整话题

来源: LinuxDo 最新话题查看原文