technical-blog-writing

用途

这是一个面向开发者的技术博客写作技能，目标读者是工程师群体。它把技术写作拆成可复用的结构模板、写作规则和代码示例规范，并通过 inference.sh CLI（belt）提供配套的辅助命令，例如话题调研、生成头图、生成架构图与基准图表。

主要能力

1. 覆盖五类技术文章结构

教程 / How-To：先展示最终成果，列出前置条件，逐步实现，最后给出完整代码仓库链接与后续扩展方向。
深度解析 / Explainer：从概念是什么、为什么重要讲起，先给简化心智模型，再讲详细机制，随后是真实案例、取舍与不适用场景。
故障复盘 / Postmortem：包含事件摘要（发生了什么、影响范围、持续时间）、时间线、根因分析、已实施的修复、防复发措施、经验教训。
基准对比 / Benchmark：说明对比对象与原因、方法论以保证可复现、结果图表、数字解读、带注意事项的推荐、原始数据与复现说明。
架构 / 系统设计：要解决的问题、约束与需求、考虑过的选项、最终架构（含图）、接受的取舍、结果与经验。

2. 开发者写作规则

提供「该做与不该做」对照：直接表达（如"使用连接池"）而非模糊建议；承认取舍；团队决策用"我们"；给具体数字（如"p99 从 800ms 降到 90ms"）而非"显著提升"；引用来源与基准；承认替代方案。同时列出开发者反感的表达，如空话开场、"众所周知"、"只需做 X"、"这很简单"、"显然"、技术内容中的营销语言、把重点埋在段落之后。

3. 代码示例规范

要求每段代码可运行、示例完整、围栏块标注语言、代码后展示输出、变量名贴近真实场景、包含错误处理、固定依赖版本（如"Works with React 18.2"而非只写"React"）。文中给出一个带类型标注、文档字符串与注释的 Python 指数退避示例。

4. 讲解深度与结构模板

根据受众信号决定深度：入门类假定零基础、进阶类跳过基础、对比类假定双方都已熟悉、构建类可跳过基础。要求在开头显式声明假定读者水平。还提供理想的结构骨架（标题、主图、TL;DR、问题、解决、步骤、结果、取舍、结论、延伸阅读）与按类型建议的字数区间（快速技巧 500-800，教程 1500-3000，深度解析 2000-4000，架构 2000-3500，基准 1500-2500）。

5. 图表与视觉

给出不同场景对应的图形：请求流用序列图、系统架构用方框箭头图、决策逻辑用流程图、数据模型用 ER 图、性能对比用柱图/折线图、前后对比用并排图。并提供通过 belt 调用 infsh/html-to-image 生成架构图、调用 infsh/python-executor 生成基准图表的命令行示例。

使用方式

需要 inference.sh CLI（belt），安装命令为 npx skills add belt-sh/cli，随后执行 belt login。

示例命令：

话题调研：belt app run exa/search --input '{"query": "building REST API Node.js best practices 2024 tutorial"}'
生成头图：belt app run infsh/html-to-image --input '{...}'
生成基准图表：belt app run infsh/python-executor --input '{"code": "..."}'
交叉发帖到 X：belt app run x/post-create --input '{"text": "..."}'
查看可用应用：belt app list

分发建议

内容首发自有博客（全文），再以 Markdown 导入方式交叉发布到 Dev.to 与 Hashnode，并回链规范 URL；在 Hacker News 提交链接（项目用 Show HN、故事用 Tell HN）；按版规发布到 Reddit 相关板块；Twitter/X 发摘要线程加链接；LinkedIn 发改编版本加链接。文中提及可配合 twitter-thread-creation 与 linkedin-content 技能。

常见错误

给出错误、问题与修复对照，例如：没有 TL;DR（忙碌开发者会提前离开，需在顶部放 2-3 句摘要）、代码示例失效（破坏可信度，发布前逐一测试）、未固定版本（半年后代码失效，需标注如 Node 20、React 18.2）、使用"只需""简单"等措辞、架构没有配图、营销语气、没有取舍章节、正文前过长铺垫、依赖未固定、缺少延伸阅读。

限制

资料未说明该技能的收费、价格、适用平台限制、生成内容的准确率或效果指标，也未提供官方发布时间与维护状态，这些信息暂未提供。

技能介绍

用途