第一次使用?进入任务体验室,先看输入与输出的完整示例 →

代码评审片段分层讲解器:按学习者水平拆解 diff

把一段真实 PR diff 按学习者水平(新手/进阶/资深)拆成「结论先行 + 类比 + 逐行注释 + 反例 + 练习」的讲解稿,直接可用于团队内分享或结对评审。

讲解教学进阶CRISPE免费AI 质量分 97
AI 生成复制 0 次

填写变量

填好变量后即可复制;未填的会保留 {{变量}} 原样。

已填 0 / 5

尽量包含改动前后对比;若只有最终代码,请注明「无 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讲解
  • 分层教学

同类提示词

输入一条生硬的评审评论(如「这里会 NPE」),输出面向被评审者的教学式反馈:先讲现象、再讲原因、给修复示例、留一道同类练习题,适合作为 reviewer 的沟通模板。

讲解教学入门COSTAR免费
AI 生成站方 · 复制 0 次