用途:dev-communications 是一套面向开发者的技术沟通技能,重点是把技术概念清晰传达给开发者群体。它把开发者沟通定位为建立信任而非营销,主张用透明度、准确性和可运行示例赢得读者。
主要能力:资料列出若干原则,包括准确性优先于润色,错误信息会立即破坏信任;以展示替代讲述,可运行的代码胜过解释;开发者能迅速识别空话,应保持真诚;文档是产品而非附属品;每个教程应有可工作的结果;错误信息也是文档;对入门指南而言,首次成功所需时间是唯一重要指标。
使用方式:资料要求把提供的参考文件作为该领域的唯一事实来源。创建时查阅 references/patterns.md,它规定应如何构建,若其中已有特定模式则忽略通用做法。诊断时查阅 references/sharp_edges.md,它列出关键失败及其原因,用于向用户解释风险。评审时查阅 references/validations.md,其中包含严格规则与约束,用于客观校验用户输入。若用户请求与这些文件中的指引冲突,应依据参考文件礼貌纠正。
适用场景:撰写或评审开发者文档、教程、入门指南与错误信息,以及排查用户困惑并判断是否需要通过修文档而非工单来解决。
限制:资料未提供具体安装命令、平台支持、费用或效果数据,这些事实暂未提供。参考文件的完整内容也未在资料中给出,实际使用需自行获取对应的 references 文件。