SuperAPI AI 工具集

blog-writer

通用与其它

查看项目

更新于 10-16 00:32

技能介绍

用途:帮助在 blogs/ 文件夹中撰写新的 VS Code 博客文章,或审阅既有草稿。适用于用户要求“写博客”“起草博客”“新增博客”“审阅这篇博客”,或将 GitHub issue、PR 链接转化为博客文章,以及以叙事、对话方式宣布或解释 VS Code、GitHub Copilot 的新增或变更功能。不适用于参考文档、发布说明或 API 文档。\n\n主要模式:写作模式分两阶段,先研究主题并提出大纲,经批准后才起草文章。审阅模式评估既有草稿在清晰度、简洁性和风格上的表现,给出具体建议,除非用户要求否则不编辑文件。\n\n写作阶段一(研究并提大纲,不修改文件):理解主题,阅读功能描述、issue 或 PR;框定内容,确定主要受众、读者意图和叙事目的;必要时通过 gh CLI 查看 microsoft/vscode 或 microsoft/vscode-copilot-chat 源码仓库;确定发布文件夹 blogs/<年>/<月>/<日>/ 与下一个可用的 Order 值,确认作者与社交媒体链接;呈现大纲后停止,等待批准。\n\n写作阶段二(批准后起草):创建 blogs/<年>/<月>/<日>/<slug>.md,含完整 YAML frontmatter(Order、TOCTitle、PageTitle、MetaDescription、MetaSocialImage、Date、Author)。正文包含 H1 标题、署名行、简短引言、按大纲的 H2 小节,使用主动语态、第一人称复数、缩略形式,图片用相对路径与描述性 alt 文本,文档链接用绝对 URL,结尾行动号召以 Happy coding! 💙 结束。图片和截图由人工完成,需插入 TODO 注释,不得虚构图片引用。\n\n审阅模式:检查内容框定、frontmatter 完整性与正确性(Order 唯一、MetaDescription 少于 160 字符、TOCTitle 少于 30 字符)、文件夹结构、内容结构、写作风格,并在可行时用 gh CLI 核对技术声明(设置名、命令 ID、版本可用性),按主题分组报告建议,不修改文件。\n\n限制:仅限 blogs/ 文件夹,不更新参考文档、发布说明或 API 文档;需遵守博客写作风格指南及文档写作风格指南;所有 GitHub 交互使用 gh CLI。其他事实暂未提供。