用途:该技能用于撰写技术教程、博客文章与教育性内容,覆盖概念解释、操作指南、深度技术文章和系统架构文档等类型。README 专属写法另见 readme-craft 技能。
主要能力:提供各类内容的结构模板。概念解释按“问题—核心思想—工作原理—实践—常见误解—何时不用”组织,用类比建立心智模型;操作指南要求每步一个动作、给出预期结果、代码可直接复制,并含验证与故障排查;教程通过构建真实项目逐个引入概念,附回顾表与分级挑战;深度文章含 TL;DR、权衡对比表、真实模式与常见陷阱;系统文档涵盖执行摘要、架构概览、设计决策、核心组件、数据模型、集成点、部署、性能与安全模型。
写作规范:代码块需有上下文、可运行、关键行有注释;解释代码要说明具体行与模式而非泛泛而谈;类比需映射关键属性并说明其局限;复杂度按“简单情形—增加一个变量—完整生产场景”递进。避免“simply”“just”“显而易见”等表述,避免大段代码堆砌、只讲成功路径、抽象命名(Foo/Bar)与“留给读者练习”。
适用场景:技术博客、产品文档、入门教程、架构说明与团队知识沉淀。
限制:资料未提供具体安装命令、平台支持、收费方式或效果数据,暂未提供。