SuperAPI AI 工具集

datocms-plugin-scaffold

编程与开发

查看项目

更新于 10-15 20:33

技能介绍

用途:帮助用户从零创建全新的 DatoCMS 插件项目,搭建最小可运行的首版脚手架,基于 datocms-plugin-sdk 和 connect() 实现。初始脚手架保持窄范围,后续编辑与扩展交由 datocms-plugin-builder 处理。

主要能力与流程:

  1. 确认模式:静默检查当前目录,识别是否已存在插件(含 datocms-plugin-sdk 的 package.json、connect() 入口、Vite 配置)。若已存在且请求是编辑,则切换到 datocms-plugin-builder;在提问前先推断起始界面。
  2. 仅询问缺失的要点:插件/文件夹名称、私有还是市场插件、初始界面/目标范围、是否需要 currentUserAccessToken 或外部 API。信息已明确时跳过。
  3. 加载小型参考集:references/project-scaffold.md 与 references/surface-starters.md,用于首次实现;扩展与维护转交 datocms-plugin-builder。
  4. 生成项目:在当前工作目录创建插件目录,采用参考文档中的 Vite/React 布局,只添加必要入口。私有插件保持元数据精简;市场插件需设置 npm 名称、keywords、homepage、permissions。只添加必需的可选依赖,验证前先安装。
  5. 接通首个界面:使用参考文档处理 declaration、render、execute 钩子。约束包括:一个顶层 connect();UI 包裹在 <Canvas ctx={ctx}> 中,页面/检查器/全宽侧边栏使用 noAutoResizer;ID 分发的 render 钩子用 switch;SDK 类型用 import type { ... };ctx.openModal() 参数与 ctx.resolve() 保持 JSON 可序列化;模块化内容/单块/结构化文本不使用编辑器字段扩展;停在最小可运行首版。
  6. 验证:用所选包管理器安装依赖,运行 build,告知用户开发命令与本地插件安装方式,并指出最重要的手动界面检查项。

跨技能路由:既有插件维护转 datocms-plugin-builder;原生 UI 设计/布局重设转 datocms-plugin-design-system;独立 CMA 脚本/schema 工作转 datocms-cma。

限制:具体依赖版本、安装命令、价格与平台支持等资料暂未提供;该技能不负责既有插件的维护与扩展。