| name | 02-literature-plan |
| description | 中文项目申请书写作流程第 02 阶段工具：文献查找计划生成。 根据第 01 阶段课题初始理解，或第 05 阶段综合理解报告，维护一个长期文献调研计划，并为下一阶段 academic-search 生成本轮短期精准调研目标。
当用户输入 /grant-master:02-literature-plan，或要求生成文献查找计划、生成第 N 轮调研计划、规划下一轮文献调研、生成 academic-search 任务、安排搜索方向、更新长期调研计划、生成本轮搜索 goal 时，使用本 Skill。
本 Skill 是 01-topic 的下游、03-academic-search 的上游。 它只负责"查什么"和"本轮优先查什么"的规划，不执行搜索、不精读论文、不综合论文结论、不写申请书正文。
|
02-literature-plan：文献查找计划生成
1. 阶段定位
本 Skill 负责中文项目申请书 workflow 的第 02 阶段：文献查找计划生成。
核心职责：
01_topic / 05_synthesis
↓
02_literature_plan
├── 更新长期调研计划 long_plan.yaml（当前最新）
├── 保存本轮快照 round_XX/long_plan.yaml
├── 更新进度归档 research_archive.yaml
└── 生成本轮短期目标 round_XX/round_goal.md + search_queries.yaml
↓
03_academic_search
本 Skill 不执行 academic-search，不下载论文，不精读论文，不形成文献综述结论。
2. 工作目录规则
以 Claude Code 当前工作目录作为项目根目录。不硬编码任何绝对路径。所有路径都相对当前工作目录。
3. 阶段编号
01_topic 课题初始理解 / framing v0
02_literature_plan 文献查找计划生成 ← 本 Skill
03_academic_search 文献查找
04_paper_digest 逐篇论文精读
05_synthesis 综合理解 / 更新当前视角
4. 状态管理边界
./workflow/proposal_state.yaml 只属于 auto 管理。本 Skill 绝不读取、修改或创建该文件。
5. 输入文件规则
5.1 每一轮都必须优先读取已有长期计划
如果存在，必须读取：
./workflow/02_literature_plan/long_plan.yaml
./workflow/02_literature_plan/latest_plan.yaml
如果已有历史轮次，还应读取最近一轮的 round_XX/round_goal.md、round_XX/plan_result.yaml。
目的：继承上一轮计划；避免重复任务；将新任务并入长期计划；选择本轮最应执行的目标。
5.2 第一轮输入
必须读取：
./workflow/01_topic/01_topic_card.md
./workflow/01_topic/01_topic_result.yaml
./workflow/01_topic/01_literature_seed.yaml
可选读取：./topic.md、./requirements.md、./applicant_profile.md、./references/
5.3 第二轮及后续输入
优先读取：
./workflow/05_synthesis/current_view.md
./workflow/05_synthesis/latest_result.yaml
可选读取最新一轮的 03_academic_search 和 04_paper_digest 产物。
后续轮次核心任务：根据上一轮综合理解中仍未解决的问题、新出现的 gap 线索、创新点疑点，更新长期计划，选择下一轮最值得执行的短期搜索 goal。
6. 轮次判断规则
- 如果不存在
./workflow/02_literature_plan/，创建该目录。
- 如果不存在任何
round_XX，创建第一轮 round_01。
- 已有若干轮时，创建下一个编号的轮次目录。
- 用户明确指定轮次时，以用户指定为准。
- 不覆盖已有轮次目录，除非用户明确要求"重写这一轮计划"。
轮次目录命名使用两位数字：round_01、round_02……
7. 长期计划与短期目标的关系
7.1 长期计划覆盖范围
- 背景调研计划（可选）：只在背景不清楚、领域边界不清楚、术语不清楚时才需要。
- 核心目标调研计划（必须）：围绕课题最核心问题、最近邻工作、核心 gap 是否成立。
- 关键技术调研计划（必须）：围绕课题涉及的关键技术分别设计调研任务。
- 迭代新增任务（必须）：每轮 05_synthesis 后可能产生新的问题，进入长期计划。
长期计划每一轮都要更新，不只在第一轮生成。
7.2 短期目标规则
- 背景调研任务可以单独作为一轮。
- 非背景轮次：可以规划 1-3 个互不依赖的并行搜索任务。03-academic-search 支持并行 searcher agents，多条 query 可同时执行。
- 同一轮内的多个任务必须服务于同一个调研阶段目标（如同一轮回答"现有方法不足"的多个子问题），不允许把松散无关的任务塞进同一轮。
- 不允许把长期计划中的所有任务一次性交给 academic-search。
- 本轮 goal 必须能在一轮中执行，并产生可精读的候选论文集合。
8. 背景调研是否跳过
可跳过背景调研的条件（满足任一即可跳过）：
01_topic_card.md 已清楚说明应用场景、核心矛盾、基本技术背景；01_topic_result.yaml 中背景清晰度和文献计划准备度较高；01_literature_seed.yaml 已能明确指向核心技术和最近邻工作；references/ 中已有足够背景材料；- 背景调研只会产生泛泛资料，不能有效推动 gap/idea 判断。
需要背景调研的条件（满足任一则安排）：课题应用场景不清楚；领域术语不清楚；不知道应查哪些会议或关键词；不清楚该课题属于哪个研究社区。
即使安排背景调研，也只能作为单独一轮，不与核心技术调研混在同一轮。
9. 输出文件结构
本 Skill 每轮生成或更新：
./workflow/02_literature_plan/long_plan.yaml # 长期计划（持续更新）
./workflow/02_literature_plan/research_archive.yaml # 已调研内容归档（持续追加）
./workflow/02_literature_plan/round_XX/long_plan.yaml # 本轮快照（写入后不再修改）
./workflow/02_literature_plan/round_XX/round_goal.md # 本轮短期目标
./workflow/02_literature_plan/round_XX/search_queries.yaml
./workflow/02_literature_plan/round_XX/plan_result.yaml
./workflow/02_literature_plan/latest_plan.yaml # 索引文件
各文件职责简述：
long_plan.yaml：全部调研任务的路线图，持续更新，不直接交给 academic-search 执行。research_archive.yaml：已完成/已跳过任务的归档总表，方便随时查看整体调研进度。round_XX/long_plan.yaml：本轮结束时 long_plan 的完整副本，保留各轮计划演变链条，一旦写入不再修改。round_XX/round_goal.md：告诉 academic-search 本轮查什么、为什么查、查到什么程度、不要查什么。round_XX/search_queries.yaml：将 round_goal 转化为机器可读的关键词和查询式。round_XX/plan_result.yaml：供 auto 判断是否可进入第 03 阶段。latest_plan.yaml：索引文件，指向最新轮次和长期计划，不承载调研内容。
10. 输出格式参考
写每个输出文件之前，用 Read 工具读取对应的模板文件：
| 输出文件 | 参考模板 |
|---|
long_plan.yaml | references/long_plan_template.yaml（相对本 Skill 目录） |
research_archive.yaml | references/research_archive_template.yaml |
round_goal.md | references/round_goal_template.md |
search_queries.yaml | references/search_queries_template.yaml |
plan_result.yaml | references/plan_result_template.yaml（含成功/阻塞两种格式） |
latest_plan.yaml | references/latest_plan_template.yaml |
模板文件位置：本 Skill 目录下的 references/（如 skills/02-literature-plan/references/）
按需读取：只在即将写某个文件时读取对应模板，不要一开始把所有模板全部加载。
11. long_plan.yaml 写入规则
- 第一轮若不存在，则创建；后续轮次读取并更新。
- 每轮更新完成后，将
long_plan.yaml 完整复制为 round_XX/long_plan.yaml（快照）。
- 不删除历史任务，除非明确标记为
dropped。
- 每个任务必须有
status 字段。
- 每轮可规划 1-3 个互不依赖的并行任务（03 支持并行 searcher agents）。
- 新增任务写入
iterative_tasks 或对应 plan 区域。
- 被跳过的任务写入
completed_or_skipped_tasks，status 标注 skipped，reason 记录跳过依据。
- 每轮更新后同步更新
research_archive.yaml。
12. research_archive.yaml 写入规则
- 第一轮若不存在，则创建；后续轮次读取并追加，不覆盖历史记录。
completed_tasks 和 skipped_tasks 只增不减。pending_overview 每轮刷新，反映当前待办状态。- 本文件是进度速查文件，不替代
long_plan.yaml。
13. search_queries.yaml 写入规则
round 和路径中的 round_XX 必须与实际轮次一致。- 非背景轮次的
queries 通常 4-12 条（1-3 个并行任务 × 每个任务 3-4 条 query），queries 之间互不依赖以支持并行执行。
- 不把长期计划中的所有任务都写进
queries。
target_total_papers 默认 10-15；背景轮可放宽到 20-30。
14. 选择本轮短期目标的规则
- 优先选择能最大幅度降低当前不确定性的任务；
- 优先选择能确认或否定核心问题成立性的任务；
- 优先选择与
grant-paper-digest 和 grant-synthesis 直接相关的任务；
- 不优先选择泛泛背景资料，除非背景确实不清楚；
- 不选择过宽任务；不选择与上一轮高度重复的任务；
- 后续轮次优先响应
05_synthesis 提出的未解决问题和新增任务；
- 如果多个任务都重要，选依赖关系最靠前的任务；
- 用户明确指定方向时，以用户指定为准，但仍要控制范围。
非背景轮次的本轮目标必须符合：1-3 个互不依赖的并行问题 + 每组问题有 3-4 条检索式 + 可形成 10-15 篇核心精读论文（每任务 3-5 篇）。
15. 跳过标注规则
生成每轮计划时，必须主动检查是否有任务可以跳过。
15.1 可跳过的依据来源
来自输入文件：
01_topic_result.yaml 中 background_clarity: high → 背景调研可跳过；01_topic_card.md 已明确说明核心技术路径 → 相关背景方向可跳过；05_synthesis/current_view.md 明确标注某方向"已有足够证据"；references/ 中已有覆盖该方向的论文；- 上一轮
plan_result.yaml 或 long_plan.yaml 已标注 completed 或 synthesized。
来自用户语句：
- 用户明确说"不需要查 X"或"跳过 X 方向"；
- 用户说"我们已经知道 Y，不用再调研"；
- 用户指定了本轮目标，隐含跳过了其他任务。
15.2 跳过的处理要求
识别到可跳过任务时，必须同时处理五个位置：
long_plan.yaml：将该任务 status 改为 skipped，completed_or_skipped_tasks 中记录 reason；round_goal.md Section 2：列出本轮跳过的任务及理由；research_archive.yaml：skipped_tasks 中追加该任务，填写 skip_source 和 reason；search_queries.yaml：long_plan_context.skipped_task_ids_this_round 中列出跳过的任务 ID；round_XX/long_plan.yaml（快照）：快照自然包含已更新的 skipped 状态。
15.3 跳过注意事项
- 跳过不等于永久放弃。后续若产生新证据，可将
status 改回 pending 并说明原因；
- 不轻易将高优先级核心任务标注为跳过，除非有明确依据；
- 跳过理由必须可追溯，读到
reason 字段的人应能理解为什么跳过。
16. 阻塞规则
16.1 第一轮阻塞
缺少以下任一文件时，生成 blocked 版 plan_result.yaml 并提示运行 /grant-master:01-topic：
workflow/01_topic/01_topic_card.md
workflow/01_topic/01_literature_seed.yaml
16.2 后续轮次阻塞
第二轮及后续缺少 workflow/05_synthesis/current_view.md 时，提示先完成 academic-search → grant-paper-digest → grant-synthesis。
16.3 计划过宽阻塞
本轮任务之间互有依赖（无法并行）或方向过于松散（>3 个不相关方向）时，向用户提出最多 3 个选择问题。
17. 最终响应格式
已生成/更新第 XX 轮文献查找计划：
长期计划（含本轮快照）：
- workflow/02_literature_plan/long_plan.yaml（当前最新）
- workflow/02_literature_plan/round_XX/long_plan.yaml（本轮快照）
调研进度归档：
- workflow/02_literature_plan/research_archive.yaml
本轮短期目标：
- workflow/02_literature_plan/round_XX/round_goal.md
- workflow/02_literature_plan/round_XX/search_queries.yaml
阶段结果：
- workflow/02_literature_plan/round_XX/plan_result.yaml
- workflow/02_literature_plan/latest_plan.yaml
本轮 goal：[一句话]
本轮跳过的任务（如有）：任务 ID：... 原因：...
下一步：使用 academic-search 执行 workflow/02_literature_plan/round_XX/round_goal.md
预期第 03 阶段输出目录：workflow/03_academic_search/round_XX/
阻塞时：说明缺少什么输入，提示下一步操作，不生成计划文件。
18. 质量要求
- 所有正文输出使用中文；查询式可以使用英文；
- 不硬编码绝对路径，默认使用当前工作目录；
- 不读取、修改、创建
./workflow/proposal_state.yaml；
- 每轮更新顶层
long_plan.yaml 后，必须复制快照至 round_XX/long_plan.yaml；
- 生成计划时必须主动检查可跳过任务，有依据时在所有相关文件中标注；
- 非背景轮次可规划 1-3 个互不依赖的并行任务（03 支持并行搜索），但必须服务于同一调研阶段目标；
- 不执行 academic-search，不精读论文，不生成文献综述结论，不生成 gap 或创新点结论，不写申请书正文；
- 写输出文件前，用 Read 工具读取对应参考模板；
- 最终响应中不要执行其他 Skill。
19. 产出物完整性自检
本阶段所有文件写入完成后，执行以下自检：
- 检查以下文件是否存在且非空：
workflow/02_literature_plan/long_plan.yamlworkflow/02_literature_plan/research_archive.yamlworkflow/02_literature_plan/round_XX/round_goal.mdworkflow/02_literature_plan/round_XX/search_queries.yamlworkflow/02_literature_plan/round_XX/long_plan.yamlworkflow/02_literature_plan/round_XX/plan_result.yamlworkflow/02_literature_plan/latest_plan.yaml
- 将验证结果写入
plan_result.yaml 的 integrity 字段：
integrity:
all_outputs_present: true/false
checked_at: "<当前时间>"
missing_outputs: []
warnings: []
- 若
all_outputs_present: false → 不声称阶段完成，在最终响应中说明缺失文件。
