单文件输出参考

要解决什么问题

在开发编程场景里，模型经常把补丁、脚本或说明拆成多个片段或多文件路径，你还得自己拼成可运行、可归档的一份交付物。对话轮次一多，漏段、顺序错乱、路径对不上 的情况很常见；有些环境也只方便粘贴或保存单个文件。

「单文件输出参考」这类技能的作用，是把「最后应该长什么样」写成可复用的约定：模型在收尾时优先给出一份自洽的单文件结果（或明确标注哪些部分必须同文件出现），而不是散落的代码块。

技能如何工作

从名称与定位可以把它理解成输出形态的参考规范，而不是替你写业务逻辑的实现库。典型用法包括：

• 在任务说明里引用该技能，要求最终交付为单文件（例如一个 .py、.html 或带 front matter 的 Markdown）。
• 约定文件内部结构：顶部元信息、依赖说明、main 或入口、辅助函数顺序，避免「只有片段没有入口」。
• 对必须外置的配置或密钥，用占位符或注释块说明，而不是静默省略。

核心思路是：先对齐交付形态，再生成内容；模型按同一套参考减少「能跑但得手工合并」的返工。

适用边界与注意点

• 单文件适合原型、脚本、静态页、小型工具；模块化的中大型仓库仍应拆目录，不宜强行塞进一个文件。
• 参考技能不替代版本管理、测试与 lint；产出是否可运行仍要你在本地验证。
• 若 SKILL 正文未展开具体模板，实际约束以你在对话中写明的格式为准；技能名提供的是方向，细节需你补充。