SuperAPI AI 工具集

datocms-cli

部署与运维

查看项目

更新于 10-15 20:33

技能介绍

用途:面向 DatoCMS 官方 CLI 的命令行操作,涵盖迁移(migrations)、schema 代码生成、schema 检查、一次性 CMA 调用、类型化 TypeScript CMA 脚本、环境操作与部署等,也用于本地项目配置。

主要能力:通过 npx 运行 datocms 命令(CLI 不依赖 which datocms),支持登录、项目列举与 link、whoami、schema:inspect、migrations:new/run、environments 相关命令、imports、maintenance、plugins:reset、cma:call 与 cma:script 等。skill 附带 references/ 参考文件按任务类型加载(如 creating-migrations.md、running-migrations.md、schema-generate.md、schema-inspect.md、direct-cma-calls.md、cma-script.md、environment-commands.md、deployment-workflow.md、blueprint-sync.md、importing-content.md、cli-setup.md 等),并提供可复制进仓库的 scripts/ 与 assets/(GitHub Actions 工作流)。

使用方式:检测上下文后复用已有 CLI 配置;未链接时先 npx datocms login(交互),再 npx datocms projects:list --json、npx datocms link --site-id=<ID>,link 前必须向用户确认目标项目。schema 相关代码或变更前先运行 npx datocms schema:inspect。迁移用 migrations:new 脚手架生成,指定 --source、先 dry-run,优先 fork-and-run 而非对主环境 --in-place。执行前需校验认证方式、profile、环境与输出路径。

适用场景:CLI 命令与标志说明、迁移创建与执行、schema 生成与检查、环境管理、部署工作流、多项目同步、内容导入、CLI 插件管理,以及一次性 CMA 调用或可复用的类型化 CMA 脚本。

限制与路由:交互式 CLI 用 OAuth 登录,无人值守(CI、cron、服务端、共享脚本)需 CMA 令牌,只读 CDA 令牌不可用;不要单纯为替代现有远程 MCP 连接而安装 CLI。破坏性操作(environments:destroy/promote、导入到非显然可弃目标、主环境上的 migrations:run --in-place、maintenance:on --force、environments:fork --fast --force、cma:call 的 destroy/bulk_destroy/promote、对主环境直接 schema 变更、plugins:reset)需明确确认。纯 Structured Text 或本地 DAST 工作应先走 datocms-structured-text;CMA API 调用、程序化环境管理、消费生成类型、GraphQL 前端查询、框架集成、插件开发、整体方案规划等分别路由到 datocms-cma、datocms-cda、datocms-frontend-integrations、datocms-plugin、datocms-setup。安装命令保持原文:npm install --save-dev datocms。缺失的同系列参考需从 datocms/agent-skills 安装完整包。未提及的收费、价格等信息暂未提供。