可复制的 Skill 文件内容
这页用于说明如何把 creating-generators skill 放进自己的项目里，并确保复制的是当前最新版本。
从 2026-03-25 起，本页不再内嵌整份 SKILL.md 和 reference.md 的长代码块，而是改为指向唯一事实来源，避免文档页与真实 skill 文件长期漂移。
唯一事实来源
请始终以这两个文件为准：
generator-sdk/generator-sdk-mcp/skills/creating-generators/SKILL.mdgenerator-sdk/generator-sdk-mcp/skills/creating-generators/reference.md
如果你是在当前仓库里阅读文档，也可以直接对照：
.cursor/skills/creating-generators/SKILL.md.cursor/skills/creating-generators/reference.md
它们应该保持同步。
目标目录结构
txt
.cursor/
skills/
creating-generators/
SKILL.md
reference.md复制方式
方式一：从当前仓库直接复制
如果你就在这个仓库里工作，直接复制这两个文件到目标项目：
txt
.cursor/skills/creating-generators/SKILL.md
.cursor/skills/creating-generators/reference.md方式二：从 generator-sdk-mcp 包内容复制
如果你使用的是发布后的 @atomm-developer/generator-sdk-mcp，请从包内的以下目录复制：
txt
skills/
creating-generators/
SKILL.md
reference.md方式三：让 AI 帮你安装或同步
你可以直接对 AI 说：
text
请帮我把 creating-generators skill 安装到当前项目，并确认 SKILL.md 与 reference.md 使用的是最新版本。复制后必须确认的 3 类约束
如果你不是直接复制唯一事实来源，而是通过其他页面、聊天记录或旧模板手工粘贴，至少要确认下面三类约束已经存在。
1. 任务口径区分
旧生成器重构必须先区分：
兼容性重构标准化重构
如果 skill 里还只有“重构已有生成器”，但没有把这两种口径拆开，说明你拿到的是旧版本。
2. 标准化完成态门禁
skill 必须明确规定：
- 哪些条件满足后，才能宣称“已完成标准化重构”
- 哪些情况只能表述为“阶段性交付”或“兼容性重构完成”
特别是下面这些门槛应被明确写出来：
generator-sdk平台能力已接入- 完整 runtime contract 已暴露
full/embed双入口可运行window.__GENERATOR_RUNTIME__已暴露getPanelSchema()+PanelFilter可被宿主消费- 模板场景走统一模板协议
3. 强制收尾模板
最终回复里必须显式包含：
任务口径当前阶段已完成项未完成项是否可宣称标准化完成阻塞点或风险兼容性与迁移说明
如果没有这类收尾模板，AI 很容易把“部分完成”说成“按 skill 做完了”。
推荐的首次提问方式
新建生成器
text
帮我做一个新的相框生成器。旧生成器兼容性重构
text
这是一个旧生成器源码 @index.html。
请在 @refactor 目录中做兼容性重构：
1. 所有功能、交互、样式、导出行为不能改变
2. 接入 generator-sdk
3. 允许分阶段交付，但不要误报为标准化完成旧生成器标准化重构
text
这是一个旧生成器源码 @index.html。
请在 @refactor 目录中做标准化重构，而不是只做最小兼容改造：
1. 所有功能、交互、样式、导出行为不能改变
2. 接入 generator-sdk
3. 补齐完整 Generator Runtime Contract
4. 提供 full / embed 双入口
5. 支持 PanelSchema + PanelFilter
6. 如果涉及模板场景，使用统一模板协议
7. 未达到标准化完成态前，不要宣称已完成标准 generator 改造复制完成后的自检清单
你可以让 AI 或自己检查：
text
请检查当前项目中的 creating-generators skill 是否满足：
1. 区分兼容性重构与标准化重构
2. 包含标准化完成态门禁
3. 包含强制收尾模板
4. 重构分支先问任务口径，再问旧代码位置
5. reference.md 与 SKILL.md 口径一致