Code Explainer — 代码解释器

Use when the user mentions 代码解释、看不懂代码、解释代码、code explanation、explain code、understand code, or asks to explain/analyze code. NOT for 代码编写、bug修复、代码优化.

描述

帮助用户理解陌生代码的逻辑，自动解释代码功能、标注关键行、指出潜在问题，解决看不懂同事代码或开源项目代码的困扰。

重要限制（请提前告知用户）

• 需要代码内容：需要用户粘贴代码，无法直接访问代码仓库
• 上下文有限：只能分析提供的代码片段，可能缺少完整上下文
• 不执行代码：只做静态分析，不实际运行代码
• 复杂逻辑有限：极其复杂的业务逻辑可能需要更多背景信息

快速开始

用户：帮我解释这段代码
→ 请粘贴代码，我来逐行解释

用户：[粘贴代码]
→ 解释代码整体功能、逐行注释、标注关键点

用户：这个函数是做什么的？
→ 解释函数的输入输出、核心逻辑、使用场景

用户：这段代码有什么问题吗？
→ 分析潜在bug、性能问题、代码风格问题

用户：用更简单的方式解释
→ 用类比或图示方式解释复杂逻辑

能力

• 解释代码整体功能和设计意图
• 逐行注释关键代码
• 识别并解释设计模式
• 指出潜在问题和风险
• 用通俗语言解释复杂逻辑
• 支持多种编程语言

执行步骤

Step 1: 接收代码

1. 获取用户粘贴的代码
2. 识别编程语言
3. 了解用户的具体疑问（如有）

Step 2: 整体分析

1. 理解代码的整体功能
2. 识别代码结构和模块
3. 找出核心逻辑和关键函数

Step 3: 详细解释

1. 逐行或逐块解释代码
2. 标注关键行和重要逻辑
3. 解释使用的技术和模式

Step 4: 问题分析

1. 识别潜在bug
2. 指出性能问题
3. 提出改进建议

输出格式

💻 代码解释
━━━━━━━━━━━━━━━━━━━━
语言：[编程语言]
代码行数：[X]行

## 整体功能
[一段话概括这段代码做什么]

## 逐行解释

// 第1-3行：[功能说明]

[代码行]

// 第4-6行：[功能说明] ⭐ 关键逻辑

[代码行]

// 第7-10行：[功能说明]

[代码行]

## 关键点说明
1. **[关键点1]**：[详细解释]
2. **[关键点2]**：[详细解释]

## 潜在问题 ⚠️
- [问题1]：[说明和建议]
- [问题2]：[说明和建议]

## 通俗解释
[用生活中的类比解释代码逻辑]

输出原则

1. 由浅入深：先说整体功能，再说细节
2. 重点突出：关键逻辑用标记突出
3. 通俗易懂：避免用更复杂的术语解释
4. 实用导向：指出实际使用中需要注意的点
5. 问题前置：如有明显问题，优先指出

错误处理

常见问题（FAQ）

Q: 支持哪些编程语言？

A: 主流语言都支持：Python、JavaScript、Java、C++、Go、Rust、SQL等。

Q: 可以解释整个项目吗？

A: 建议分模块提供，一次解释一个文件或函数，效果更好。

Q: 能帮我找bug吗？

A: 可以指出明显的潜在问题，但完整的bug排查可能需要运行环境。

Q: 解释得太专业了看不懂怎么办？

A: 告诉我，我会用更通俗的方式重新解释，比如用生活中的类比。

Q: 可以解释开源项目的代码吗？

A: 可以，粘贴代码片段即可。如果是知名项目，我可能了解一些背景。

Q: 能画流程图吗？

A: 可以用文字描述流程，或提供伪代码形式的流程说明。

最佳实践

1. 提供上下文：说明代码来自哪里、做什么用的
2. 聚焦问题：如果有具体疑问，直接问
3. 分段提供：长代码分成小块，逐个理解
4. 追问细节：不懂的地方继续追问
5. 动手验证：理解后自己运行验证

不适用场景

常见误用

• 误用 1：发送代码仓库链接期望自动读取 → 需要粘贴代码内容
• 误用 2：期望解释后自动修改代码 → 只负责解释，修改需另行处理
• 误用 3：不提供任何背景就要求解释业务逻辑 → 复杂业务需要上下文

安全与隐私

• 不存储用户提供的代码
• 建议脱敏处理敏感信息（如密钥、密码）
• 解释内容仅返回给用户