GKTJ 患者调研报告生成器

概述

本技能用于生成面向患者的问卷分析报告，具有固定结构、受控措辞，并输出 .docx 格式文件。当前代码仓库正处于迁移阶段：从轻量级的直接渲染模式，转向基于模板的患者报告工作流，后者采用固定的 .docx 模板及 Word 原生可编辑图表。

适用场景

• 上传的附件中包含患者问卷数据，尤其是 .xlsx、.csv 文件，或已复制粘贴的调查表格。
• 输出必须严格遵循以以下四部分为核心的固定患者报告结构： 引言 / 数据信息分析 / 反馈意见分析 / 附件。
• 第 2 章（即“数据信息分析”）中的每个问题均需配有一张对应图表。
• 整份报告须始终站在患者视角展开叙述。
• 用户需要生成 .md 和 .docx 两类交付物，而不仅限于聊天窗口中的文本输出。

请勿将本技能用于医生报告、临床试验手稿或非结构化头脑风暴场景。

工作流

1. 标准化输入：
   • 必需字段：品种、地区、问卷附件。
   • 可选字段：时间、自定义执行说明、自定义输出目录。
2. 优先解析问卷数据：
   • 针对电子表格类输入，使用 scripts/parse_questionnaire.py 进行解析。
   • 在撰写报告章节前，须先将结构化结果保存为 questionnaire.json。
3. 为每个问题生成一条陈述式标题：
   • 此类标题将作为第 2 章各维度的小节标题。
4. 按如下顺序生成报告正文内容：
   • 引言
   • 2、数据信息分析 —— 逐题展开
   • 3.1 积极反馈
   • 3.2 待改进反馈
   • 4、附件-问卷题目内容
   • 撰写叙述性段落时，应参考 references/expression-modules.md 中的患者表达模块。
5. 通过脚本构建报告载荷 JSON，禁止手工编写：
   • AI 应首先输出 report_content.md 或 report_content.jsonl 初稿。
   • 再调用 scripts/build_payload.py，将该初稿与 questionnaire.json 合并，生成符合规范的 report_payload.json。
6. 渲染交付物：
   • 遗留路径：使用 scripts/render_report.py 生成图表、Markdown、.docx 及汇总 JSON。
   • 目标路径：填充固定格式的 .docx 模板，并更新模板内嵌的 Word 原生可编辑图表。
   • 模板驱动规则详见 references/template-spec.md。
7. 交付前校验：
   • 图表数量必须等于第 2 章的问题总数。
   • 附件内容须完整保留原始问题及选项语义。
   • 严禁出现任何关于绝对疗效或安全性的断言。

强制输出规则

• 仅限患者视角。不得改写为医生判断口吻。
• 不得虚构样本量、医院、机构或日期等信息。
• 若样本量或时间信息缺失，应采用审慎措辞，省略无依据的事实陈述。
• 在第 2 章中，应分析百分比之间的关系，而非机械罗列 A/B/C/D 选项后即止步。
• 在第 2 章中，每个问题应优先选用以下三种分析角度之一：
  • 分析各选项占比，给出结论并提出可行建议
  • 逐一分析主要选项的占比，并解释其可能成因
  • 分析整体百分比结构，归纳群体层面的行为模式
• 模型可在各问题间随机选用上述任一角度，但所选角度必须与实际数据分布相匹配。
• 在第 2 章中，须始终先判定行为模式，再依次展开写作：
  • 整体认知情况
  • 条件性认知表现
  • 行为分化特征
  • 关注痛点分布
• 须将百分比结构转化为以下患者维度表述： 患者体验、自我管理行为、便利性、理解程度、支持需求。
• 不得将患者问卷反馈转述为疗效证据或临床推荐依据。

章节规则

• 生成正文前，请通读 references/section-rules.md。
• 定稿前，请通读 references/compliance-rules.md。
• 构建报告载荷前，请通读 references/execution-rules.md。
• 撰写叙述性段落前，请通读 references/expression-modules.md。

脚本说明

• scripts/parse_questionnaire.py
  • 读取问卷电子表格，输出标准化 JSON 结构。
• scripts/build_payload.py
  • 读取 questionnaire.json 及结构化报告内容，输出经校验的 report_payload.json。
• scripts/render_report.py
  • 原轻量级流程的遗留渲染器。
  • 生成 Markdown、PNG 图表、.docx 及汇总 JSON。
  • 该路径无法长期满足客户对模板一致性（customer-template parity）的要求。
• scripts/render_from_template.py
  • 加载固定格式的患者端 .docx 模板，并将结构化载荷 v2 文本写入模板对应位置。
• scripts/update_word_charts.py
  • 更新已渲染 .docx 文件中预置的 Word 原生可编辑图表。

预期文件流转路径

• 输入：
  • 问卷电子表格附件
• 中间产物：
  • questionnaire.json
  • report_content.md 或 report_content.jsonl
  • report_payload.json 或 report_payload.v2.json
• 输出：
  • report_draft.md
  • report_final.md
  • charts/chart_XX.png（仅限遗留流程）
  • report_rendered.docx（仅限模板驱动流程）
  • 问卷调研分析报告-{{品种}}-患者端-{{地区}}.docx
  • report_summary.json

常见错误

• 以医生视角撰写内容。
• 第 3 章（反馈意见分析）与第 2 章（数据信息分析）逐条重复。
• 要求模型手动编写含大量中文段落的长篇 report_payload.json。
• 将患者反馈表述为“证明疗效”或“安全性确证”。
• 遗漏“第 2 章每道题仅配一张图表”的硬性要求。
• 当用户明确要求模板驱动流程时，仍沿用遗留的直接渲染路径。

最终交付

请以如下形式回复：

• Markdown 最终文件路径
• DOCX 文件路径
• 章节完整性检查结果
• 图表数量核对结果
• 图表风格一致性检查结果
• 缺失或存疑数据说明
• 未解决事项清单