让自己的 AI 开发插件
你负责说明想要的体验,AI 负责把需求转换成代码、检查与安装包。先选能够读写本地文件和运行终端的编程助手;只有聊天能力时,请让它明确交付源码和命令,运行与验收由你或协作者完成。
下载同一套规则
资料包包含 SKILL.md、技术约定、接口类型、六篇操作指南、参考插件源码及交付清单。它是开发参考,不是 .sfplugin,不要安装到熔炉;也不包含完整宿主或 npm 依赖。开发环境与取代码步骤仍然需要完成。
方法一 直接交给 AI
解压资料包,把整个 storyforge-plugin-author 文件夹交给 AI。打开 developer-prompt.txt,补充需求后复制给它;在工坊“开发与发布”也可以直接复制指令。只给提示词、不提供资料或匹配仓库,AI 仍可能猜错接口。
可以这样描述需求:
我要一个属于当前作品的“线索卡片”插件,可以新建、编辑、删除卡片,每张有名称、描述和已解决状态。希望按状态筛选,刷新后保留。先不接 AI 和外部网站,也不自动修改小说正文。请使用附件里的熔炉开发 Skill 和接口,交付安装包、源码、操作说明及实测结果。
你不需要指定数据库和框架。最好说清楚:在哪个作品/世界使用、想看到什么、点击后做什么、哪些内容要保存、要不要 AI 或联网,以及什么效果算完成。不确定的部分让 AI 解释选项。
方法二 用作 Skill
如果你的编程助手支持文件夹形式的 SKILL.md,按该工具自己的技能安装方式导入解压后的完整目录,不要只复制一个文件。将它作为 storyforge-plugin-author 使用;是否支持 $storyforge-plugin-author 这样的调用语法取决于工具,不能假定所有 AI 一样。
不支持 Skill 也没关系,明确要求 AI 读取目录里的 SKILL.md 和相关资料即可。这个 Skill 是给外部编程助手使用的,不是安装到熔炉的创作 Skill,也不会自动获得发布账号或上传权限。
AI 应怎样工作
- 检查资料包的 API/SDK 与目标熔炉版本,确认环境。发现不匹配时先说明,不把“api=1”当作所有预览版本都兼容。
- 把你的需求映射到公开能力,说明能做、需调整、暂不支持的部分。没有接口时提出功能建议,不通过修改宿主私有源码冒充插件。
- 选最接近的示例,只读相关资料,在独立插件目录实现。
- 运行
check和pack,在独立测试作品完成实际安装和数据验证。无浏览器或无模型凭据时,明确哪些没有验证。 - 交付安装包、源码、README、版本与依赖、网络及费用说明、验收记录;需要发布时按发布指南准备材料,再由你明确授权公开发布。
怎么判断它真的做完了
你应当收到可以导入的 .sfplugin,而不只是代码片段、截图或“构建成功”。按照使用说明安装后,目标功能要能操作;保存、刷新、停用和重新安装均有验证。使用模型、真实网络和本机服务的效果要分开标注,不把模拟通过当成真实服务已经可用。
例如“线索卡片”做完后应能创建两张卡、修改状态、筛选并在刷新后读到;这不意味着它已经能够自动从整本小说提取线索,后者需要独立确认读取范围和 AI 接口支持。