SuperAPI AI 工具集

content-design

写作与研究

查看项目

更新于 10-15 16:38

技能介绍

用途

content-design 是 n8n 仓库中的一个内容设计技能,定位为面向 UI 文案的产品内容设计师。它适用于撰写、审查或审计面向用户的文本,例如按钮标签、错误消息、工具提示、空状态、模态框等。其核心理念是把内容当作界面的一部分:每一个标签、错误消息和工具提示都是一项设计决策。

主要能力

该技能提供三种工作模式:

  • Write:起草新的 UI 文案。需要先确认文案出现的界面(按钮、模态框、工具提示、错误、空状态等)以及用户动作或系统状态,然后给出 1-3 个按推荐度排序的选项。每个选项包含文案本身、目标界面、建议的 i18n 键(遵循命名规范)以及一行理由。
  • Review:用户提供现有文案或指向文件,逐条对照规则检查,返回表格(位置、当前文案、问题、建议修改),并按严重程度分组:先术语违规,再语气,最后语法与格式。若全部合规,则给出简要的检查摘要。
  • Audit:扫描一个文件或一组文件(Vue 组件、i18n JSON),使用 Grep 和 Glob 查找模式并报告。

技能还包含 n8n 中文案所在位置的说明、i18n 模式与键命名规范、内容指南(语言与语法、语气与声音)、UI 文案模式(动作标签、错误消息、空状态、占位符、确认对话框、工具提示、截断)、术语表、n8n 特定约定、未覆盖界面的处理方式、常见审计模式以及最终检查清单。

使用方式

调用时先判断用户需要哪种模式。Write 模式需询问界面类型和用户动作或系统状态;Review 模式需用户分享现有文案或指向文件;Audit 模式需扫描文件或文件集。技能中给出了 n8n 仓库内文案的常见位置,例如 packages/frontend/@n8n/i18n/src/locales/en.json 存放所有 UI 字符串,Vue 模板中可能有内联文案,节点描述文件中有硬编码的显示名、描述、动作和占位符字段等。编辑文案时优先修改 i18n JSON(en.json),而非 Vue 文件中的硬编码字符串;若发现 Vue 模板中有面向用户的硬编码字符串,应标记出来,因为它们应使用 i18n。

i18n 模式按优先级为:i18n.baseText('key')(首选)、$t('key') / t('key')(Vue i18n 插件简写)、locale.baseText('key')(旧模式)。i18n 键命名采用与功能区域匹配的层级点号表示法,例如 generic.* 用于通用标签,featureArea.subArea.element 用于功能范围文案,_reusableBaseText.* 和 _reusableDynamicText.* 用于共享常量或带动态回退的共享文本。建议新键时需遵循现有层级,浏览 en.json 中邻近键以匹配嵌套深度和命名风格。

适用场景

该技能适用于 n8n 产品内的 UI 文案工作,包括撰写新文案、审查现有文案、审计文件中的违规。它覆盖的界面包括按钮、模态框、工具提示、错误消息、空状态、加载状态、成功通知、状态标签、占位符、确认对话框等。

限制

该技能是 n8n 仓库内的内容设计指南,其术语表、i18n 键命名规范、文件路径和 n8n 特定约定(如 "n8n" 始终小写、节点名称首字母大写等)均针对 n8n 项目。它不提供通用的文案生成能力,也不涉及收费、价格、平台或效果等信息。对于指南未覆盖的界面,技能要求应用相同的语气与声音原则,并在没有指南覆盖时标记不一致,而不是猜测。