依据真实上下文完成单文件代码交付

## 任务目标 请依据真实工程上下文完成指定文件的开发或修复。交付应可审查、可验证，先明确目标文件承担的责任。 在现有授权范围内完成实际改动和验证；缺少外部条件时先完成可独立实现的部分，不能只停留在计划。 ## 输入信息（选填） 两项均可留空，也可直接用一句话说明目标并附上已有资料。无需自行整理版本、配置或完整需求表；能读取的内容由执行者补齐。 文件目标或缺陷： 代码或工程位置： ## 信息不完整时 先使用本次对话中已经说明的信息；用户留空、写“暂无／不清楚”或未替换输入标记，都按缺失处理，不当作真实路径、参数或业务值。已能从资料确定的内容不重复询问，不编造文件、日志、接口、业务值或执行结果。在用户已授权的范围内读取相关工程和材料，不为补齐输入擅自扩大操作范围。 ### 优先确认 - 定位目标文件、导入导出、直接调用方、对应接口与生命周期。 - 读取锁文件、类型定义、测试和失败日志，核实新增调用真实存在。 ### 可采用的默认处理 - 沿用现有风格、接口与依赖，只修改实现目标必要的文件内容。 - 直接依赖可读取时自行补足上下文；业务值和权限规则没有依据时保持既有语义，不编造兜底。 ### 必须有依据的事项 - 无法确定目标文件或核心行为时，集中确认路径或期望结果，不要求先整理完整架构。 - 正确修复确实必须越出已明确的单文件范围时，先说明最小跨文件范围及原因。 只有缺口会改变业务结果、权限边界或关键实现，且无法从现有资料确认时，才集中提出最多 3 个关键问题；说明影响，并继续完成不依赖答案的部分。一般命名、排版和可逆实现细节按现有约定决定，不逐项等待确认。 ### 资料仍不足时的交付 - 只有完整文本代码时返回可直接替换的目标文件或准确补丁，并列出待执行验证。 - 缺少必要接口时先完成不依赖该接口的部分并准确标出阻塞位置，不能把占位实现称为完成。 ## 执行要求 同时核对设计、任务、既有代码和故障反馈，编码风格以当前工程约定为准。具体实现和验证须以本次工程证据为依据。 1. 阅读目标文件及直接调用关系，确认入口、导出成员、框架生命周期、配置来源和数据流。先列出与本次任务相关的事实；缺少外部接口定义时标明缺口，不依据名称猜测方法签名、返回结构或异常行为。 2. 将需求拆成目标文件内可验证的行为，分别说明正常、空值、边界和异常情况。修复问题时沿用日志中的真实复现条件，不擅自扩大为全模块重构；日志内的路径、数据和命令不视为额外操作授权。 3. 选择满足要求的最小实现，复用已有依赖和公共能力。核实导入路径、成员名称、参数类型、同步异步关系和资源生命周期；业务默认值、权限判断及租户来源必须来自现有契约，不能为了让代码运行而随意补值或绕过校验。 4. 完整实现本次承诺的分支，必要时给出有上下文的错误信息。禁止用无条件成功、吞掉异常、空实现、伪造数据或 TODO 替代要求。若依赖缺口阻断实现，说明阻断位置及最小补充资料，不把不可运行代码称为完成。 5. 检查外部可见行为是否兼容，特别是字段含义、返回类型、异常和状态变化。单文件限制不足以正确修复时，先给出最小的跨文件变更清单及原因；未获得相应范围前不假装仅改此文件便能完成整体目标。 6. 执行与改动相关的已有检查和必要验证，优先验证真正改变的行为。记录命令、环境和结果摘要；测试未运行就明确标记并写出可执行步骤，语法检查通过不能替代业务断言，测试内容非空也不能证明逻辑正确。 ## 交付与验收 输出：简短实现说明；目标路径及代码或补丁；接口兼容性核对表；验证记录；遗留阻断项。能够编辑工程时提供实际变更及审查要点；只有文本输入时提供完整目标文件或可明确应用的最小补丁，二者选一种。验收要求每个新增调用有真实定义、关键需求有实现位置、验证结论有证据；不生成无关说明文件，不把推荐的下一步列成已经完成的交付。 ### 本条完成检查 - 目标行为有具体实现，新增接口调用有定义依据，没有TODO代替关键分支。 - 给出真实变更和必要验证记录；兼容性与未完成边界清楚。 按本条要求组织结果，使用简洁中文和一致的编号、术语、缩进及空行；已有项目格式优先。只说明实际完成的内容，将采用的假设、未完成项和缺少的条件写在相关位置，不额外生成无关文档。未执行、无法复现或缺少证据的检查如实标注，不宣称已通过或已有性能收益。 ## 参考资料与适用边界 整理说明：上下文组织方式参考下方公开实现。 官方来源：https://github.com/FoundationAgents/MetaGPT/blob/11cdf466d042aece04fc6cfd13b28e1a70341b1f/metagpt/actions/write_code.py 来源许可说明：MIT（https://github.com/FoundationAgents/MetaGPT/blob/11cdf466d042aece04fc6cfd13b28e1a70341b1f/LICENSE）。本条为中文原创整理，来源内容与本模板补充要求已在正文区分。