技术博客写作助手

它解决什么问题

很多技术文章读起来像文档翻译：开头是「随着技术的不断发展」，段落动辄十几行，代码片段缺了 import 根本跑不起来。这类内容工程师不爱看，也很难被搜索引擎和社交平台有效分发。

这个技能把写作规范固化成一套硬约束，从结构、语气到排版一次性收敛：

• 标题必须包含核心关键词，让读者一眼知道能解决什么问题
• 开头用反直觉观点或真实痛点切入，禁止教科书式开场
• 正文单段不超过 5 句话，术语首次出现必须通俗解释
• 代码示例必须完整可运行，包含依赖安装说明
• 结尾给出 3-5 条要点总结和可验证的下一步动作

技能如何工作

技能内置一份强制规则清单，覆盖结构、文风和格式三层。写作时先按结构要求搭骨架，再用口语化语气填充内容：

• 禁用「首先 / 其次 / 最后」「综上所述」「众所周知」这类套话
• 模糊词（「很多」「一些」「非常」）一律替换成具体数字或具体名称
• 全文用 Markdown 组织，代码块标注语言，核心结论用 **粗体** 突出

输出阶段做两件事：

1. 生成单文件 {文章主题关键词}.html，内置 CSS，无需任何外部依赖
2. 调用 present_files 直接把成品推给用户预览

页面按固定规范渲染：正文 17px、行高 1.85，代码块深色底 #1e1e1e，引用左侧蓝色边框，小屏正文缩至 16px。读者看到的第一行就是博客标题。

适用边界与注意点

• 规范为中文写作定制，不直接产出英文长文，英文内容需自行翻译后按同样规则重排
• 结构约束较死，不适合观点专栏、教程连载或叙事型文章
• 自动生成的 HTML 是最终成品，正文前不输出 Markdown 预览
• 配色与字号写死在样式里，想要自定义主题得改 CSS
• 反直觉开头依赖真实数据支撑，编造数字会被读者识破