Gemini需严格按提示词处理代码：只解析指定代码块，跳过调试语句与日志，保留原始变量名及术语解释，TODO单独汇总，按入口函数→直接调用链→函数签名与类型三步结构化输出。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让gemini把一段旧代码自动整理成清晰、可读、带上下文的说明文档，但直接丢代码过去往往生成空泛或错漏百出的内容——因为模型不知道你关心什么函数、忽略哪些调试日志、是否要保留原始注释风格、要不要画流程图文字描述。限定输入范围与格式
在提示词开头明确声明：只处理你提供的代码块，不联网、不猜测缺失文件、不补全未给出的类定义。如果代码中引用了外部模块（如utils.py），必须写明“该文件未提供，不作解释”。【否则Gemini会虚构函数逻辑，导致文档完全失真】
要求代码以```python或```java等语言标识符包裹，禁止粘贴无格式纯文本代码段。
跳过调试语句与日志
跳过所有以# DEBUG、// TEMP、/* test_only */开头的行，无论是否在函数体内。
忽略所有print()、console.log()、logger.debug()调用语句，不解释其意图，不归入“功能说明”。
保留关键细节的三种方法
方法一：术语首次出现需括号直白解释
例如“使用Redis缓存（一种基于内存的键值存储数据库）”，而不是直接写“Redis”就跳过。
方法二：禁用模糊表述，保留英文变量名
不允许写“用户ID参数”，必须写“user_id（int类型，来自JWT payload中的sub字段）”。变量名、字段名、状态码、HTTP方法全部原样保留，不翻译、不改写。
方法三：TODO单独汇总
若代码含TODO/FIXME注释，单独汇总为“待办事项”小节，原样保留文字，不翻译、不润色、不补充解决方案。
强制结构化输出
第一步：识别主入口函数（找含if __name__ == "__main__":或main()调用的函数）
第二步：从该函数出发，逐层列出被直接调用的函数（不展开间接调用）
第三步：对每个列出的函数，仅说明“作用+输入类型+返回类型”，不写实现细节
这一步操作起来很简单，直接把函数签名和docstring里的核心信息抽出来就行，但必须严格对照源码，不能合并多个函数、不能省略可选参数默认值。
