name: feasibility-report-engine slug: feasibility-report-engine displayName: 產業項目可研報告·發改委2023大綱Word成稿+六表測算 version: 1.7.0 homepage: https://github.com/nousresearch/hermes-skills description: 做可研報告，卡住的往往不是不會寫，是不知道按哪版大綱、財務測算六表和正文對不上、交付前排版被退稿。這套是從二十多萬字、131 張表的真實交付裡固化的流水線。
為什麼可以信這套：
- 大綱判型判錯整篇重寫：發改委 2023 大綱政府版 11 章 38 節、企業版 10 章 37 節，兩套結構不同，先判型再動筆
- 六表必須全公式聯動：改一個參數不全表重算，表格之間立刻前後矛盾，評審一眼就能看出來
- 排版是退稿高頻項：Word 裡圖片跨頁、表格斷行、目錄頁碼不對，都是被退回的原因，所以交付前有一道體檢
怎麼做的：判型 → 聯網盡調採集 → 財務測算（六表全公式）→ 按大綱成稿 → 專業排版本 AI 痕 → 多模型視覺驗收 → 交付。
輸入：項目基礎資訊、甲方要求、可拿到的公開數據 輸出：可研報告 Word 成稿 + Excel 六表測算套表（改參數自動重算）+ 說明文檔
觸發詞：可研報告、可行性研究報告、可行性研究、立項報告、項目建議書、發改委大綱、財務測算、六表勾稽、融資可研、政府可研、企業可研、報告排版。 author: 九品錦鋰e category: professional tags: [feasibility-report, 可研報告, 立項, 融資, 撰寫, 對外交付, 排版, 視覺驗收, word, excel, 報告QA, 財務測算] summary: 可研報告全流水線：大綱判型→聯網盡調→財務測算→Word成稿→去AI痕→視覺驗收，含政府11章/企業10章兩套大綱。
可研報告撰寫引擎（產業專案可行性研究報告 · 對外交付完整作戰手冊）
技能型態標註：本技能 = 可研報告撰寫的「Word 完整版 + Excel 測算套表」交付版。 產出物型態：①Word 報告全稿（封面→正文→附表，按發改委 2023 大綱）②Excel 投資測算套表（公式全搭好）。 同一業務族的兄弟技能（按交付型態區分）：PPT 版可研演示稿、PDF 版可研報告 —— 另行沉澱（規劃中，見 README 技能路線圖）。 用法速覽：客戶/專案方給素材 → 本引擎六步走 → 交付三件套（報告docx + 測算套表xlsx + 編製說明docx）發到使用者聊天框。 本引擎從 2026-09 真實大單（300億海洋產業叢集·九大分冊·20萬字）全流程實戰沉澱，含全部避坑點。
v1.6 能力升級（本次）：① 新增
report_qa.py長文檔 QA（快取/斷言驗收/正規查改）與pipeline_check.py流水線自檢，純 Python 標準庫，零依賴開箱即跑；② 新增「報告品質三關」與「交付前驗證清單」，把「憑感覺交付」改成「逐條打勾交付」；③ 補「分頁與圖片鐵律（Word 渲染 ≠ LibreOffice 渲染）」與 PDF 版交付；④ 新增「改稿與口徑對齊」章，客戶回稿/改數不再翻車；⑤ 新增財務測算口徑與四表勾稽檢查表、敏感性分析要求。
一、觸發條件與定位
觸發：客戶/委託方要「可研報告」「可行性研究」「立項報告」「融資盡調報告」；客戶給了零散素材（專案名/地點/規模/幾張圖），要一份能見資方/報審/招商的正式報告。
與兄弟技能分工：
| 技能 | 用途 |
|---|---|
| 本引擎 | 對外交付客戶的可研（合規金標準=發改委2023大綱） |
| report-production-pipeline | 通用報告生產流水線（五階段+自檢腳本），本引擎的第二至四步與它同構 |
| feasibility-study-writing | 內部決策/商業方案論證 |
| mh-calculation | 財務測算引擎（17張表，本引擎測算調用它） |
商業交付紅線（隱身代工）：
- 客戶自己署名交付，我們只做內容——編製單位/日期/落款一律留空由客戶填
- 絕不暴露 AI 痕跡（檔案名不帶「終版/AI/雙模型評審」，元資料清空，正文無AI符號）
- 資質蓋章：提示客戶找有資質的工程諮詢單位掛章合作（合規紅線+獲客切入點）
- 報價錨點：賣「快+專業」，定製標準檔 8千-1.5萬，不做3千以下低端
二、行業金標準：兩條大綱（先判型再動筆）
國家發改委 發改投資規〔2023〕304號《投資項目可行性研究報告編寫大綱及說明》——寫可研的唯一合規基準。
| 判型 | 政府投資項目（通用大綱11章） | 企業投資項目（參考大綱10章） |
|---|---|---|
| 出資 | 政府投資/資本金注入/專項債 | 企業自籌/市場化融資 |
| 典型客戶 | 城投/平臺/政府項目 | 民企/產業投資/混合所有制 |
| 強調 | 建設必要性/社會效益/資金平衡 | 市場需求/盈利能力/商業模式 |
完整逐章要求見 references/（gov-dagang-2023.md 政府版、ent-dagang-2023.md 企業版），寫作時逐章對照。
判型自檢（判錯=整篇返工，先答這四問）
- 錢從哪來：財政資金/專項債/政府平臺出資 → 政府版；企業自籌/商貸/市場化融資 → 企業版。
- 報給誰看：發改委審批/核准、財政資金申請 → 政府版；銀行審貸、投資方決策、招商 → 企業版。
- 落點是誰的需要：公共需要（區域短板/民生/上級規劃硬性要求）→ 政府版；市場需求與盈利能力 → 企業版。
- 有沒有這些章：績效管理方案、碳達峰碳中和分析 → 政府版專有；商業模式/行銷策略/競爭分析權重更高 → 企業版。
混合出資（政府資本金+企業自籌）時：以審批/報批口徑為主綱，企業財務論證併入「投融資與財務方案」章，並在概述裡點明雙口徑。
三、六步工作流（全流程）
Step 0：素材盤點 + 判型 + 接單三問（0.5h）
先問三件事再動筆：
- 用途（立項報批/銀行融資/招商路演/內部決策）→ 決定版式深度與大綱
- 業主性質（政府平臺/民企）→ 決定套政府版還是企業版大綱
- deadline → 決定模式A（完整7-15天）還是模式B（首版快交付1-3天）⭐
素材盤點「已有 vs 缺口」，缺口一次問齊別來回。缺投資估算→行業基準估算並標註「按XX行業慣例」；缺土地/選址→公開規劃盡調。客戶給的資訊少→走模式B。
完成判據：判型結論一句話寫下來（政府版/企業版 + 依據）；素材缺口清單成文；模式A/B 明確。
Step 0.5：資料需求清單（三批，一次要齊別邊寫邊問）
| 批次 | 內容 | 缺了的後果 |
|---|---|---|
| 第一批 量價與投資基礎 | 建設內容與規模、設備清單與詢價、地價/租金、水電氣價、人工成本 | 缺則只能出「前期論證版」，投資估算標行業慣例 |
| 第二批 主體與合規確權 | 營業執照/主體文件、用地預審與選址、環評/能評/水保/穩評、海域使用等批復與辦理狀態 | 缺則合規模塊只能寫「辦理中」，評審會被挑 |
| 第三批 市場與訂單實證 | 意向訂單/框架協議、上下游合約、同類項目營運數據、政策依據文件 | 缺則市場分析只剩公開數據，深度打折 |
清單模板：references/data-request-list.md。發出清單時同步說明：「缺第二批只能出前期論證版」——既是專業，也是二次收費抓手。
Step 1：聯網盡調（必做！1-3h，四路並行）
禁止不搜尋就寫。 可研「上得了檯面」和「模板套話」的分水嶺=每個論斷有數據/政策支撐。
- 政策面：省市產業政策/專項規劃/行業准入 → 搜「[行業] 十五五 規劃」「[省市] 產業政策 [行業]」
- 市場面：行業規模/增速/競爭格局 → 券商研報/行業協會/統計局，多源交叉
- 區域面：選址地園區/土地/配套/同類項目 → 搜「[城市] [行業] 產業園」
- 基準面：同類項目投資強度/收益率 → 對照 mh-calculation 行業基準
每條關鍵數據落來源（機構+年份+連結），寫作標出處。缺數據的不硬編，寫「待盡調確認」並給行業區間。
取數通道（按頁面難度升級，別在第一檔就放棄）：
- 一檔：普通抓取/搜尋引擎摘要 —— 政策原文、新聞、公開報告
- 二檔：帶反爬繞過的抓取（渲染 JS、處理 Cloudflare 挑戰） —— 政府網站、行業協會、研報站
- 三檔：瀏覽器實控（點擊/翻頁/表單） —— 需要互動才能取到的數據（查詢系統、公示庫）
- 取回的原始材料落盤留痕（
<專案名>/盡調/下按來源命名），寫作時能回查，改稿時不用重搜。
完成判據：關鍵數字都能回答「誰說的、哪一年、什麼口徑」；原始材料已落盤可回查。
Step 2：分工寫作（模型矩陣——這是能出20萬字大部的關鍵）
不要讓一個模型一口吃完全文。 分角色：
- 主腦（當前對話模型）：搭結構骨架、寫總論/概述/戰略論證、最終組裝審校
- 擴容模型（更強模型 API，如 DeepSeek V4 Pro / 千問 max）：深度擴寫財務評價、市場分析等重頭章節——逐章餵「該章現狀+擴充要求+範例」，max_tokens 調大（12000+，否則 reasoning 吃滿輸出 0）
- 測算模型：調 mh-calculation 算 IRR/NPV/回收期（不要手算）
- 評審模型（聰明模型通讀全文挑刺）：千問/豆包以資深操盤手身分通讀全文（不是餵摘要）找邏輯漏洞/口徑打架/數據失真
- 視覺模型（排版驗收，見 Step 4）：Mimo 2.5 / DeepSeek Vision / GLM-4V / 千問VL 交叉看圖
經驗：同 key 可調兩檔（flash日常/pro深活）；評審要給全文真實文本不給摘要，否則白評。
寫作前先出章節清單（每章＝要說什麼｜憑什麼說｜從哪來），證據列留白的章節退回 Step 1 補，不許帶著空證據開寫。清單模板見 templates/report-plan.md。
完成判據：章節清單三列齊全無留白；每章初稿有數據、有來源、邏輯鏈閉合。
Step 3：品質三關（AI 初稿 → 敢交稿之間的一關，別跳）
| 關 | 做什麼 | 過不了怎麼辦 |
|---|---|---|
| ① 反思 | 回顧過程：數據完整嗎？來源可靠嗎（一手/二手）？邏輯有沒有跳躍？ | 補數據、換來源、補論證 |
| ② 審查 | 清單逐項核對：結論與證據匹配嗎？有無過度推斷？反方觀點回應了嗎？數字/名稱/日期準嗎？口徑統一嗎？ | 逐條修正，不能「大概齊」 |
| ③ 修正 | 改完必須再掃一遍修正處（重點看是否引入新錯誤），並復掃全文舊口徑殘留 | 復掃不通過就再來一遍 |
清單化版本：templates/review-checklist.md。機器可跑的底線檢查：
python3 scripts/pipeline_check.py 報告.md # 來源標註/不確定性披露/反方視角/結論/結構/數字口徑
python3 scripts/pipeline_check.py 報告.md --strict --json # 退出碼非0=有硬傷，可直接接自動化
起草與審查不能是同一輪完成——自己寫的東西自己看不出錯，是認知規律不是態度問題。換視角/換模型/至少換一輪。
Step 4：排版工程（AI 初稿 → 專業交付版，scripts 一鍵）
AI 生成的 docx 直接交付=外行特徵。用 scripts 流水線處理：
# 1) 從零起骨架：封面+簽署頁+自動目錄+頁眉頁碼（樣式體系已內建）
python3 scripts/gen_report_docx.py "專案全稱" "" 輸出.docx
# （中間參數=編製單位，對外交付一律傳空字串留白）
# 2) 已有初稿/客戶docx：加門面（封面/簽署頁/目錄域）→ 見 scripts/face_docx.py --help
python3 scripts/face_docx.py 輸入.docx 輸出.docx "專案全稱" "" "KY-2026-×××"
# 3) 排版淨化（AI痕跡清除+樣式重建+表格美化）⭐ 最常用
python3 scripts/docx_polish.py 輸入.docx 輸出.docx "專案全稱" --title "報告標題"
# 4) 測算套表（公式搭好，藍=輸入）⭐ 專業版 v2（三線表+五色語義+封面填表說明）
python3 scripts/gen_model_xlsx_v2.py 輸出.xlsx "專案名" 總投資萬元 達產收入萬元 建設期 營運期
# 範例: python3 scripts/gen_model_xlsx_v2.py 套表.xlsx "××專案" 3000000 600000 4 16
# 5) 編製說明與資料需求清單（1-2頁，交付三件套之一）
python3 scripts/gen_shuoming.py 輸出.docx "專案名稱" "約300億元"
4.1 分頁與圖片鐵律（Word 渲染 ≠ LibreOffice 渲染——血淚總結）
核心認知：用 LibreOffice 轉 PDF 自查排版 ≠ Word/WPS 打開效果。客戶 90% 用 Word/WPS，分頁/裁圖類問題只在 Word 引擎暴露，必須先查 XML 再下結論。
| 症狀 | 根因 | 修復 |
|---|---|---|
| 圖片只露一細條/一角落 | Normal 樣式 lineRule="exact" 固定行距裁掉行內圖片（Word 特有，LO 不裁） | 正文樣式行距改 atLeast（保留視覺行距但允許圖片撐開）；含圖段落顯式 spacing line=240 lineRule=auto |
| 一頁只有一行字/大片空白 | 表格每一行都設 cantSplit（禁跨頁斷行）→ 大表放不下就整表跳下一頁 | 只鎖表頭行 cantSplit，數據行全部放開可跨頁；表頭加 tblHeader（跨頁自動重複表頭） |
| 表格觸 Word 異常分頁 | 表格總寬超版心（A4 版心=8730 twips，3cm左邊距） | gridCol 等比縮到 ≤8700 twips |
| 正文殘句孤行頁（頁尾2行斷句） | 段落恰好跨頁只剩2行 | 該段加 keepLines（段中不分頁），整段移到下一頁 |
| 末頁孤行（「（全文完）」單獨佔頁） | 附錄大表後收尾段放不下被推末頁 | 直接刪收尾標記或壓縮前表 |
| 封面「編製單位：______」橫線 | 底線空格佔位 run（<w:u>+空格） | 單位名已填時刪掉底線空格 run，不留佔位橫線 |
修復後必須重新渲染複查：fitz 逐頁掃描 max_y<350 的「幾乎空頁」和圖片寬度>200pt 確認完整。
4.2 PDF 版交付（資方閱讀型態）
- LibreOffice
soffice --headless --convert-to pdf即可，標題大綱自動成書籤（766個=專業級） - 頁碼域/目錄域渲染為佔位是正常現象（Word F9 才刷新）——PDF 用 LO 渲染不受影響，docx 要提示客戶 Word 打開 F9
- 大 docx（>10MB 含多圖）手機/IM 預覽可能不顯示圖 → 交付時附 PDF 版 + 提示用 Word 打開
Step 5：報告 QA（數字與口徑的自動體檢）
python3 scripts/report_qa.py stats 報告.docx # 規模體檢：頁量/段落/字元/內嵌圖片
python3 scripts/report_qa.py grep 報告.docx "舊口徑|舊數字" # 正規查（含表格儲存格，漏掃表格=漏掃一半數字）
python3 scripts/report_qa.py check 報告.docx baseline.json # 斷言驗收：禁用詞必須0命中、必含項必須出現
python3 scripts/report_qa.py cache 報告.docx # 建純文字快取，改稿期間反覆查快 ~14 倍
- 改稿交付前，把客戶的每一條要求寫成一條斷言（禁用詞/必須出現），一條命令自證全中——比人眼掃三遍可靠
- 斷言集為空會顯式告警，避免「0/0 全綠」的假陽性
Step 6：視覺驗收 + 交付（三件套 + 雙輸出）
視覺驗收（交付前最後一道閘）：AI 排版的問題文字檢查看不見，必須渲染成圖讓視覺模型「親眼」看。單個模型會敷衍/誤判 → 用 2+ 個交叉驗證，發現問題用座標數據複核後再修。
# 環境變數任選其一（推薦按序配置：免費 → 便宜快 → 備胎）
export ZHIPU_API_KEY=... # ① GLM-4V-Flash（免費，速度1.6s/頁）——首選
export DASHSCOPE_API_KEY=sk-... # ② qwen3-vl-flash（百煉千問視覺Flash，便宜快）
export MIMO_API_KEY=... # ③ 小米 Mimo 2.5（原生多模態）
export DEEPSEEK_API_KEY=... # ④ DeepSeek vision（備胎——DeepSeek 主用於幹活寫作，視覺少佔用）
python3 scripts/vision_check.py 報告.docx # docx→渲染關鍵頁→多模型審查（按①→②→③→④自