浏览 AI 知识库
Skill 目录结构：什么时候需要 scripts、references 和 templates
SKILL.md 负责核心判断，长资料放 references，可重复动作放 scripts，可复用成品放 templates。目录怎样拆，取决于内容的用途和更新方式。
沿完整工作流推进
前一阶段的可检查结果，是下一阶段的输入；中间证据不足时停在当前阶段。
几千行都塞进 SKILL.md，和把关键逻辑藏进脚本一样难维护
所有说明、长参考、脚本和 HTML 模板都塞进 SKILL.md，文件超过几千行；另一版又把本机绝对路径和 API Key 写进脚本。两种都无法可靠分发。
- 每个文件有单一职责
- 路径可移植且无秘密
- 按需资源在流程中有入口
先确认这次任务的起点、边界和交付
| 需要确认 | 本例内容 |
|---|---|
| 现有材料 | Skill 需要一段稳定工作流、一个浏览器辅助脚本、两份按需参考和一个输出模板。 |
| 不能越过的边界 | SKILL.md 只保留路由与关键规则；确定性操作放 scripts；长资料放 references；复用骨架放 templates；秘密用变量。 |
| 要交付的结果 | 完整 Skill 目录与变量清单 |
从“scripts”走到“变量与依赖”
| 当前阶段 | 实际处理 |
|---|---|
| scripts | 可测试、可重复且人工重写容易出错的操作；脚本有参数、错误和安全边界。 |
| references | 体量较大、仅部分任务需要的规范与资料，SKILL.md 指明何时读哪份。 |
| examples | 真实脱敏的正例、反例和边界输出，说明为什么合格或失败。 |
| templates | 可复制的文档、配置或结果结构，保留变量和填写说明，不内置个人数据。 |
| 变量与依赖 | 路径、账号、端点和密钥通过参数或环境注入，列平台、运行时和安装检查。 |
图片交付检查的五类文件各自承担一个职责
| 目录/文件 | 内容 | 何时读取 | 验收 |
|---|---|---|---|
| SKILL.md | 输入、流程、停止和报告字段 | 每次触发 | 新成员可按文档完成最小用例 |
| scripts/check-images.mjs | 尺寸、命名和色彩空间检查 | 需要重复运行时 | 参数、退出码和错误可测试 |
| references/platform-rules.md | 平台尺寸和格式规范 | 用户指定平台时 | 正文链接到具体章节 |
| examples/ | 脱敏正例、反例和失败报告 | 遇到边界或排查时 | 能说明为什么通过/失败 |
| templates/report.csv | 固定报告表头和缺失标记 | 生成交付物时 | 无个人路径、账号或密钥 |
目录名和内容为示例；实际项目只保留被流程引用且能在干净环境使用的文件。
完成后的完整 Skill 目录与变量清单
目录包含 `SKILL.md`、`scripts/package.mjs`、`references/editor-fields.md`、`references/troubleshooting.md` 和 `templates/article.md`。所有路径相对 Skill 根，依赖与变量清单完整，不含个人目录和密钥。
为什么“拆目录后，Agent 找不到何时读参考”还不能交付
拆目录后，Agent 找不到何时读参考
- 原因
- SKILL.md 没有明确资源路由
- 怎么改
- 在对应步骤写何时读取哪个文件，不让执行者遍历整个目录猜