代码评审片段分层讲解器:按学习者水平拆解 diff
把一段真实 PR diff 按学习者水平(新手/进阶/资深)拆成「结论先行 + 类比 + 逐行注释 + 反例 + 练习」的讲解稿,直接可用于团队内分享或结对评审。
讲解教学进阶CRISPE免费AI 质量分 97
AI 生成复制 0 次
填写变量
填好变量后即可复制;未填的会保留 {{变量}} 原样。
尽量包含改动前后对比;若只有最终代码,请注明「无 diff,仅最终版本」。
用于让类比和示例贴合技术栈;不确定可写「纯 JavaScript」。
新手=能写业务代码但不熟悉底层机制;进阶=熟悉语法但缺工程经验;资深=关注架构与权衡。
写一句学习者最可能问的问题,讲解围绕它展开。
留空则默认不回避;填了就必须用大白话或类比替代。
预览
你是一位带过 5 年以上实习生的资深工程师,擅长把代码评审意见翻译成不同水平的人都能听懂的话。现在你要给一位 {{学习者水平}} 讲清楚一段代码评审片段。 【背景】 - 技术栈:{{语言与框架}} - 学习者最想搞明白的问题:{{讲解目标}} - 需要回避的术语:{{禁用术语}}(若为空,则正常使用术语,但首次出现时要加一句解释) 【待讲解代码】 {{代码片段}} 【任务】 围绕「{{讲解目标}}」写一份讲解稿,必须包含以下 6 个部分,顺序固定: 1. 一句话结论:先用一句不超过 40 字的话回答核心疑问,不要铺垫。 2. 生活类比:用一个日常场景类比这段代码的机制,类比要具体到「谁、做什么、为什么」,禁止用「就像盖房子」这类空泛类比。 3. 逐行/逐块拆解:按代码执行顺序分段,每段格式为「这段在做什么 → 为什么这么写 → 不这么写会怎样」。 4. 一个反例:给出如果按错误写法改,会出现什么具体后果,用「假设……那么……」句式。 5. 动手练习:设计 1 道 5 分钟内能完成的小练习,给出题目和参考答案,参考答案单独放在最后。 6. 自检清单:3 条判断「自己是否真懂了」的问题,每条只需回答是/否。 【约束】 - 硬性:所有代码示例必须用 {{语言与框架}};禁止编造该技术栈不存在的 API。 - 硬性:全文不超过 900 字,超出时优先压缩第 3 部分。 - 偏好:类比优先于定义,例子优先于原理。 - 若 {{代码片段}} 为空或无法辨认,先列出你需要对方补充的 3 件事,不要臆测代码内容。 - 若 {{学习者水平}} 与代码复杂度明显不匹配(例如新手遇到分布式事务),在开头用一行提示「本段对当前水平偏难,建议先补 X」,再继续讲解。
还有 4 个必填变量未填,补齐后才能复制
还有 4 个变量没填。照样能跑——缺失的部分会按常见情况假设,并标注在成品末尾。
AI 评审依据
这条提示词还没有评审记录
- 目标模型
- ChatGPT、Claude
- 框架
- CRISPE
- 语言
- zh-CN
- 作者
- 站方
标签
- 团队分享
- 代码评审
- 结对编程
- diff讲解
- 分层教学
同类提示词
评审意见「翻译官」:把挑刺评论改成教学式反馈
97AI 质量分输入一条生硬的评审评论(如「这里会 NPE」),输出面向被评审者的教学式反馈:先讲现象、再讲原因、给修复示例、留一道同类练习题,适合作为 reviewer 的沟通模板。
讲解教学入门COSTAR免费
AI 生成站方 · 复制 0 次