关于 blog-post
blog-post 是用于撰写长篇编辑文章的技能,涵盖清单文、教程、叙事文和行业观点文章。它引导作者从阅读素材、提炼大纲到 SEO 优化和质量检查,并区分编辑文章、营销文案与技术文档。
主要功能
- 01选择文章形式与切入角度
- 02阅读素材并提炼见解
- 03提供四类文章模板
- 04提供页面 SEO 指引
- 05质量检查清单与报告
适用场景
- 01根据研究素材撰写编辑文章
- 02起草教程或操作指南文章
- 03优化文章的搜索表现与可读性
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ mblode/ agent-skills --skill blog-post安装后在 Claude Code 中输入/blog-post确认已加载。
附带文件references/format-templates.md
详细介绍
博客文章
- 适用: 适合从头到尾阅读的长篇编辑类文章:清单式文章、编辑类教程、操作指南、叙事散文、思想领导力文章。
- 不适用: 简短的营销或产品文案(使用
copywriting)、幻灯片(使用presentation-creator),或技术文档教程、操作文档、参考文档和 API 页面(使用docs-writing)。
工作流
Blog post progress:
- [ ] Step 1: Lock format and angle
- [ ] Step 2: Read every source completely
- [ ] Step 3: Extract insights and outline
- [ ] Step 4: Draft from the matching template
- [ ] Step 5: On-page SEO and polish
- [ ] Step 6: Run the quality gate
第 1 步:确定格式和切入角度
先选定格式;它决定第 4 步使用的模板。如果存在歧义,先问一个问题。
| 格式 | 最适合 | 主线 |
|---|---|---|
| 清单式文章 | 从资料中提炼出意外的启示 | 编号列出见解,并逐一分析 |
| 教程 / 操作指南 | 教授一个流程 | 问题、步骤、结果 |
| 叙事 | 个人经历或历程 | 场景、冲突、解决 |
| 思想领导力 | 行业观点或评论 | 论点、证据、影响 |
用一句话确定切入角度:读者读完后会对什么产生不同看法,或采取什么不同做法?没有这一点,文章就只是在总结,这是最常见的失败模式。
第 2 步:完整阅读所有资料
开始列提纲前,从头到尾读完每个文件、URL 或粘贴的文本;略读会错过被埋藏的要点。接受杂乱的输入(零散笔记、项目符号堆砌、尚未成形的观察):输入可以杂乱,输出必须有条理。
没有资料,只有一个主题?先做研究,再整理出研究资料包,然后列提纲:
| 来源 | URL/路径 | 发布/更新日期 | 可信度理由 | 使用的论点 | 冲突/注意事项 | 是否对时效敏感? |
|---|
第 3 步:提炼见解并列出提纲
- 挑出最出人意料、最反直觉或影响最大的要点;按对读者的价值排序,并以最有力的内容开篇。
- 标出 2 到 4 条值得用块引用呈现的话(只选最有力的);其余内容改述或舍弃,否则文章读起来就像是在剪辑别人的话。
- 找出能引出开篇的好奇缺口或具体问题。
- 看看是否有值得追踪的叙事线索:从一种理解转变为另一种理解。
起草前,为每个章节写一句目的说明;删掉唯一目的只是“提供更多细节”的章节。
第 4 步:使用匹配的模板起草
加载 references/format-templates.md:填充通用骨架,并根据对应格式填写正文部分标签、额外章节和结尾。然后完成全文写作。
第 5 步:优化页面 SEO 并润色
- 标题: 少于 60 个字符,关键词尽量靠前,采用句首字母大写格式,末尾不加句号。
- 元描述: 150 到 160 个字符,应吸引读者点击,而不是枯燥地概括内容。
- 关键词: 出现在标题和第一段中,并在正文中出现 2 到 4 次。超过这个次数会显得像垃圾内容,还可能招致搜索惩罚;因此应自然安排,适可而止。
- 标题: 使用描述性 H2/H3,确保单独放在目录中也能表达清楚。
- 内部链接: 如果用户有相关内容,可建议 2 到 3 个;绝不编造 URL,否则上线后会成为失效链接。
第 6 步:执行质量检查
逐项检查此列表,然后填写下方的质量报告表;表格负责数值检查(标题、元描述、引用数量、来源、链接、事实)。在宣布完成前,修正所有不合格项。
- [ ] Hook lands in the first 1-2 sentences
- [ ] Headline is specific and the body delivers on its promise
- [ ] No paragraph runs past 4 sentences, and lengths vary (uniform blocks read as generated)
- [ ] Each section adds analysis or insight, not just restated source
- [ ] Conclusion looks forward (question, CTA, or provocation), not a recap
- [ ] Voice is conversational throughout, no academic register
- [ ] Markdown renders: headings nest, blockquotes/bold/code are well-formed
结尾附上简洁的质量报告:
## Quality Report
| Check | Result | Fix applied |
|---|---|---|
| Title length under 60 | pass/fail | |
| Meta description 150-160 | pass/fail | |
| Source count and credibility | pass/fail | |
| Quote count 2-4 | pass/fail | |
| Internal links invented? | pass/fail | |
| Current-sensitive facts checked | pass/fail/NA | |
博客文章专属语气
这些要求与 Claude 的默认风格(中立、措辞谨慎、总结式行文)相反:
- 像写给一位聪明的朋友,而不是写给一个委员会;真实胜过权威。
- 在信息密集的段落中,将承载核心意思的短语加粗;读者往往会先略读,再决定是否细读。
- 展示,而非空谈:一个包含真实姓名和数字的具体例子,胜过三个含糊的论断。
- 坦承真正的不确定之处,不要虚张声势;读者会信任你坦诚的地方。
标题模式
任选一种:数字 + 见解(“[来源] 揭示的 [主题] 七大启示”)、出人意料的矛盾(“为什么 [常见看法] 对 [主题] 的理解有误”)、操作指南式(“如何在不受 [常见障碍] 影响的情况下实现 [目标]”),或引人深思的问题(“如果 [对显而易见之事的重新解读] 呢?”)。
注意事项
- 结尾如果只是重述正文内容,就毫无收获;请以展望、行动号召或发人深省的问题收尾。
- 明明有资料可查,却根据假设起草内容,会导致信心十足地写出错误论断;请先在步骤 2 中读完所有资料。
- 如果正文无法兑现标题党式的承诺,就会损害信任并提高跳出率;承诺的内容必须是草稿实际能做到的。
- 逐一总结每份资料,只会写出一份摘要,而不会形成论点;第一步确定的切入角度决定哪些内容该删掉。
技能交接
| 时机 | 运行 |
|---|---|
| 将帖子改编成幻灯片 | presentation-creator |
| 打磨开场、行动号召,或去除 AI 写作痕迹 | copywriting |
| 在基础优化之外,进一步提升页面 SEO | optimise-seo |
docs-writing 不适用于已完成的帖子:它将编辑类文章排除在范围之外,而且它的句首大小写、需求语言和 UI 元素加粗规则,都与上述博客风格相冲突。如果只需逐句提升清晰度,请只加载它的 clarity-* 规则和 voice-no-jargon,不要加载该规则集中的其他内容。