ResearchReport_Writing

面向专题调研与参政议政研究的写作技能：根据用户工作方向主动收敛选题，灵活选择研究方法，形成可追溯的论证与建议，按需设计问卷，并生成符合指定方正字体和政务版式的 Word 报告。

同一份核心源码，分别适配 Codex、Claude Code、百度 DuMate。

v1.1.0 更新

• 增加篇幅重心与重复检查，合并冗长背景、重复案例与机制说明，避免前置铺垫挤占问题和建议；不强制固定目录或比例。
• 完整报告默认同步交付独立的《数据与资料来源清单.docx》。正文使用10磅上标来源编号，清单列出对应表述、发布信息与可点击原文链接，内部材料及推算分别记录。

下载与安装

从 最新版本 下载对应 ZIP。安装包内含四种字体、运行脚本、参考指南、示例输入和许可证说明。

客户端	下载包	安装方法	调用
Codex	ResearchReport_Writing-Codex.zip	解压，将 researchreport-writing/ 放到 ~/.agents/skills/ 或项目 .agents/skills/	$researchreport-writing
Claude Code	ResearchReport_Writing-ClaudeCode.zip	在项目根目录解压，得到 .claude/skills/researchreport-writing/；也可个人安装到 ~/.claude/skills/	/researchreport-writing
百度 DuMate	ResearchReport_Writing-DuMate.zip	技能 → 安装技能 → 上传 ZIP 或导入该 ZIP 的下载 URL，再启用	在对话中选择“调研报告写作”

请使用 Release 中的专用包。GitHub 自动生成的源码 ZIP 用于开发，不是 DuMate 的技能导入包。更新前保留自己的修改，避免同名技能重复安装。

能做什么

• 从岗位、研究兴趣、地域和决策对象出发，逐轮收敛选题；已有信息不重复询问。
• 依据实际问题选择分析方法，不机械套用范文目录、标题或固定问题数量。
• 核验政策、统计数据与案例，区分公开事实、用户材料、推断与建议；没有实地材料也能进行公开资料研究。
• 独立设计问卷或在研究需要时补充调查；问卷不是必经环节。
• 编写、修改和排版报告，完成 OOXML 结构校验与逐页视觉检查。
• 检查所需字体，按授权补装当前用户缺失的字体，保留已有版本。

不会虚构访谈、调查回收量、企业案例或来源。普通通知、请示和领导讲话不属于本技能的默认适用范围。

快速开始

向客户端发送：

我是大模型应用开发者，请使用调研报告写作技能，结合我的工作方向帮我选题。

或直接进入写作：

围绕本地区中小企业大模型应用开展调研报告写作。我没有一手数据，请使用公开资料，注明来源；不需要问卷，完成后生成 Word。

运行脚本需要 Python 3.10+。在选定的虚拟环境中安装依赖：

python -m venv .venv

macOS/Linux 使用 . .venv/bin/activate；Windows PowerShell 使用 .venv\Scripts\Activate.ps1。随后执行：

python -m pip install -r requirements.txt
python scripts/check_environment.py
python scripts/install_fonts.py

脚本命令从含 SKILL.md 的技能目录执行；也可使用脚本的完整路径从其他目录调用。若检查显示缺少字体，运行 python scripts/install_fonts.py --install。安装仅面向当前用户，支持 macOS、Windows 10 1809+/11 与 Linux；细节见字体指南。

默认生成报告与独立来源清单（输入格式见来源指南）：

python scripts/build_report_bundle.py examples/report-with-sources.json report.docx sources.docx
python scripts/validate_report_docx.py report.docx
python scripts/validate_report_docx.py sources.docx

示例来源已明确标注为虚构测试记录，不得用于正式报告。正文与来源清单应分别渲染并检查。

仅验证单文档排版：

python scripts/build_report_docx.py examples/report.json demo.docx
python scripts/validate_report_docx.py demo.docx
python scripts/render_report_docx.py demo.docx demo-pages --emit-pdf

示例数据只用于测试格式，不是真实调研结论。渲染需要 LibreOffice 和 Poppler，可用 --libreoffice、--pdftoppm 指定程序路径。DOCX 生成只需要 python-docx。转换成功后仍需查看全部页面，不能用结构校验代替视觉检查。

默认 Word 格式

内容	字体	字号	对齐及缩进	固定行距
大标题	方正小标宋_GBK	二号22磅	居中	31磅
副标题/作者	方正楷体_GBK	三号16磅	居中，之后空一行	28磅
正文	方正仿宋_GBK	三号16磅	两端对齐，首行2字符	28磅
一级标题	方正黑体_GBK，加粗	三号16磅	首行2字符	31磅

默认 A4、四边2.54厘米。用户当次明确要求优先，完整约定见格式合同。

开发、测试与打包

python -m pip install -r requirements-dev.txt
python -m unittest discover -s tests -v
python scripts/package_skill.py dist/ResearchReport_Writing-Codex.zip --target codex
python scripts/package_skill.py dist/ResearchReport_Writing-ClaudeCode.zip --target claude-code
python scripts/package_skill.py dist/ResearchReport_Writing-DuMate.zip --target dumate

包内含 package-manifest.json 文件哈希清单；同一源码在同一构建环境中可重复生成相同 ZIP。发布时另附 SHA256SUMS.txt。打包脚本使用明确的文件范围，不携带 Git 历史、临时文件、个人报告和本机配置。

CI 在 Ubuntu、macOS、Windows 上测试生成、校验、字体和解压包运行，并在 Ubuntu 验证渲染。客户端加载与实测结果见验证记录，目录与能力边界见兼容性说明。

许可证

原创代码、技能指令和文档使用 Apache-2.0。四种方正字体按维护者确认的再分发授权附带，仍归各权利人所有，不适用本项目的 Apache-2.0 授权。详见 NOTICE。