AI SKILL
约 318 字大约 1 分钟
2026-01-16
SkILL 最小可用稳定文件夹结构
skill-name/
├── SKILL.md
├── scripts/
└── references/
├── examples.md
└── gotchas.mdSKILL.md：说明 何时用、输入、输出、怎么跑、成功标准、限制
scripts/：把“可执行”落地，别让 agent 纯靠脑补
references/ 用来放：
- 示例（输入/输出）
- 坑点（常见失败原因、处理方式）
- 外部依赖说明（API、环境变量、权限）
规模化（团队/多 skill 时才需要），这时才考虑统一的命名（commands/agents/opencode.json 等），目的是：新人一眼能找到入口，多人维护时不互相踩，方便工具扫描、lint、CI 校验。
文件名你可以不写死，但信息必须写死（不然 agent 还是会乱）：
- 入口命令：到底执行哪个脚本（例：
scripts/run.sh） - 输入：从哪来（参数/文件/环境变量）
- 输出：产物位置、格式（stdout/json/report 文件）
- 约束：不能做什么（比如别改公共 API、别引依赖）
- 验收标准：怎么确认成功（跑哪些 tests / checks）
SKILL 市场 和 anthropics/skills 里面有不少实用的Skills，甚至有生成Skills的Skill，就是这个skill-creator。
Skills，翻译过来就是技能，字面意思上非常简单，给Agent用的技能，或者说给 Agent 开发的工作流