一、目录创建条件分析
根据 SKILL.md 的定义，scripts/、references/、assets/ 是可选目录，只有在特定需求出现时才会创建：
| 目录 | 创建条件 | 使用场景 |
|---|---|---|
scripts/ |
技能需要可执行代码来完成确定性/重复性任务时 | 数据转换脚本、格式化工具、验证脚本等 |
references/ |
技能需要加载额外的文档到上下文中时 | API 文档、框架指南、配置规范等 |
assets/ |
技能需要使用模板、图标、字体等文件时 | HTML 模板、图标资源、样式文件等 |
关键触发点
"If all 3 test cases resulted in the subagent writing a
create_docx.pyor abuild_chart.py, that's a strong signal the skill should bundle that script."
这意味着目录是按需创建的，在技能迭代过程中发现需要可复用资源时才会添加。
二、10个示例提示词（覆盖所有功能）
功能覆盖清单：
- 创建新技能（含完整目录结构）
- 编写测试用例
- 运行和评估测试
- 迭代改进技能
- 描述优化
- 打包技能
- 盲比较
- 更新现有技能
- 创建带脚本的技能
- 创建带参考文档的技能
Demo 1: 创建基础技能（触发 SKILL.md 创建）
提示词：
我想创建一个技能，用于将 Markdown 文件转换为 PDF。当用户说"把这个 md 文件转成 PDF"或者"生成 PDF 文档"时触发。
输出应该是一个 PDF 文件。请帮我创建这个技能。效果：
- 创建
markdown-to-pdf/目录 - 创建
markdown-to-pdf/SKILL.md（包含 name、description 和转换步骤） - 不会创建
scripts/、references/、assets/（因为不需要）
Demo 2: 创建带脚本的技能（触发 scripts/ 目录）
提示词：
我需要一个技能来批量处理 CSV 文件。功能包括：1）合并多个 CSV；2）计算列统计信息；3）格式转换为 JSON。
当用户提到"处理 CSV"、"合并数据"、"数据统计"时触发。请创建这个技能并包含必要的 Python 脚本。效果：
- 创建
csv-processor/目录 - 创建
csv-processor/SKILL.md - 创建
csv-processor/scripts/目录，包含：merge_csv.py- 合并多个 CSV 文件stats_calculator.py- 计算列统计信息csv_to_json.py- CSV 转 JSON 转换脚本
Demo 3: 创建带参考文档的技能（触发 references/ 目录）
提示词：
帮我创建一个 AWS S3 操作技能。功能包括创建存储桶、上传文件、设置权限。当用户说"S3"、"存储桶"、"上传文件到 AWS"时触发。请包含 AWS S3 API 的参考文档。效果：
- 创建
aws-s3/目录 - 创建
aws-s3/SKILL.md - 创建
aws-s3/references/目录，包含：s3-api.md- S3 API 使用参考bucket-policies.md- 存储桶权限策略参考best-practices.md- S3 使用最佳实践
Demo 4: 创建带模板资产的技能（触发 assets/ 目录）
提示词：
我需要一个技能来生成项目报告。报告需要包含：标题页、目录、执行摘要、详细内容、图表。当用户说"生成报告"、"写项目总结"、"创建文档"时触发。
请包含报告模板。效果：
- 创建
report-generator/目录 - 创建
report-generator/SKILL.md - 创建
report-generator/assets/目录，包含：report-template.html- 报告 HTML 模板styles.css- 报告样式logo.png- 公司 Logo
Demo 5: 创建完整技能（包含所有目录）
提示词：
帮我创建一个 Vue 组件生成器技能。功能包括：1）根据用户输入生成 Vue 3 组件代码；2）生成单元测试文件；3）生成组件文档。
当用户说"创建 Vue 组件"、"生成组件"、"写组件代码"时触发。请包含：模板文件、代码生成脚本、Vue 3 最佳实践文档。效果：
- 创建
vue-component-generator/目录 - 创建
vue-component-generator/SKILL.md - 创建
vue-component-generator/scripts/：generate_component.py- 组件代码生成脚本generate_test.py- 测试文件生成脚本
- 创建
vue-component-generator/references/：vue3-best-practices.md- Vue 3 最佳实践component-structure.md- 组件结构规范
- 创建
vue-component-generator/assets/：component-template.vue- Vue 组件模板test-template.spec.ts- 测试文件模板
Demo 6: 添加测试用例（触发 evals/ 目录）
提示词：
我已经有一个技能在 /path/to/my-skill，现在需要为它添加测试用例。技能功能是格式化代码。请帮我创建测试用例来验证它的正确性。效果：
- 创建
my-skill/evals/目录 - 创建
my-skill/evals/evals.json，包含 2-3 个测试用例：- 测试 Python 代码格式化
- 测试 JavaScript 代码格式化
- 测试代码错误处理
Demo 7: 运行测试和评估（触发 workspace/ 目录）
提示词：
请运行我刚创建的 markdown-to-pdf 技能的测试用例，并生成评估报告。效果：
- 创建
markdown-to-pdf-workspace/目录 - 创建
markdown-to-pdf-workspace/iteration-1/目录 - 运行测试用例（with_skill 和 without_skill）
- 生成
benchmark.json和benchmark.md - 启动评估查看器
Demo 8: 迭代改进技能（触发改进循环）
提示词：
测试结果显示我的 csv-processor 技能在处理大型文件时性能不佳。请帮我改进这个技能。效果：
- 分析测试结果和反馈
- 改进
SKILL.md中的处理逻辑 - 更新
scripts/中的脚本（添加分块处理、优化算法） - 运行新的迭代测试（
iteration-2/） - 生成新的评估报告
Demo 9: 优化技能描述（触发描述优化功能）
提示词：
我的 vue-component-generator 技能触发不够准确，有时该触发时不触发。请帮我优化它的描述。效果：
- 生成 20 个触发评估查询（should-trigger 和 should-not-trigger）
- 使用
scripts/run_loop.py运行优化循环 - 更新
SKILL.md的 description 字段 - 显示优化前后的对比和评分
Demo 10: 打包技能（触发打包功能）
提示词：
我已经完成了我的 report-generator 技能的开发和测试，请帮我打包它以便分享给团队成员。效果：
- 运行
python -m scripts.package_skill命令 - 生成
report-generator.skill文件 - 提供文件路径供用户下载和安装
三、总结
scripts/、references/、assets/ 目录的创建完全取决于技能的实际需求：
scripts/：当技能需要可复用的代码逻辑时创建（如数据处理、文件生成脚本）references/：当技能需要参考文档支持时创建（如 API 文档、规范指南）assets/：当技能需要模板或静态资源时创建（如 HTML 模板、样式文件）
这10个示例提示词覆盖了 skill-creator 的全部核心功能：
- 创建新技能（含各类目录结构）
- 编写测试用例
- 运行评估和生成基准
- 迭代改进
- 描述优化
- 打包发布