这个技能帮助项目贡献者为项目网站撰写并发布一篇博客文章。它的质量标准是:读起来像人写的,能在一个尚无其他文章占据的搜索集群中获得排名,并且正确地接入站点、构建通过。
一、用途 该技能用于让每位贡献者以统一的语气写作、选择不重叠的主题、通过同一套反 AI 陈词滥调的门槛。无论贡献者是否已经了解项目内部的写作规则,都可以使用它。它适用于起草、编辑和发布面向项目网站的博客文章,并关注 SEO 流量。
二、核心写作要求
- 使用 ASD-STE100 简化技术英语(STE)撰写文章中的技术性和指导性文字。使用短小、直接的句子,术语一致,动作明确,并在 STE 词典可用时使用技术词汇的批准含义。不使用成语、俚语、比喻性语言,或可能使技术术语含义不清的同义词替换。保留精确的代码、命令、标识符、产品名称和引文。文章可以保留个人观点和具体示例,但清晰度优先于节奏或修饰。在没有核对当前 ASD-STE100 版本和词典的情况下,不得声称严格符合 STE。
- 硬性禁令:任何时候都不得使用破折号(—)或短破折号(–)。应改用句号、逗号,或“so”/“because”/括号。草稿中出现一个破折号即为硬性失败。技能文件夹中提供了扫描脚本,可对草稿运行 bash check.sh <file>。
三、工作流程(按顺序执行)
- 先阅读已有事实来源。在动笔前,阅读已发布的内容以匹配语气并避免关键词自相残杀:阅读站点的文章登记表或索引(列出每篇已发布文章的记录,如登记文件、内容集合、CMS 列表或博客源码目录中的 frontmatter),读取每个 slug、标题、描述和标签集;阅读一两篇完整的已发布文章以吸收语气;阅读 reference/angles.md(如何选择不冲突的角度,以及尚未被使用的主题)、reference/voice.md(内部语气和反 AI 清单,自成一体)、reference/craft.md(写作技巧:吸引点击的开头、骨干结构,以及每个阶段应使用的创意写作技能)、reference/seo.md(页面内关键词放置、内部链接、验证机器可读的 SEO,以及发布后的分发循环以获取首批外链)。
- 选择并提交角度。每篇文章必须占据一个独立的搜索集群,两篇争抢同一关键词的文章会互相蚕食。从文章索引和 reference/angles.md 中选择一个尚无已发布文章占据的角度,然后在起草前用一句话向贡献者提交:工作标题、一句话论点、以及它瞄准的 3 到 5 个关键词短语。写作正文前先确认。如果他们给的主题与现有文章冲突,应说明并提出相邻但不同的角度。
- 搭建大纲。好文章有骨干,而不是清单。写大纲前先阅读 reference/craft.md;开头和 H2 骨干决定了文章能否被读完和排名的 80%。结构包括:一个点出读者具体问题的开头(描述加开场),不要用“AI 智能体正在改变协作”这种空洞表述;4 到 7 个部分,每部分有一个主张,并由来自项目的真实代码、真实命令或真实数字支撑,阅读项目实际源码和文档并准确引用,编造的 API 比没有代码更糟;一个“这不是什么”或诚实局限的部分,语气略带反调并承认哪些被推迟,这种诚实让它不像营销;一个落脚于论点的结尾,不用“总之,未来光明”这种通用收尾,而是以一个读者可以执行或检查的具体事项结束。
- 起草。先在博客源码目录(事实来源)中以纯 markdown 撰写正文。写作时遵循 reference/voice.md、reference/craft.md 和上述 STE 指南。保持诚实、具体、基于真实项目代码。使用一个明确的观点并用证据支撑。如果环境中可用 /direct-response-copy,可对标题、描述和结尾行动号召(仅这三个表面,不包括正文)运行它。
- 人工化(强制)。对草稿进行人工化处理:如果环境中可用 /humanizer,就对草稿调用它;如果不可用,就自行应用 reference/voice.md 中的清单。然后进行 STE 检查:检查句子长度、清晰的主语和动作、一致的技术术语、可用时的批准词义,以及有意的例外。剔除:意义夸大、宣传性形容词、三项并列、以“-ing”结尾的尾部分析、否定平行结构(“不是 X,而是 Y”)、同义词轮换、含糊措辞,以及所有破折号。对于标题/描述/行动号召的润色,也可以引入 /direct-response-copy(如果可用)。然后运行 bash check.sh <draft-file>,修复它标记的问题。
- 接入网站。遵循 reference/wiring.md。简而言之:在博客使用的索引/登记表中注册文章,以博客的格式添加正文,确保 SEO 表面(站点地图、RSS、OG/Twitter 卡片、JSON-LD)包含新文章,添加封面图,并构建。关键词放置(标题/描述/第一个 H2/标签)、内部链接数量和锚文本规则,遵循 reference/seo.md。从最相关的已有文章添加一条反向入站链接。
- 完成前验证。站点的构建命令必须通过。然后对文章做冒烟测试:确认文章页、封面图、博客索引、站点地图和 RSS 订阅都能加载并包含新文章。查看文章源码,确认 meta 描述、OG/Twitter 标签和 BlogPosting JSON-LD 实际输出了正确的值(reference/seo.md 列出了需要检查的内容)。对最终 markdown 重新运行 bash check.sh。只有到这时文章本身才算完成。
- 分发(这是获得关注的关键)。一篇正确但没有入站链接的文章不会获得排名。发布后,播种第一批信号:如果环境中可用 /x-tweet,就针对文章的核心见解运行它,生成一条教学式并链接文章的推文串;从相关文档交叉链接文章;在人们已经提出该问题的地方回答它。参见 reference/seo.md 中的分发循环。始终链接规范的生产 URL(<your-site-url>/blog/<slug>),绝不使用 staging 或预览主机。
四、护栏 不得编造项目 API、标志或数字,应阅读源码并引用。不得为了听起来“专业”而削弱内部语气,具体和略带反调胜过精致和通用。技术性和指导性文字使用 STE,当比喻性语言或装饰性措辞会降低技术清晰度时不要使用。不发布角度与已发布文章重叠的文章,应调整角度。封面可以是 SVG 或光栅图像,匹配站点品牌配色;如果做不出好封面,应复用已有的,而不是发布难看的东西。
五、关于本技能自身文件的说明 扫描脚本会标记 SKILL.md 和 reference/ 文件,因为它们提及被禁字符(—)(–)并使用 → 作为教学记号。这是预期行为。扫描器用于博客草稿和渲染后的文章正文,不用于本技能文档。
六、限制与未提供信息 本技能介绍中未提供收费、定价或平台支持信息。