一、目录创建条件分析根据 SKILL.md 的定义scripts/、references/、assets/是可选目录只有在特定需求出现时才会创建目录创建条件使用场景scripts/技能需要可执行代码来完成确定性/重复性任务时数据转换脚本、格式化工具、验证脚本等references/技能需要加载额外的文档到上下文中时API 文档、框架指南、配置规范等assets/技能需要使用模板、图标、字体等文件时HTML 模板、图标资源、样式文件等关键触发点“If all 3 test cases resulted in the subagent writing acreate_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合并多个 CSV2计算列统计信息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- 公司 LogoDemo 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的全部核心功能创建新技能含各类目录结构编写测试用例运行评估和生成基准迭代改进描述优化打包发布