SuperAPI AI 工具集

moda-templates

通用与其它

查看项目

更新于 10-16 06:48

技能介绍

用途:moda-templates 用于从团队已批准的模板(画布)开始制作重复性产物,例如 QBR、董事会材料、发布稿、客户单页。模板承载布局与结构,层级高于品牌套件。当需求点名这类重复产物,或用户说“我们的模板”“我们惯用的格式”“我们有什么”时,应先检查模板;真正的一次性任务可跳过。

主要能力:moda template list 列出模板的 id、名称、类别与页数,空列表属正常结果,直接说明并重新设计。选择前先看:moda canvas screenshot [cvs_…] 可内联渲染模板(每次最多 3 页),用类别和页数先做廉价筛选。需要批量比较时用 moda template pull --output /tmp/templates.json,其 thumbnail_url 可下载,但会过期,不得放入标记、不得持久化、不得交给用户;thumbnail 为 null 表示尚未渲染。

使用方式:moda canvas create --name "[Q3 QBR — Acme]" --template [cvs_…] 会做服务端完整复制并保留源品牌套件;此时 --size、--pages、--category、--intent、--folder、--visibility、--brand 会被拒绝。复制后可用 moda drive move 放置,用 moda canvas brand [cvs_…] [bk_…] 重新绑定套件;换套件后必须重新样式化。复制品是普通画布,按常规方式读取和编辑,并告知用户起始模板。都不合适就一行说明后从零设计。

标记模板:moda canvas template [cvs_…] 发布给全团队,--clear 取消标记;这是团队可见的策展而非本地偏好,仅在用户称某物可复用时提议,不要标记一次性内容,也不要未经请求标记。私有画布被标记后只有自己可见,可用 moda drive visibility [cvs_…] team 共享。theme 是另一回事:仅用于幻灯片布局,经品牌套件应用,不会出现在 moda template list 中;把画布移出 theme 会清除所有 deck 链接与自动应用该 theme 的套件,重新标记也无法恢复。

编写模板:设计结构与布局而非内容;占位文本应命名槽位(如 Headline Text、Product Description、Company Name);为不同文本长度留出空间;占位图保持通用并维持对比度与可读性;用 metadata.name 命名元素以便后续填充;背景与文字颜色使用颜色变量(variableId)绑定;共享元素编辑应覆盖所有共享页面。

限制:需先加载 moda-core;写入固定修订版本时使用上次读取的版本,遇 stale_revision 重读并重试一次;出错用 moda ask "<question>"。404 表示该功能未在账户启用,按“无模板”处理,不重试不提及;403 表示仅管理员可标记。其他细节暂未提供。