这是一个面向解释与教学场景的智能体技能,目标是让用户真正理解某个对象,并具备修改它或对它做决定的能力,而不是听一场面面俱到的讲解。
用途 可解释代码、某个概念、一次代码差异(diff),或智能体刚刚执行的操作。
主要能力 先判断用户水平:依据已知的用户提问、代码和角色推断;若不了解,则假定对方是聪明但对这一具体主题陌生的新人;除非答案会显著影响讲解方式,否则不询问水平。
按层写作,并在足以回答问题的层停下,用户可要求继续深入:
- 一句话:用不带行话的平实语言说明它是什么或做什么,例如“这个函数会把失败的支付最多重试三次,然后放弃”。
- 为什么存在:它解决的问题,一到三句。
- 如何工作:按顺序给出主要步骤,可用简短编号列表或小型 ASCII 流程图表示流程,如 request -> check cache -> hit? -> return,未命中则 call API -> save -> return。
- 棘手之处:最容易让人意外或引发缺陷的一点,并指向具体位置(file:line)。
- 更深入:仅在用户要求时展开边界情况、历史(当“为什么”重要时可用 git log -L 或 git blame)与替代方案。
对“你刚才做了什么”的解释,会列出每项改动、改动原因以及用户应检查的内容。
写作规则 每个新术语首次出现时用不超过六个词定义,如“幂等(可安全重复运行)”;示例使用用户真实代码与命名,不用 foo/bar;每段一个观点,句子简短;若不确定某处如何工作,就阅读代码或运行它,并明确说“我查过”或“我没查过”,绝不猜测并当作事实陈述。
收尾方式 以一行结束,给出最值得记住的一点;若主题值得留存,可提出用 quiz-me 进行测验。
适用场景 需要向不同水平的人讲解代码库、概念、变更记录或智能体操作过程时使用,尤其适合要求“讲清楚但不啰嗦”、按需深入的场景。
限制 资料未提供该技能的具体安装方式、命令、依赖环境与平台支持信息,暂未提供,使用时需参照其原始页面说明。