SuperAPI AI 工具集

strand-content-schema

写作与研究

查看项目

更新于 10-15 17:29

技能介绍

用途:每篇 Strand 文章是 content/posts/<slug>.mdx 的 MDX 文件,其 YAML frontmatter 必须满足 packages/core/schema.ts 中定义的 PostFrontmatter。校验不通过的文章无法提交或合并。此技能用于一次写对 frontmatter,再通过 strand validate <slug> 或 MCP validate_post 工具自检。

主要能力与字段规则:必需字段为 title、slug、description、publishedAt、author;有默认值可省略的为 status(draft)、tags([])、type(BlogPosting)、noindex(false)、faq([])、sources([]);可选为 updatedAt、canonicalUrl、featureImage、og、summary。title 不超过 70 字符;description 为 50–160 字符(Bing 窗口 25–160,软目标 120–160);slug 为 kebab-case,正则 ^[a-z0-9]+(?:-[a-z0-9]+)*$,且与文件名一致;publishedAt/updatedAt 用 ISO 8601;author 必须引用已存在的 content/authors/<id>.mdx,新作者需先建文件;有 featureImage 时必须提供 alt。正文不得以 # H1 开头,应以便于直接回答的导语段落开篇,分节用 ##。

GEO 字段:summary 为不超过 280 字符的 TL;DR,供 speakable schema 与 AI 搜索摘录;type 用 NewsArticle(时效新闻)或 BlogPosting;faq 为 2–5 组真实问答,会输出为 FAQPage schema;sources 为每条外部事实声明提供来源条目。

使用方式:写好 frontmatter 后运行校验并修复报告中指出的字段,再交给 strand-publish。

限制:资料未提供安装方式、价格、支持平台及更多细节。