写过技术博客的程序员都知道，最难的往往不是敲代码，而是如何把复杂的底层逻辑讲得深入浅出，还要不仅限于“贴代码”。今天要安利的这个神仙 Skill —— write-tbp (Technical Blog Post)，绝对是技术写作领域的“降维打击”工具！它不仅能帮你搭建文章骨架，更能像一个资深技术主编一样，深入挖掘代码背后的设计哲学。
核心功能
write-tbp 不仅仅是一个写作模板，它是一套完整的“调研-构思-写作-通过”的工作流。它的核心能力包括：
- 智能工作区构建：自动在你的项目中创建标准化的写作环境，将调研笔记（research.md）与文章初稿（draft.md）有序分离，彻底告别乱糟糟的笔记文件。
- 深度代码调研：内置 Explore 子智能体，能够深入 codebase 的角角落落。它会扫描 implementation files、类型定义、测试用例甚至代码注释，替你把“这个功能是怎么跑起来的”摸得清清楚楚。
- 痛点与亮点挖掘：它拒绝流水账。在动笔前，它会强制思考：这个问题解决了什么痛点？有什么反直觉的设计？核心 Insight 是什么？没有“aha moment”的文章，它根本不写。
- 自我审查机制：写完初稿后，它会根据内置的高标准 Checklist 进行自我评估。开篇是否吸引人？代码示例是否恰当？语气是否亲切？不合格就自动重写，直到满意为止。
适用平台
这款 Skill 简直是为新一代 AI 编程编辑器量身定制的“最强外挂”，完美适配以下平台：
- Cursor（强烈推荐，结合 Composer 功能简直起飞）
- Claude Code
- GitHub Copilot
- OpenAI Codex
当你在这些 IDE 中使用 write-tbp 时，它能直接读取当前项目的上下文，比普通的 ChatGLM 或 GPT-4 网页版更懂你的代码逻辑。
实操代码示例
当你运行这个 Skill 时，它会自动梳理出如下清晰的目录结构，让你的写作过程井井有条：
.claude/skills/write-tbp/assets/arrow-routing/├── research.md # AI 自动搜集的代码上下文、测试用例和实现细节└── draft.md # 经过精细打磨的技术博客初稿它在调研阶段执行的指令逻辑非常硬核，专抓核心细节：
Task (subagent_type: Explore)Find all code, documentation, and context related to [TOPIC].Look for:- Implementation files in packages/editor- Type definitions in packages/tlschema- Tests that reveal behavior- Comments explaining why things work the way they do优势分析
相比于直接让 AI “写一篇关于 xxx 的文章”，write-tbp 的优势在于“深度”和“准确性”。
- 拒绝幻觉：因为它先进行基于代码库的 Fact-check（事实核查），确保文章中的技术细节 100% 对应真实代码。
- 逻辑严密：遵循“提出问题 -> 揭示洞察 -> 拆解实现 -> 总结权衡”的黄金写作法则，文章结构堪比大厂技术博客。
- 节省精力：你只需要告诉它“我想写关于 tldraw 箭头路由逻辑的文章”，剩下的调研和初稿它全包了。
应用场景
- 开源项目维护者：快速生成 Feature 发布的深度解析文章，吸引更多贡献者。
- 技术团队 Leader：将团队内部复杂的架构设计转化为通俗易懂的文档，沉淀技术资产。
- 个人技术博主：打破写作瓶颈，通过 AI 辅助调研，快速产出高质量的源码分析文章。
- 开发者布道师：为复杂的 API 或 SDK 编写 Tutorial，通过具体的 Use Case 讲解背后的原理。
最佳实践
为了发挥这个 Agent 的最大威力，建议遵循以下几点：
- Topic 命名规范：使用简短的 kebab-case 命名（如
arrow-routing），方便文件管理。 - 人工 Review 必不可少：虽然 AI 的自查能力很强，但在发布前，建议人工检查一下 Tone（语气）是否符合你的个人风格。
- 善用 research.md：即使你不直接使用生成的 draft，AI 整理好的 research.md 本身就是一份极佳的技术调研文档，不要浪费。
如果你也受够了面对空白文档发呆，或者写出来的技术文章总被吐槽“太干”或“太浅”，那么这个 Skill 绝对能救你于水火。为了让你的 Cursor 或 Copilot 变身顶级技术主笔，建议直接下载并部署这个 Skill。你可以访问 Skill优仓 免费获取 write-tbp 以及更多提升开发效率的优质 Agent 资源，一站式满足你的智能化需求。
免费资源
© 版权声明
文章版权归作者所有，未经允许请勿转载。
THE END
暂无评论内容