生成 jsdoc 格式的注释
请深度思考。
在本次对话内，你将负责帮助我批量修改代码的注释，修改成 jsdoc 格式的注释。
在我提供的文件内，会出现很对不符合 jsdoc 格式的注释，你需要将其全部转换成 jsdoc 格式的注释。
其最终目的是为了使用 jsdoc-to-markdown 完成文件扫描与识别。
目录与术语说明
为了便于你找到目录，识别术语，这里专门罗列出来：
- 拆分出来的文件目录：
apps\gitee.jiumengjun.rmmv\sourceCodeFile - 进度报告文件：
apps\gitee.jiumengjun.rmmv\docs\prompts\make-jsdoc-format-annotation\todo.md
可以被修改的文件
你只可以阅读并修改以下我提供的文件地址来读取：
- apps\gitee.jiumengjun.rmmv\main.js
- apps\gitee.jiumengjun.rmmv\rpg_core.js
- apps\gitee.jiumengjun.rmmv\rpg_managers.js
- apps\gitee.jiumengjun.rmmv\rpg_objects.js
- apps\gitee.jiumengjun.rmmv\rpg_scenes.js
- apps\gitee.jiumengjun.rmmv\rpg_sprites.js
- apps\gitee.jiumengjun.rmmv\rpg_windows.js
这些文件都是目标文件，被处理的文件。
调度 gemini cli 时的注意事项
调度任务时的基本步骤
claude code 调度 gemini cli 时，基本遵循以下方式来完成：
- claude code 要负责的是任务调度，验收结果，而不是亲自去做简单的任务。
- 先编撰合适的提示词，提示 gemini cli 去修改那个文件，拆分那些代码，并删除那些代码片段。
- 请你使用
gemini -p "你的提示词"的形式，来调用 gemini 完成读取、拆分、删除代码段的任务，或者是其他小的任务。
可委托给 gemini cli 的任务
gemini cli 适合 token 量巨大，简单的任务。如果你在分析拆解任务时，注意到以下任务满足以下类别时，请委托给 gemini 来完成：
- 代码拆分
- 删除代码片段
- 新建文件
- 增加中文注释
- 调整中文翻译与英文注释的顺序
不要交给 gemini cli 的任务
有些任务涉及到总结，我不希望用 gemini cli 来完成，要用 claude code 本身的能力来完成：
- 新建、更新进度报告文件
调度时的边缘情况
很多小任务将会被委托给 gemini cli 去完成，而不是直接经由 claude code 本身来完成。因为 gemini cli 更适合 token 量更大的读写任务。
- 请不要让 gemini 使用 mcp 工具，单纯的读写文件、拆分代码、删除代码的任务，是不需要借助 gemini cli 配置的任何 mcp 工具的。
- 请不要让 gemini 自己新建任何多余的 Python 脚本来完成任务。我们当前的运行环境下，不提供任何 Python 环境。
- 请不要让 gemini 自己新建任何其他语言的脚本。
- 认真优化传递给 gemini 的提示词，避免出现 gemini 无法修改文件的情况。
- 精简优化 gemini 对 claude code 的反馈输出，让 gemini 的反馈报告精简扼要，避免出现 claude code 阅读 gemini 反馈时出现大量消耗 token 的情况。
- 尽量避免出现过量阅读 gemini 日志导致消耗了太多 claude code 的 token 的情况。我不希望大量的消耗 claude code 的 token。
- 每次 gemini cli 时，允许 gemini 单次运行
15分钟，超时后就暂停。并优化对 gemini cli 的提示词。
大文件的调度与跳过策略
你在分配任务给 gemini cli 时，请先衡量目标文件的复杂度，根据代码长度做任务调度。
- 先粗略的检查目标文件的整体长度。如果目标文件的长度非常大，超过了 1000 行。那么
- 如果是文件拆分任务，那么请继续让 gemini 来完成。
- 否则是其他类型的任务，请你跳过，并在
进度报告文件内标记该文件的情况，未来再用 claude code 来完成处理。
- 先优先让 gemini cli 完成文件长度小的文件处理任务。
- 然后再让 claude code 来处理文件长度长的文件。
记住以下几个调度策略：
- 文件长度超过 1000 行的，不让 gemini cli 处理，标记该文件，并推迟给 claude code 本身来处理。
- 文件长度小于 1000 行的，优先让 gemini cli 处理。gemini cli 处理失败了，再由 claude code 本身来处理。
- 等到 gemini cli 处理完全部能够处理的小文件后，再让 claude code 去查询
进度报告文件，处理被跳过的、被推迟的任务。
进度报告文件的格式
进度报告文件 ，是记录任务进度的文档。记录项应该同时包括以下的三项任务。
- 进度报告文件应该设计成多个分模块的表格。
- 表格第一列，应该是文件名。
- 表格的后三列，分别对应以下三个阶段的任务进度。
- 报告进度表，应该在每一个表格块内，记录进度信息。
- 任务进度用百分比来标记。
- 在整个
进度报告文件最底下，应该包括整体进度的报告。
一阶段任务：代码拆分
模仿其他项目的格式做代码拆分。请你先做代码拆分，再开始根据拆分后的代码，做 jsdoc 的格式转换和翻译工作。
- 检查是否存在需要被拆分的文件？检查
拆分出来的文件目录，是否有已经被拆分好的文件？进度报告文件是否已经说明了该阶段已经完成？如果已完成该阶段的代码拆分，那就跳过此部分。否则就继续。 - 请你模仿
apps\rmmv-api\sourceCodeFile目录内的代码拆分方式，将apps\gitee.jiumengjun.rmmv目录内的代码拆分到拆分出来的文件目录内。 - 在你拆分代码时，请你直接地对被处理的目标文件做删除。比如你拆分出来一个模块了，就对应的删除对应的代码。以便逐步地减少目标文件的代码长度，避免你出现单文件 token 超限的情况。
- 这些目标文件预期会被全部拆分完，被拆分完全部模块的代码文件，应该被直接删除。
- 被拆分的文件名称。不应该包含任何数字前缀。比如
02 Utils.js文件命名就是不合适的。应该命名为Utils.js。 - 拆分代码时，请逐个的拆分。识别好一个类后，就新建文件，写入文件，删除对应的代码片段。
- 不要一次性的对一整个很大的 js 文件，同时的，一次性的做代码拆分。
二阶段任务：jsdoc 格式转换
请先完成文件拆分任务后，再开始 jsdoc 的格式转换。
- 首先请扫描
拆分出来的文件目录内全部的 .js 格式代码，这些代码是上一个阶段完成的代码拆分任务的成果。 - 提出 jsdoc 格式转换计划，并执行你的计划。
- 归纳已经有的模块。
- 将全部的模块注释转换进度，写入到
进度报告文件内。这个文件将作为你的进度记录文件，当你每完成一个模块的注释格式转换后，就在此进度文档内记录进度。
三阶段任务：注释翻译与补全
在该阶段，你只可以去读写 拆分出来的文件目录 内已经拆分好的文件，更改这些文件的注释。
- 如果你看到一段注释，有英文，但是没有中文注释时，请补全注释。
- 在格式转换的时候，适当的对没有中文的注释，增加中文注释。实现英文翻译成中文注释。
- 中文翻译在上面，然后才是英文注释。注意严格的注释顺序。先中文、后英文。
- 保留英文注释。
补全注释
有部分函数是没有任何 jsdoc 注释的，请你补全好 jsdoc，并遵循上述的要求来补全 jsdoc。
- 补全中英文注释。
- 严格遵守 先中文、后英文 的规则。
删除无意义的注释
我不希望代码仍旧保留这些无意义的注释。仅仅保留有意义的 jsdoc 注释即可。
其他注意事项
- 在你逐个处理文件的时候，请严格按照进度文件内罗列的文件顺序，逐个的完成文件处理。
- 不需要你处理目标 .js 文件产生的任何 typescript 类型报错。
- 不要处理任何 lint 错误。
- 每完成一个模块的格式转换后，你不需要再停下来，一直继续处理。
- 每完成一个模块后，就去更新进度文件。
贡献者
ruan-cat