该技能用于撰写或编辑该站点的 MDX 随笔,目标是产出带粘性图示、旁注卡片和嵌入媒体的滚动叙事式内容。
用途:为随笔提供统一的结构、组件与文风规范,让文章呈现可滚动阅读体验。
主要能力: 一是 Scene 组件,将图示与正文配对成两列布局,图示在阅读正文时保持粘性。属性包括 figure(必填,来自 components/mdx/figures.tsx 的 React SVG 组件)、caption(可选,图示下方短标签)、side(可选,left 默认或 right)。规范要求连续 Scene 交替左右;每个 Scene 放 1-3 节正文;首篇 Scene 尽早出现在前 2-3 段;移动端上下堆叠,故两种布局下内容都需成立。 二是图示组件,位于 components/mdx/figures.tsx,使用共享颜色常量 C,默认画布 viewBox="0 0 320 320",SVG 加 className="w-full",并在 components/mdx/mdx-components.tsx 注册。图示应为讲解性、示意性而非装饰。文中列举了 PollingFigure、ProactiveFigure、TripleFigure、WebhookTaxFigure、RuntimeFigure、PromptLayerFigure、GapMapFigure 等既有图示。 三是 Callout,支持 thought、warm、cool 三种语气,配 3-6 词短标签,每篇 2-4 个。 四是 PullQuote,用于单句强调,每篇至多一个。 五是 Sidenote,桌面端显示在页边;因其绝对定位可能覆盖下文,空间不足时改用 Callout。 六是嵌入媒体,如 iframe 嵌入 LinkedIn、Twitter 等内容,应贴近其所说明的上下文。
使用方式:按上述结构与组件撰写 MDX;发布前对照检查清单,包括至少 2 个交替方向的 Scene、2-4 个不同语气的 Callout、外链与内部相对路径(/posts/slug)、不使用 HTML 实体而用真实 Unicode 字符、不用 markdown 表格而用 HTML table、frontmatter 摘要用纯文本、在 components/card-illustrations.tsx 添加卡片插图、注册新图示组件等。
文风限制:避免以“That's the [noun].”式短句收尾、戏剧化结尾、品牌短语重复(“clock, listener, inbox”最多 2-3 次)、三段式排比滥用、破折号过密、以“This matters because”开头、使用“uncomfortable truth/math/pattern”标签,以及编造未经历的事件或运维声明。