技术博客写作

解决什么痛点

写技术文章时常见的问题是结构松散、语气生硬。很多教程读起来像产品说明书，满篇套话，读者看两段就关掉了。这个技能强制遵守一套严密的工程化写作规则，用来破除平淡开场和模糊词汇，把干货硬核地组织起来。

核心工作流

这个技能的核心在于结构化输出与双端渲染。它的工作流分三步走：

• 约束写作逻辑：撰写初稿时，要求每个段落不超过 5 句话。首次出现的专业术语必须解释清楚，不能假定读者都懂。
• 规范排版格式：摒弃死板连接词，把文章用 Markdown 语义组织，核心结论强制用 粗体 强调，代码示例必须完整且可运行。
• 渲染最终产物：技能会将完整博客手动转为标准 HTML5 代码，并写入文件（如 agent-skill.html），而不是把纯文本甩在对话里。

适用边界

由于规则严苛，它更适合构建深度的技术教程、原理解析或实战复盘，而不是写短平快的资讯快讯。如果你的目标读者是刚入门的新手，写作前需要先评估对方对底层逻辑的了解程度，确保首次术语解释足够通俗。