用途:围绕一个连贯的技术主题写出一份可教学的文档,用机制、例子、边界和练习来讲清楚。适合用户在提问中要求解释某技术主题时使用。
主要能力与规则:只覆盖一个连贯主题;主题过宽时给出 2-4 个更窄的主题让用户选择。开头用读者能认出的观察而非定义,先给出承诺再讲细节;分段层面先说要点再解释。先讲机制再引入术语,先给一句通俗心智模型再进入形式化。每节配一个具体例子,先走完例子再给一般规则;使用类比时说明它在哪里失效。指出未解决、混乱或有争议的边界,堵住显而易见的错误结论。用短句和常见词,删掉听起来深刻却不含信息的句子。参考资料、表格、速查表、语法总结放到另一份文档。
结构:标题用主张或问题;开头 2-4 句取自读者经验的观察;随后是承诺,说明读者将理解什么。各节标题为具体主张,节内先一句话要点,再完整走通一个具体例子,仅在有助于说明时才放代码、命令、提示词或图。之后是“统筹起来”的简短场景和“试一试”的十分钟以内练习,最后以兑现开头承诺的一句收尾。
示例:主题“AI 智能体”过宽,可收窄为智能体记忆(类型、机制、各自适用场景)、工具调用(循环机制与工具设计)或错误处理(失败、恢复、避免挂起)。机制写法上,弱例是“这用 RAG 检索相关上下文”;强例是分三步说明先搜文档、再把内容粘进提示词、再据此生成答案,名称即 retrieve、augment、generate 这一顺序。
限制:资料未提供具体安装方式、依赖、平台、收费或价格信息,暂未提供。