SuperAPI AI 工具集

frontmatter-description

写作与研究

查看项目

更新于 10-16 00:32

技能介绍

用途:检查并优化 Markdown 文档文件中的 MetaDescription frontmatter 字段,为不符合规则的描述给出可执行的修改建议。适用于新增或编辑文档页面时撰写 MetaDescription、审计现有页面的 SEO 或可发现性、被要求检查审查或优化 frontmatter 描述、以及内容改动后确保描述同步更新。

主要能力与规则:MetaDescription 必须满足长度不超过 160 字符;语气面向行动、突出价值、事实性且非人称;不得使用 “you can”“users can”“this page explains” 等表述;须为完整句子而非片段或标签;不得包含冒号(会破坏 YAML 解析);各页面描述必须唯一;须保留已有的 {% data variables.<group>.<name> %} 可复用变量,不得替换为渲染后的产品名。描述还应体现页面主要受众、读者意图与文章目的。若页面与作者请求存在多种实质不同解读,应先请作者确认定位。

流程:先确定目标文件(指定文件或递归查找文件夹内所有 .md,跳过无 YAML frontmatter 的文件);然后读取页面以识别受众、意图与目的,再读取 frontmatter 检查 MetaDescription 是否缺失、超长、含读者称呼、语气不当、缺少功能或工具上下文、与内容不符,以及是否含 “teaching”“enable”“disable” 等禁用词、冒号、版本号、Jinja2 变量、HTML 标签或 Markdown 格式;对可复用变量需确认其完整路径存在于 data/variables 且解析为预期文本,并原样保留。

报告与修复:以表格按文件路径分组呈现文件、问题、当前值与建议修改;若被要求修复,仅修改 MetaDescription 值,不改动其他 frontmatter 字段与正文,保留可复用变量并验证修改后符合全部规则。

限制:仅针对 MetaDescription;不涉及 SEO 排名、收费或平台等未提供信息。