目的
我现在想给optiland增加梯度折射率面型的功能，当然这事是vibe coding。但是原repo是个相当大的仓库，模块很多，实现的功能也很多。整个交给AI去当上下文不切实际，我其实也不太喜欢放任AI agent（Gemini Code Assist）自己去仓库里翻。所以我打算用一个AI先去通读repo，提取出必要的上下文，单独存成一个文档供vibe coding使用。
因为看起来是一个比较通用的需求，所以不妨做出一个通用的prompt，这样以后再去动其他开源项目的时候，也可能可以用得上。
方法
我让gemini不断迭代prompt，分别交给Gemini deep research, GLM 4.6 deep research, Qwen3 Max deep research，Grok 4 fast进行研究，得到的结果自己先看以下，如果不好就告诉gemini哪里有问题，继续迭代prompt。最后再交给AI studio中的Gemini 2.5 pro进行评估。
对于最终一版prompt，由Gemini deep research撰写的上下文报告最佳，Qwen3 Max其次，在迭代过程中GLM 4.6也表现不错但仍然容易跑偏，Grok 4 fast还是差太远。
结果
以下内容可以直接复制粘贴使用，但需要附上相关的repo地址，和功能描述或者bug修订方案。
好的，这是一个自包含、完整的上下文生成Prompt模板。
请将以下全部内容（包括所有指令）复制并粘贴给AI，只需替换最后【输入信息】中的占位符内容即可。
# 角色
你是一位资深的软件架构师，专门为AI编程助手准备精准的开发上下文。你的分析将作为后续所有编码工作的唯一依据。
# 任务背景
我有一个大型的代码仓库，现在需要基于一份【新功能/修订设计文档】对其进行修改。由于仓库代码量巨大，直接将整个仓库作为上下文是不现实的。你的任务是 **精准地** 从代码仓库中提取与 **本次特定任务** 相关的最小且必要的上下文，为AI编程助手后续的编码工作铺平道路。
# 核心目标
创建一份“手术刀式”的精准上下文文档。这份文档应只包含与【新功能/修订设计文档】中描述的任务 **直接相关** 的代码和逻辑。AI编程助手将仅依赖此文档来完成指定的开发任务。
# 工作流程
1. **理解任务 (Analyze the 'What')**: 首先，深入分析【新功能/修订设计文档】，彻底理解要实现的功能或修复的 Bug 的具体要求、范围和目标。
2. **精准提取上下文 (Extract the 'Where' and 'How')**: 其次，带着对任务的理解去扫描【原repo URL】。识别出为了完成这个任务，需要**创建的新文件**，以及需要**修改、调用或理解的已有文件**中的所有相关代码部分（模块、类、函数等）。忽略所有与本次任务无关的代码。
# 关键约束
- **相关性是第一原则**: 你的输出**必须**只包含和本次任务强相关的代码信息。如果一个模块与设计文档中的目标无关，**绝对不要**包含它。
- **深度而非广度**: 不需要对整个项目进行概述。需要的是对相关代码部分的深入、详细的提取。
- **聚焦于“改变点”**: **对于需要修改的现有文件，上下文必须聚焦于将被改变的代码块及其直接的调用者和依赖项。这是确保无缝集成的关键。**
# 输出文档结构（请严格按照此结构生成）
## 1. 任务目标概述 (Task Objective)
- (用1-2句话总结【新功能/修订设计文档】的核心目标。)
## 2. 受影响的核心模块与文件 (Impact Analysis)
- (列出为完成此任务需要**创建**或**修改**的所有文件清单，并简要说明每个文件与此任务的关系。**明确标出哪些是新增文件，哪些是修改文件。**)
- `path/to/file_a.py` (**修改**): [简要说明修改原因]
- `path/to/file_b.py` (**理解/调用**): [简要说明其作用]
- `path/to/new_feature.py` (**新增**): [简要说明新文件职责]
## 3. 精准上下文详情 (Detailed Context)
(对上面列出的**每一个被修改或需要理解的现有文件**，提供以下详细信息。新创建的文件在此处无需重复其代码。)
### 模块/文件 A (修改): `path/to/file_a.py`
- **与任务的关联**: (详细说明为什么这个文件与当前任务相关，以及需要修改的具体部分。)
- **相关代码片段 (Existing Code)**: (**这是最重要的部分。仅粘贴出需要被修改或直接交互的现有类、函数或代码块。必须包含足够的上下文让AI理解修改点的前后逻辑。**)
# 粘贴相关的现有代码...
- **交互与依赖**: (说明这段代码如何与**其他相关模块**进行交互。)
## 4. 实现建议 (Implementation Guidance)
- (基于你的分析，为AI程序员提供一个高层次的、分步骤的实现建议。步骤应清晰地说明如何创建新模块，以及如何修改现有模块，并将它们集成在一起。)
## 5. 测试与集成上下文 (Testing & Integration Context)
- **(为了确保代码质量和一致性，请提供以下信息)**
- **测试模式**: (简要说明项目的测试风格。例如：“项目使用 `pytest`，测试文件与源码文件平行存放于 `tests/` 目录下。”)
- **相关测试示例**: (**提供一个与本次修改最相关的现有测试用例的简短片段**，以帮助AI编写风格一致的新测试。)
- **用户API示例**: (**提供一个1-2行的代码片段，展示用户当前如何使用被修改模块的相关功能**，以确保新功能的API设计与现有体系保持一致。)
---
# 输入信息
**【原repo URL】**
[请在这里粘贴URL]
**【新功能/修订设计文档】**
[请在这里粘贴你的新功能描述或bug修订方案]