用途:为开发者撰写或审阅技术内容,包括 API 文档与参考、指南与教程、代码与架构说明、技术博客。核心原则是清晰、简洁、真实,兼顾技术深度与可读性。
主要能力:提出三大支柱——清晰(短句、短段落、主动语态、一段一概念、首次出现即定义术语)、简洁(删除铺垫、模糊限定词与营销词,用直接动词)、一致(术语、格式、语气统一)。列出应避免的 AI 写作特征:delve into、leverage、robust、seamless、at its core、cutting-edge 等词;Let me explain、It's important to note 等开场;basically、generally speaking 等模糊语;Moreover、Furthermore 等正式过渡词。
使用方式:写作时先给基础说明与最小可用示例,再展开进阶与边界情况,最后给完整参考(渐进披露)。代码示例只给一个完整可运行、含错误处理的例子,注释解释原因而非复述代码。设计决策、非显而易见模式、偏离惯例之处需说明原因。
格式约定:代码注释以句号结尾;标题用句首大写;错误消息用小写句子片段。发布前按清单自查:无 AI 词、无铺垫、无模糊语、无营销词,句长与段长有变化,自然使用缩写,主动语态,示例含错误处理,术语首次定义,细节具体,朗读自然。
适用场景:API 文档、教程、how-to、代码与功能说明、技术文章撰写与审阅。
限制:资料未提供具体安装命令、平台支持、收费方式或与其他工具的集成信息;该技能为写作规范指导,不提供自动化校验工具。