可研报告写作：难的不是文笔，是框架和口径
260 页初步设计拆出的可研骨架：A4 公文格式、19 章框架、写作套路与交付 QA 清单。
可研报告这种文体，我写过几轮，最难受的从来不是「写不出来」。
是写完了不知道够不够。综合说明里该列哪几项，设计依据该引到哪一层，投资概算的汇总表要不要和建设内容逐条对上——没人给你一份明确的清单，只能对着上一版报告猜。
更麻烦的是 Word。别人递过来的模板，样式声明和实际呈现经常是两回事：有人在段落上直接改了字号，有人把标题套成了正文样式，还有人前后章节的格式压根不统一。你要是按 style=Heading1 去判断层级，后面整份文档的编号和目录都会歪。
我把这半年攒下来的技能陆续上架到了 WorkBuddy，一共 11 个，这是第 9 篇。这一篇讲「可研报告写作」，就是把上面两个问题做成了一套可执行的规格。
一、为什么要做
起点是一份 260 页、1987 段、52 张表、58 张图的初步设计文档。我把它从头到尾拆了一遍，发现真正决定一份报告能不能站得住的，是三件事。
一是格式。A4 纵向、页边距、正文的字体字号行距缩进、标题的多级自动编号、图表按章编号、自动目录和页眉页脚，这些是门槛，缺一项就显得不专业。
二是框架。哪几章必须有，每章里该有哪些节，节里该放哪些要素。这一层最容易漏，也最容易被问住。
三是口径。同一个数字在概算表、效益分析和结论章里必须对得上；引用的法规要按效力层级排；结论要回头呼应上位规划和政策符合性。
三件事都不是文笔问题。文笔好，也帮不了你补上那张「可研估算与初设概算对照表」。
二、它能做什么
拆开说，它输出五样东西。
一份格式规格。A4 纵向，页边距上下 2.54cm、左右 3.18cm；正文宋体 14pt、1.5 倍行距、首行缩进 2 字符、两端对齐；章标题黑体 18pt 加粗居中，节标题 15pt，小节 14pt；表格与图注 10.5pt。这些写的都是实际呈现值，不是样式表里的理论值。
一套 19 章框架。从综合说明、区域概况一路排到投资概算、风险分析和结论与建议，其中 7 章标了 ★，是必备核心章，其余按项目取舍。每章往下列到小节，标清这一章到底要交代什么。
各章的写作套路。项目概况怎么写、设计依据分几类怎么排序、建设内容及规模怎么分项、必要性怎么论证、结论章怎么收口，都有对应的写法和句式。
python-docx 实现要点。中文字体要额外设 eastAsia、目录要插 TOC 域、页码要插 PAGE 域，还有几个我踩过的 API 坑，都写在文档里。
一份交付 QA 清单。10 条，从标题层级有没有跳级，到 $xx$、{{}}、<TODO> 这类占位符有没有漏在正文里，交付前逐条过一遍。
三、框架与套路
先说框架。技能文档里管它叫「19 章框架」，逐条列出来是 17 个编号章，7 章标 ★。
第一章综合说明是全文的压缩版，也是信息密度最高的一章：项目概况要列七项属性，名称、地点、业主、编制单位、类别、性质、主要实施范围；设计依据分法律法规、标准规范、其他依据三类；后面接着设计目的、设计原则、设计范围、建设内容及规模、建设工期、工程总投资；最后是建设必要性，还要单独论证规划政策符合性。
第三章开始进入项目本身，对每个对象都是四段式：基本情况、范围或保护区划分、环境质量状况、规范化建设情况。对象有几个，这套结构就重复几遍。
第六章工程设计是最厚的一章。它的结构是按建设内容分节，每一节都是同一条流水线：设计要求、方案比选、设计参数、布置、主要工程量。方案比选要用表格对比优缺点，内容多的项目可以一直细到五级标题。
第十四章投资概算，是评审翻得最仔细的地方。总投资汇总表，加工程费、其他费、预备费三项分项费用，再加一张可研估算与初设概算的对照表；表格列固定是序号、项目、建设内容、规模、投资（万元）、备注。
第十七章结论与建议负责收口：先呼应规划符合性，再复述建设内容及规模，报出总投资，给出总体论证结论，最后落 3 到 5 条建议，从工程性质、管理、资金、运营这几个角度提。
再说套路。我觉得最有用的是设计依据那一节的写法：法律法规按效力层级排，每条写成「（序号）《书名》（文号或日期）」，能列二十多部；标准规范列三十多部国标行标；最后一类其他设计依据，把设计合同、可研报告、上位规划、现场踏勘资料、业主提供的其他资料统统兜进去。这一套结构摆出来，至少在依据上没人挑得出毛病。
编号体系也定了规矩，而且不许混用：章标题走 1、1.1、1.1.1 的自动多级编号，最多五级，用 Word 多级列表而不是手输数字；章内的论证列表用（1）（2）（3），二级用 ①②③；图表按章编号，写成「表 3.1」「图 2.21」。
最后是格式和检查。上面列过的参数之外，还有两条容易漏：三个以上标题就必须加自动目录；页眉放项目全称，页脚放居中页码。
交付 QA 那 10 条里，我最看重两条。一是用 python-docx 重新打开生成的文档，遍历段落核对层级、字号、缩进，再全文检索一遍占位符残留；二是找一篇格式标准的范例文档做对比复核，至少核对标题的字号、加粗和缩进。
为什么强调「重新打开核对」？因为这份技能的第一条判断原则就是：人工写的 Word 文档，标题的实际呈现效果常常和样式定义不一致，判断层级必须以最终呈现为准。生成新文档时则反过来，样式定义和想要的效果必须一致，别留两层脱节。
四、怎么调用
技能上架在「办公协同」分类下。在技能市场点右上角加号安装，之后在对话里说人话就行——它是纯规则型技能，包里没有脚本，不联网，也不需要任何 Key。
可以这么触发：
「按可研框架帮我起草第一章综合说明和第二章区域概况」
「这份初步设计缺哪些章？按 19 章框架对一遍，标出必备核心章」
「用交付 QA 清单检查这份报告：标题层级、占位符、字号和缩进」
技能内部没有可执行脚本，落地靠 python-docx。文档里给的起手式是这样的，规格已经按格式规范填好，可以直接复制：
from docx import Document from docx.shared import Pt, Cm from docx.oxml.ns import qn doc = Document() sec = doc.sections[0] sec.page_width, sec.page_height = Cm(21.0), Cm(29.7) sec.top_margin = sec.bottom_margin = Cm(2.54) sec.left_margin = sec.right_margin = Cm(3.18) # 标题样式：字号/加粗按规格设置；中文字体须同时设 eastAsia style = doc.styles["Heading 1"] style.font.size = Pt(18) style.font.bold = True style.font.name = "Times New Roman" style.element.rPr.rFonts.set(qn("w:eastAsia"), "黑体") doc.add_heading("1 综合说明", level=1) doc.save("报告.docx")
有个坑值得单独提：如果要手动插首行缩进的 XML，<w:ind> 必须按 OOXML 的元素顺序放在 w:spacing 之后、w:jc 之前，否则 Word 打开会报 unexpected child element 'ind' 的 schema 错误。稳妥的写法是 jc.addprevious(ind)，而不是直接 append。
最省事的用法就三步：
1. 在 WorkBuddy 技能市场安装「可研报告写作」 2. 对话里说：按 19 章框架起草综合说明，并列出必备核心章 3. 生成后按交付 QA 清单逐项核对，在 Word 里更新域重算页码
五、边界与注意
这一节我说直白一点。
它不提供数据，也不给行业参数。投资单价、工程定额、设备参数、地质水文指标这些，必须来自你的项目资料、现场踏勘和业主提供的材料。技能能告诉你投资概算这一章要有哪几张表，但表里的数字得你自己填，它也不会替你估一个。
它不替代咨询资质的实质判断。报告的责任主体是编制单位和持证的咨询工程师，技术方案怎么取舍、结论怎么担责、评审意见怎么回应，都不在技能范围内。它做的是把格式、框架、口径这三层摆整齐，让你少返工。
章节是按项目取舍的。19 章是工程类可研和初设的通用骨架，标 ★ 的七章建议都写；水土保持、节能减排这类，项目不涉及就可以不写。非工程类的报告，框架得你自己拆。
格式之外的东西它管不了。技术内容的专业性、数据来源的可靠性、方案本身的合理性，技能不会替你判断，也不该替它背书。
页码要你自己更新一次。自动目录是插入域代码实现的，python-docx 没法重算页码，交付前要在 Word 里更新域，或者生成时设置让 Word 重算。这一步最容易漏，我这次测下来就漏过一次。
它是 v1.0.0，规格都写在文档里。字体字号、页边距这些数字都在技能文档中；你的单位如果另有公文格式要求，直接改文档里的数值就行，框架不用动。
最后说一句我的判断：可研报告这种文体，框架和口径的整齐程度，比文笔更能决定它能不能过。文笔是加分项，缺项是扣分项。
我是文茂，热衷于分享 AI 工具与开发者生态观察。觉得有用欢迎点赞、在看、转发三连。