以 Agent Skills 格式为例，一个目录以 `SKILL.md` 为入口，写明名称、适用范围和操作步骤；脚本放在 `scripts/`，长说明放在 `references/`，模板或图片等材料放在 `assets/`。 渐进式加载分三步：启动时只读取名称和描述，用于匹配任务；选中后读取主要指令；执行到相关步骤时，再读取需要的参考文件或运行脚本。这样可避免所有 Skills 一次性占满上下文。 主文件应说明每个资源何时使用、输入输出是什么、失败时怎么处理。不要让入口文件变成巨大的资料仓库，也不要依赖无法定位的隐式路径。 脚本执行仍要检查依赖、权限和参数。文件里的文字属于外部内容，不能自行提高权限或覆盖用户要求。  参考：[Agent Skills 格式规范](https://agentskills.io/specification)。