该技能用于为 block/goose 开源项目基于 Docusaurus 的博客撰写文章。
用途:撰写并落地 goose 项目博客文章,覆盖从确定写作模式、收集文章信息到生成目录与文件的流程。
主要能力: 提供三种写作模式:“我有草稿”“我有笔记/大纲”“帮我写”。模式 1、2 优先保留作者语气与意图,只处理结构、规范与润色;模式 2、3 会先产出草稿供作者审阅。 可创建文章目录、frontmatter、作者条目与横幅图引用,并按博客规范审校。
使用方式:需先本地克隆 goose 仓库(gh repo clone block/goose),博客目录为 <goose-repo>/documentation/blog/,需确认 authors.yml 与 blog 目录存在。文章目录命名采用 YYYY-MM-DD-slug-title/,内含 index.md 与 banner.png。frontmatter 需包含 title、description、authors,作者键须存在于 authors.yml;不加 date 与 tags。正文用 ## 与 ###,代码块需带语言标识,介绍段后加 <!--truncate-->,文末需包含含 Open Graph 与 Twitter 卡片的 <head> 段。横幅图建议 1200×600,并同时用于社交分享。
本地预览:在 documentation 目录运行 npm start,启动后访问 http://localhost:3000 可预览并获取带内容哈希的图片地址,用于填入 og:image 与 twitter:image。
适用场景:教程与操作指南、深入解析、社区人物、工具对比、版本公告、技巧与工作流、观点文章。
限制:需要本地克隆仓库并安装依赖;og:image 的真实文件名无法猜测,必须通过本地预览获取;若用户未提供图片,只能先以占位符提醒补交,未说明具备图片生成能力。