scripts、references、examples、templates 什么时候需要，密钥怎样变量化

按内容职责拆目录，不为完整而建空文件夹

SKILL.md 放核心流程；重复且确定的操作放 scripts；需要按需读取的知识放 references；示例用于说明边界；templates 保存交付骨架。个人路径和密钥全部变量化。

scripts

可测试、可重复且人工重写容易出错的操作；脚本有参数、错误和安全边界。

记录客户端版本、Skill 版本、触发输入、实际步骤、工具调用和输出，正例与反例都要保留。

references

体量较大、仅部分任务需要的规范与资料，SKILL.md 指明何时读哪份。

确认“references”已经有可回查结果，再进入“examples”；依据仍然来自猜测时，把缺口单列并停在当前步骤。

examples

真实脱敏的正例、反例和边界输出，说明为什么合格或失败。

确认“examples”已经有可回查结果，再进入“templates”；依据仍然来自猜测时，把缺口单列并停在当前步骤。

templates

可复制的文档、配置或结果结构，保留变量和填写说明，不内置个人数据。

确认“templates”已经有可回查结果，再进入“变量与依赖”；依据仍然来自猜测时，把缺口单列并停在当前步骤。

变量与依赖

路径、账号、端点和密钥通过参数或环境注入，列平台、运行时和安装检查。

脚本、网络、凭证和写操作必须在说明中可见；触发边界不清或结果不可验收时不要扩大使用范围。 完成后把证据归入“完整 Skill 目录与变量清单”。

删除未被流程引用的文件

换一台干净环境测试所有相对路径、依赖和缺变量行为。目录看起来完整但无法被 Skill 按需使用，只会增加维护负担。