研究性学习全流程自动填写
给定课题主题，自动完成从信息采集、深度研究到全套表格填写的完整流程。
核心原则
事实信息必须向用户确认
以下信息属于事实性数据，禁止自行编造或使用占位符，必须通过询问用户获取：
- 小组成员姓名、人数
- 组长
- 班级（年级 + 班号）
- 指导教师姓名
- 研究起止时间（如有）
- 学校名称（如与模板不同）
- 其他用户指定的个性化内容
以下信息可以通过研究和推理生成，但仍建议向用户确认方向：
- 研究背景与意义
- 研究方法和步骤
- 小组分工方案（需基于成员人数和课题特点）
- 活动日志的时间安排
- 预期成果形式
高中水平约束
- 研究深度和表达方式须符合高中生认知水平和写作能力
- 避免过于专业的学术术语和超出高中知识范围的推演
- 数据分析应使用基础统计方法（百分比、平均值、频次分析等）
- 研究方法选择应结合高中实际可操作的条件（如问卷发放范围、实验器材限制等）
- 结论和建议应体现高中生的思考深度，但不应超出合理预期
工作流概览
用户给定课题主题
↓
第 0 步：信息采集（向用户询问必要的 factual 信息）
↓
第 1 步：深度研究（使用 deep_research 技能的工作流）
↓
第 1.5 步：质量检查（通过 deep_research 的 final-gate）
↓
第 2 步：研究团队角色设定（基于第 0 步的真实成员信息）
↓
第 3 步：逐表填写（按模板要求生成每份文档）
↓
第 4 步：上传云文档（上传到"研究性学习资料"文件夹）
↓
第 5 步：交付
第 0 步：信息采集（必须执行）
在收到课题名称后，暂停执行研究，先向用户采集以下信息。可根据已有上下文省略已知的项。
必问信息
| 信息项 | 说明 |
|---|---|
| 小组成员姓名 | 全部成员的真实姓名 |
| 组长 | 谁是组长 |
| 班级 | 年级和班级 |
| 指导教师姓名 | 指导老师的真实姓名 |
| 学校名称 | 如非XX中学需说明 |
建议确认的信息
| 信息项 | 说明 | 默认处理 |
|---|---|---|
| 研究周期 | 起止月份 | 若未指定，按一学期（约12周）规划 |
| 课题方向偏好 | 是否有特定的研究角度 | 若未指定，由研究后确定 |
| 成员分工偏好 | 是否有指定的分工意向 | 若未指定，基于课题特点合理分配 |
采集规则
- 一次性提问：将所有需要询问的信息整理成一个清晰的清单，一次性发给用户，避免反复追问
- 尊重用户节奏：如果用户只想先启动研究、后续再提供成员信息，可以先进行研究，但表格填写必须等用户信息到位后才能开始
- 信息不足时不生成表格：如果用户未提供成员姓名等必填信息，只完成深度研究并交付研究结果，等用户提供后再填表
第 1 步：深度研究
收到课题后，先阅读 skills/deep_research/SKILL.md，按其工作流执行深度研究。
研究维度（按课题类型灵活调整）
以下为参考维度，根据课题特点选择适用项、删减不适用的维度、或增加课题特有的维度：
- 背景与意义：为什么研究这个课题？现实或学术价值？（必选）
- 研究现状：已有研究成果、主流观点、发展趋势。对于校园/本地课题侧重本地或校内相关实践；对于学术性课题可扩展为国内外现状
- 核心概念与理论基础：课题涉及的关键术语、理论框架。对于实践调查类课题可简化或省略
- 研究方法：适合该课题的调查研究方法（问卷调查/实验法/文献法/访谈法/观察法等），需考虑高中实际可操作性（必选）
- 具体研究内容：课题要解决的具体问题（必选）
- 预期成果与结论：基于研究可能得出的发现（必选）
研究产出
使用 deep_research 技能提供的模板生成：
- research-plan.md：基于 skills/deep_research/assets/research-plan-template.md 模板
- evidence-ledger.md：基于 skills/deep_research/assets/evidence-ledger-template.md 模板
第 1.5 步：质量检查
研究完成后、填表之前，必须阅读 skills/deep_research/references/final-gate.md 并逐项通过质量门槛检查，确保：
- 所有填入表格的关键结论都有证据支撑
- 精确数字都有来源出处
- 不存在无证据的关键判断
未通过质量检查的结论不得填入表格。
第 2 步：研究团队角色设定
必须使用第 0 步采集到的真实成员信息，不得使用占位名。
基于成员人数和课题特点，合理分配分工。参考 references/table-specs.md 中的角色差异化说明。
第 3 步：逐表填写
按以下顺序填写 6 份必填表格 + 按需生成可选表格。每份表格基于研究结果和模板字段生成。
模板文件
原始模板存放在 assets/templates/ 目录下（因发布平台限制二进制文件，模板内容内嵌于 assets/template_data.py；运行 scripts/restore_templates.py 可一次性还原为原始 .doc/.docx）。生成文档前应先读取对应模板，了解表格结构和字段布局，然后在生成时保持一致的表格格式。
可选表格生成规则
可选表格（实验记录表/数据处理表/考察调查记录表）根据课题涉及的研究方法自动判断是否生成：
- 研究方法包含实验 → 生成实验记录表
- 研究方法涉及数据分析（问卷统计等） → 生成数据处理表
- 研究方法涉及实地考察或社会调查 → 生成考察和调查记录表
- 第 0 步已告知用户将生成可选表格的，以用户意见为准
表格填写依赖关系
深度研究成果 + 用户提供的真实信息
├─→ 1. 立项申请表（课题初期信息）
├─→ 2. 中期检查表（中期进展）
├─→ 3. 结题报告（最终成果）
├─→ 4. 活动研究日志（多次活动记录，生成 3-5 次）
├─→ 5. 成员自我总结（每人一份，基于真实成员数）
├─→ 6. 教师指导记录册（多次指导记录，生成 3-4 次）
├─→ (可选) 实验记录表
├─→ (可选) 数据处理表
└─→ (可选) 考察和调查记录表
各表填写要点
每份表格的具体填写规范见 references/table-specs.md。
核心要求：
- 所有内容必须基于研究证据，不得编造数据
- 成员姓名、班级、教师等必须使用用户提供的真实信息
- 活动日志应体现研究过程的时间线和推进逻辑
- 成员总结应各有侧重，反映不同分工
- 教师指导记录应体现指导的递进性
生成方式
使用 docx 技能生成 .docx 文件。填写前阅读 skills/docx/SKILL.md。
注意：原始模板中 6 份为 .doc 格式、3 份为 .docx 格式，当前环境对 .doc 格式支持有限，生成时从零构造 .docx 文档，参考模板中的字段结构。
第 4 步：上传云文档
所有文档生成后，使用 wps_docs 技能上传到"研究性学习资料"文件夹。
import sys, os
sys.path.insert(0, os.path.join(os.getenv('SKILL_PATH'), 'wps_docs', 'scripts'))
import kdocs
# 动态查找文件夹
folder_id = kdocs.find_folder_by_path("研究性学习资料")
kdocs.upload_file("本地文件路径.docx", folder_id=folder_id)
第 5 步：交付
上传完成后，向用户交付所有文件的云文档链接。链接格式遵循 wps_docs 技能的云文档交付规范：[文件名](link_url)。
云盘删除规则（全局）
需要删除的云盘文件一律用 drive move-file 转移到云盘根目录「待删除」目录（file_id: mFR6YgKmo1M7V9CEE3sAxxYJyULNc54YW），不做任何删除操作，由用户手动清空；重传/替换旧版时同样把旧版移入该目录。
