SuperAPI AI 工具集

content-author

前端与建站

查看项目

更新于 10-16 03:48

技能介绍

用途:在编写 HTML 文档中的正文、说明、描述等人类可读内容时,确保拼写、语法与风格达到质量标准。

主要能力与规则:项目使用 cspell 搭配自定义词典进行拼写检查,项目专有词保存在 project-words.txt,涵盖技术术语(如 XHTML、WCAG、htmlhint、pa11y、cspell、textlint、linkinator)、自定义元素(如 product-card、icon-element、user-avatar、status-badge、data-table、nav-menu)及 HTML 术语(如 doctype、tbody、thead、fieldset、hgroup、blockquote)。新增产品名或术语可用斜杠命令 /add-word TermName,或直接编辑 project-words.txt(每行一词)。风格上提倡主动语态、删除各种、很多、非常、有些、相当等模糊限定词;链接文字需具描述性;标题须遵循层级(每页一个 h1)。项目还用 Flesch-Kincaid 评分强制阅读难度阈值:一般内容最高 8 年级,技术内容最高 12 年级;技术文档可在 head 的 meta 或 html/body 上用 content-style=technical 标记。

使用方式与检查命令:质量检查通过 npm 脚本执行,如 npm run lint:spelling 检查拼写、npm run lint:grammar 检查语法与风格(建议性)、npm run lint:readability 检查阅读难度、npm run lint:content 运行全部内容检查。特殊内容需使用语义元素:内联代码用 code,代码块用 pre 加 code,键盘输入用 kbd,示例输出用 samp;缩写首次出现时用 abbr 定义;日期时间用 time 元素并带 datetime。

限制与相关技能:具体阈值、词典默认内容和 lint 配置细节以项目实际配置为准,资料未提供完整实现。相关技能包括 xhtml-author、fake-content、accessibility-checker、markdown-author。