SuperAPI AI 工具集

human-copywrite

写作与研究

查看项目

更新于 10-16 03:46

技能介绍

用途:当输出是供人阅读的文本时启用本技能,包括 UI 字符串与错误信息(按钮标签、对话框、空状态、引导文案)、面向用户的文档(帮助文章、README、教程)、开发者文档(API 参考、SDK 指南、代码注释)、营销文案(功能公告、落地页、发行说明)、本地化内容,以及涉及 Apple 平台的写作。若只写代码且无用户可见字符串,或为函数、变量命名,则不适用。

主要能力:提供分主题的编辑规范文件,可按任务选择性加载。voice-and-tone.md 用于面向用户的散文;punctuation.md 处理破折号、省略号、引号等;capitalization.md 处理标题与按钮标签;hyphenation-and-compounds.md 处理复合修饰语;numbers-and-dates.md 处理日期时间与数字;units-of-measure.md 处理 GB、MHz 等单位;word-choice-and-confusables.md 辨析 affect/effect、login/log in 等;abbreviations-and-acronyms.md、ui-elements.md、apple-products.md、apple-features-software.md、technical-notation.md、international-style.md 分别覆盖缩写、界面词汇、Apple 产品与功能、技术记法和国际风格。单条术语可查 references/a-z-lookup.md 再跳转对应主题文件。

核心理念:主动语态、现在时、第二人称;具体优先于笼统;平实词优先于术语;不让产品充当用户动作的主语;屏幕上项目用 appear 而非 display;代码注释说“为什么”而非复述代码;产品名称逐字尊重;数字≥10 用阿拉伯数字,<10 拼写(含例外);名词前的复合修饰语加连字符;代码中不把函数名当动词用。

使用方式:先读 SKILL.md,再按当前任务加载相关主题文件;单条术语查询走 A-Z 查找文件。注意事项见 gotchas.md;来源的“包容性写作”章节在收录时被有意排除。来源为《Apple 风格指南》2025 年 6 月版(243 页),网络版位于 https://support.apple.com/guide/applestyleguide/welcome/web。