Tools · Skills
一个 Skill 的结构:SKILL.md、脚本、资源、触发条件
一个能用的 Skill 不是一段 Markdown。它要能被找到、能被执行、能被检查,还要说清权限边界。
SKILL.md:先写触发条件,再写步骤
开头写清楚:这个 Skill 解决什么问题、什么时候该用、什么时候不该用。然后写步骤:输入、动作、输出、失败分支、验收标准。
步骤要能被别人照着做。不要写“分析一下”,要写“读哪几个文件、跑哪条命令、检查哪几个字段”。
scripts:能跑,但要有边界
脚本要写清依赖、输入、输出、退出码、临时文件位置。涉及网络、密钥、写文件、删文件的步骤,要单独标注。
不要在没有说明的情况下执行远程脚本;不要把密钥写进 SKILL.md;不要把“删除/覆盖”做成默认动作。
resources:模板、示例、参考资料
模板要版本化;示例要标来源与许可;参考资料要写更新日期。图片、字体、表格模板都有版权,不能默认可商用。
资源不要塞得太多。Skill 的价值在“可执行”,不是“资料堆得全”。
触发条件与兼容性
写清适用客户端、需要哪些工具、需要什么权限、在什么目录下运行。兼容性不写,别人装了也可能跑不起来。
如果 Skill 只能在某个客户端用,直接写出来;不要用“通用”掩盖限制。