القائمة
把分析结果、进展、流程或操作要求写成结论先行、数据有源、面向行动的中文报告、指南、备忘或纪要。只要正文时不调用 docx；实际生成 Word 时再配合 docx。不用于论文与投稿材料（academic-publishing）或咨询交付包打包（consulting-delivery）。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
初始化标准卫生统计研究或咨询项目，默认生成 R 七层目录，也可按用户明确选择生成 Python 目录，并创建 PROTOCOL、SAP、结果单源、registry 与可选 Git 配置。仅在用户明确要求创建项目或把空工作区建成正式项目时使用；简单作业、快速核验和已有项目分析不触发。上游为 biostat-principles；咨询项目完成分析后再用 consulting-delivery。
Python 流行病学与生物统计分析的可选执行层，仅用于用户明确要求 Python，或既有项目已经以 Python 为主流程时的数据清洗、描述统计、回归、生存分析、预测验证、统计表图、代码调试和结果复现。开工先遵循 biostat-principles；统计图配合 publication-figures，客户外发再用 consulting-delivery。未指定语言的普通统计分析、R 环境或依赖缺失、研究设计定稿、论文写作或仅操作 xlsx 文件不触发。
R 流行病学与生物统计的主要执行层，用于 R 数据清洗、描述统计、回归、生存、中介、Meta 分析、统计表图和代码调试；用户未指定语言且无既有语言合同时也使用。开工先遵循 biostat-principles；统计图配合 publication-figures，客户外发再用 consulting-delivery。不用于已明确采用 Python 的分析、研究设计定稿或论文写作。
基于已验证的代码、结果单源和表图生成或结构性重写中英文期刊论文、学位论文部件、摘要、题名、cover letter、审稿回复、highlights 和投稿正式往来，并做投稿前一致性自查。开工先用 biostat-principles，终审用 academic-humanizer；实际 Word 操作再配合 docx。已有文本的局部润色或压缩只用 academic-humanizer。
流行病学与生物统计的上游行为原则，用于研究设计、R/Python 分析、论文、咨询交付和项目审查开工前，以及口径争议、结果不一致或试新方法时。提供原始数据只读、最小实现、可验证目标、结果追溯、复现、异常闭环和隔离实验规则；轻量任务不因此升级为正式项目。
把已完成并验证的 R 或 Python 分析打包为客户可独立复现、可直接阅读且保留真实溯源的咨询交付物。用于“给客户交付”“打包结果”或在 05_reports/ 建正式结果包；不用于未完成分析或内部探索。上游为 biostat-principles，文本终审配合 academic-humanizer，签发配合 epi-project-audit。
| name | report-writing |
| description | 把分析结果、进展、流程或操作要求写成结论先行、数据有源、面向行动的中文报告、指南、备忘或纪要。只要正文时不调用 docx；实际生成 Word 时再配合 docx。不用于论文与投稿材料（academic-publishing）或咨询交付包打包（consulting-delivery）。 |
一句话定位：把已经成立的事实（分析结果 / 流程 / 进展）写成读者一眼能用、无模板化写作痕迹的专业中文报告；用户要求文件时再生成对应载体。 报告 ≠ 论文：论文为审稿人证明严谨，报告为读者快速决策与执行服务。
07_paper/results.yaml 机器单源 / 其派生 0_result_summaries.md、03_tables/ 导出表或用户明确给的来源），
逐字一致、不四舍五入到与源不符。脚本化生成时用 build_report.py 的 val("07_paper/results.yaml", "key") 取数，
禁止手敲数字（"禁手敲"指数字须经 val() 从单源取以保持同步，不是禁止阿拉伯数字——统计值一律用阿拉伯数字、按各自精度呈现，NEVER 为规避而虚化成中文数字如"零点四四"）。源里没有的 → 标 [待确认]，不要瞎填。双向一致性：改数字回 results.yaml 改再传播，NEVER 就地改。academic-humanizer 的不可变事实清单、学术语体与论断证据审校。03_tables/（xlsx）有对应表就读取并作为三线表插入正文、
凡 04_figures/ 有对应图就作为图片嵌入正文，不要只在文字里描述"见表 X / 如图所示"而不放实际表图。
表题在表上方、图题在图下方，编号按行文顺序连续。无现成表图时，统计图按 publication-figures；封面、章节图、流程、结构、机制、场景和概念插图按 research-visuals 的报告载体规范建立视觉简报并调用 imagegen，适用的 Image 2 先于 SVG，全部适用生成路径耗尽后才最终回退 svg-diagrams；表格按 xlsx 规范现做再插。.md 与 .docx。02_code/""详见 DECISIONS.md""方法决策记录在…""所有脚本/文件在…""基于 xx.R"之类的工程内部痕迹——
这些是内部审计内容，不进交付报告。方法节只写中性可复现的最终口径（用了什么模型/检验/校正），像论文的 Methods，
不提脚本名、文件路径、决策记录、版本、调参。例外：报告本身就是"基于某些文件的说明/操作指引/文档类"
（如填写指南、流程说明、代码文档），这类才按需引用具体文件。判据：统计结果报告 = 论文式，不谈代码与文件归档。CLAUDE.md §1 与 §8）。09_backup/。轻量任务不补建归档目录，只覆盖用户明确指定的输出或另存到其指定位置。| 维度 | 论文（academic-publishing） | 报告（本 skill） |
|---|---|---|
| 读者 | 审稿人、同行 | 决策者、客户、团队、执行人 |
| 目的 | 证明结论可信、可发表 | 让读者快速理解并据以行动 |
| 结构 | IMRaD 固定、参考文献规范 | 灵活，按"读者需要先知道什么"组织 |
| 开头 | 背景铺垫 → 逐步推进 | 执行摘要 / 结论先行 |
| 语气 | 客观克制、回避主观 | 客观但更直接，可给明确建议 |
| 篇幅取向 | 完整论证 | 抓重点、去冗余、可要点化 |
| 引用 | 严格文献规范 | 注明来源即可，不强求文献格式 |
报告仍要：数据有源、书面语、无模板化写作痕迹、零编造，这几条与论文一致，不放松。
通用骨架（按需裁剪、重排）：
按类型选骨架：
参照范式：成稿的视觉与文风对标一份真实统计咨询报告——居中加粗多行标题、中文数字章节（一、二、三…）+ 4.1/4.2
子节、全段落叙述、三线表、表上图下题注、统计符号斜体。没有任何灰色说明小字，也不使用项目符号堆叠。
字体（中英分设，必须设 eastAsia；这是用户硬要求）：正文 中文宋体 / 英文 Times New Roman 10.5–12pt；
标题用黑体（或微软雅黑）加粗；一级标题 14–16pt、二级 13pt、三级 11–12pt。中文统一一种字体，不混用。
每个 run 都要同时设 font.name（英文）与 w:eastAsia（中文），否则英文数字会回退成宋体、中文会变默认西文字体。
from docx.oxml.ns import qn
from docx.shared import Pt, RGBColor
def setfont(run, cn="宋体", en="Times New Roman", size=10.5, bold=False, italic=False, color=(0,0,0)):
run.font.size = Pt(size); run.font.bold = bold; run.font.italic = italic
run.font.name = en # 英文/数字字体
run._element.rPr.rFonts.set(qn("w:eastAsia"), cn) # 关键：中文 eastAsia 字体
run.font.color.rgb = RGBColor(*color) # 默认纯黑
标题页（重点修复"标题下灰色小字"问题）：
正文版式：
4.1、4.2；正文 1.5 倍行距、首行缩进 2 字符（论文式，build_report.py 的 para() 已内置）；段后 3–6pt，不靠空行撑版面。标题/题注/执行摘要标签段不缩进。P、vs、t、F、r、n（变量符号）等用 斜体；单位（kg、%）和"95%CI"正体。表格（三线表，自动从数据生成）：
cell.vertical_alignment = WD_CELL_VERTICAL_ALIGNMENT.CENTER）。03_tables/ 对应 xlsx（用 xlsx/openpyxl 读单元格）填入三线表，不要手敲数字另起炉灶；
无现成 xlsx 时据 0_result_summaries.md 构表。表题在表上方（"表1 …"），必要时表下加一行斜体小号注。图片（自动嵌入）：
自动嵌图：报告涉及的统计图从 04_figures/ 取对应 PNG；封面与章节视觉采用编辑出版构图，流程图、结构图、包含关系、概念框架、机制示意和研究场景按 research-visuals 生成最终 PNG。生成前读取实际版心、标题区、配色和图片角色；真实科研原始图像不得生成式重绘。只有走矢量回退时才保留同名 SVG+PNG，并用 PNG 供 python-docx 嵌入。正文图片居中，宽度约占版心（通常 5.5–6.5 in），图题在图下方（"图1 …"）。
全文字体一律黑色（标题、正文、表头、注释一律纯黑 #000000）；不用彩色字、不用灰字；层级靠字号与加粗区分，不靠颜色。禁止表情符号、禁止彩虹色、禁止默认灰底。
禁止：深色标题条、深色表头和无明确含义的单元格底色；标题下灰色说明小字；正文项目符号堆叠；表情符号；长破折号当连接号；口语 / 网络词；生成过程痕迹；无来源的"最佳 / 显著 / 证明"。
构建助手：排版统一用 references/build_report.py（Report 类）——已封装中文宋体/英文 Times New Roman（每 run 设 eastAsia）、
干净标题页（无灰字）、三线表、table_from_xlsx() 自动取数、figure() 嵌图和统计符号斜体。save() 的输出参数按用户请求设置，不默认双格式。
内容仍须按本节强制要求写入，助手只保证排版正确。
流程：定读者与目的 → 选骨架（§二）→ 取数（强制要求 1）→ 收集要插的表（03_tables/ xlsx）与图（统计图 PNG；非统计图默认 imagegen PNG，矢量回退为 SVG+PNG）
→ 逐节结论先行，把数与图表引用织进正文 → 套排版（§四，宋体/Times、三线表、表上图下、统计符号斜体）
→ 正式项目按需归档被替代旧版 → 生成用户要求的载体 → 自检 → 交付时先报告已自检项。
完成前自检（不等用户挑错）：
03_tables/ xlsx、图取自 04_figures/[待确认]academic-publishing（本 skill 不处理论文）。academic-humanizer 的不可变事实清单、语体和论断—证据一致性审查。publication-figures；封面、章节、流程、结构、机制、包含关系和研究场景视觉 → research-visuals 按报告载体建立视觉系统并调用 imagegen，适用的 Image 2 先于 SVG，全部适用生成路径耗尽后才最终回退 svg-diagrams。docx skill。consulting-delivery（本 skill 只管报告本身的写作与排版）。