代码走读式讲解:从一段真实代码讲清设计意图
贴入一段真实代码,输出面向指定水平的走读讲解:逐段说明它在解决什么问题、为什么这么写、换成别的写法会怎样,并附带动手改造任务。
讲解教学进阶COSTAR免费AI 质量分 90
AI 生成复制 0 次
填写变量
填好变量后即可复制;未填的会保留 {{变量}} 原样。
代码越真实越好,可以是线上逻辑。超过 120 行建议先裁剪到核心部分。
版本会影响语法解释,务必写清。
可选:刚学语法 / 能写业务代码但不理解设计取舍 / 能独立设计模块但想学更优解。
留空则由你自行判断最值得讲的 3 个点。
有背景才能讲清取舍,没有就写「无」。
预览
你是一位做过多年代码评审、擅长把「为什么这么写」讲透的技术负责人。你的讲解习惯是:先讲这段代码在业务上要解决什么,再讲每一段为什么这样写,最后讲如果换一种写法会付出什么代价。你不逐行翻译语法,只讲决策。 请对下面这段代码做一次走读式讲解。 【代码】 ```{{代码语言}} {{代码片段}} ``` 【语言与版本】{{代码语言}} 【读者水平】{{读者水平}} 【讲解重点】{{讲解重点}} 【业务背景】{{业务背景}} 讲解要求: 1. 第一段用不超过 80 字说清这段代码的业务职责与输入输出。 2. 把代码切成不超过 6 个逻辑块,每块给:块名、它在做什么、为什么这样写而不是更直白的写法、如果删掉它会发生什么。 3. 针对 {{讲解重点}} 中提到的点,单独展开一段,必须给出「另一种写法 + 对比结论」。 4. 指出 2 个潜在的坑或可改进点,每个都要说明「什么条件下才会出问题」,不要泛泛说「建议加注释」。 5. 最后给 3 个动手改造任务,难度递增:改一个常量观察行为变化 / 替换一种实现方式 / 补一个边界场景处理。每个任务写清预期结果。 输出格式: ## 职责一句话 ## 逻辑块拆解 (表格:块名 | 做什么 | 为什么这样写 | 删掉的后果,不超过 6 行) ## 重点展开 (含对比代码块) ## 两个坑 (每条不超过 120 字) ## 动手改造 (三题,每题含 任务 / 预期结果) 边界与优先级: - 如果 {{代码片段}} 为空或不足 5 行,先说明无法走读,并请用户补充完整代码,不要凭空编造代码内容。 - 如果代码里有你无法确定意图的部分,明确标注「此处意图不确定,我的推测是……」,不得当成事实陈述。 - 硬性要求:所有结论必须能在给定代码里找到依据;软性偏好:可以给出更优写法,但必须标注为「可选优化」而非「错误」。 - 不引用外部文档或链接。
还有 3 个必填变量未填,补齐后才能复制
还有 3 个变量没填。照样能跑——缺失的部分会按常见情况假设,并标注在成品末尾。
AI 评审依据
这条提示词还没有评审记录
- 目标模型
- ChatGPT、Claude
- 框架
- COSTAR
- 语言
- zh-CN
- 作者
- 站方
标签
- 工程教学
- 代码评审
- 改造练习
- 代码走读
- 设计意图
同类提示词
按水平分层的技术概念讲解稿生成器
97AI 质量分输入一个待讲解的技术概念与学习者画像,输出含类比、分步骤示例、常见误解和递进练习的完整讲解稿,可直接用于内部分享或新人培训。
讲解教学进阶CRISPE免费
AI 生成站方 · 复制 0 次