SuperAPI AI 工具集

better-writing

写作与研究

查看项目

更新于 10-15 17:26

技能介绍

用途:为一个产品界面撰写或评审所有面向用户的文案,从按钮、链接、错误消息到空状态、占位符和设置项。核心理念是文案融入界面——清晰简短胜过聪明,一致胜过多样,最好的错误消息是被重新设计到不会发生的交互。

主要能力与原则:先侦察既有语气,检查附近文案、产品术语、本地化约定与风格指南;一个声音、灵活语气,成功与引导可温暖,常规操作中性,错误与破坏性确认平静且不可俏皮,数据丢失与安全需严肃明确;直接称呼读者为“you”,少用物主代词;用平实词,删去不必需的词,不拼接变量片段,使用完整模板字符串并处理复数;按钮动词开头,命名具体动作,确认按钮重复后果而非“是/否”;多步流程统一词汇;链接文本脱离上下文仍可理解,不用“点击这里”;每种元素类型只用一种大小写策略;设置项标注开启状态;错误说明如何修复且紧贴出错字段,提示用正面表述并在犯错前显示,若无改进则重设计交互;空状态说明此处是什么并给出一个明确的下一步,搜索空状态需点名查询词并提供退出方式;占位符展示预期格式而非字段名。

使用方式:当用户要求独立文案评审时,按两栏输出。发现按原则分组,用 Markdown 表格列出严重度、位置、修改前、修改后与原因,位置引用 path/to/file:line 或具体屏幕与组件,修改后给出完整替换文案,原因说明违反的原则及理解或信任成本;重复的系统性问题合并为一行并列出所有受影响位置。随后给出验证:列出实际执行的检查及观察结果,包括完整流程、变量插值、复数与窄宽换行,未执行的检查写明仍需验证。最后给出结论:仍有 HIGH 为 Block,仅剩 MEDIUM 或 LOW 为 Needs changes,无问题为 Approve。当无发现时省略表格,声明无可行文案发现,报告验证并给出 Approve。若由 better-interface 编排评审,则向其提供领域证据与发现,由其输出格式、严重度、合并规则与结论优先。

关联与限制:文案如何渲染(text-transform 大小写、截断、智能标点)属 better-typography;错误标记与播报(aria-invalid、live regions)属 better-accessibility;翻译字符串空间属 better-layout。若这些技能不可用,保留本地最低要求:渲染上,仅当源文本保持自然大小写时用 text-transform 大写,并在可换行容器上用 text-overflow: ellipsis 截断;错误标记上,用 aria-invalid="true" 标记无效输入,并用 aria-describedby 将可见消息与字段关联;播报上,用 live region(如 role="status")播报提交后结果,消息保持简洁;翻译上,按钮、标签和表头预留至少 30% 扩展空间,绝不跨语言拼接片段。严重度定义为:HIGH 误导用户、掩盖后果或阻止恢复;MEDIUM 使任务更难理解;LOW 为孤立的语气或一致性打磨。资料未提供安装方式、收费、平台或价格信息。