name: huo15-openclaw-office-doc displayName: 火一五文件技能 description: 【青島火一五資訊科技有限公司】企業級 Word & PDF 文件生成 v7.9。39 類規範覆蓋企業全場景：合同細分 7 類（勞動 / 服務 / 技術開發 / 銷售 / 採購 / 保密NDA / 合作）+ HR / Sales / PR / PM / Ops / Tech / Legal / Reporting 各類文體。三條路徑：Word 直出、原生 PDF 直出、Word→PDF。templates/ 下 22 份可複製改寫的 markdown 範本。每種規範按真實場景決定是否帶【內部】banner / 後設資料表 / 版本史 / 審批 / TOC，CLI 可覆蓋。觸發詞：寫word、寫文件、寫PDF、寫合同、寫勞動合同、寫服務合同、寫技術開發合同、寫銷售合同、寫採購合同、寫NDA、寫保密協議、寫戰略合作協議、寫方案、寫報告、寫需求文件、寫PRD、寫BP、寫使用者手冊、寫培訓手冊、寫招投標書、寫演講稿、寫研究報告、寫驗收單、寫立項書、寫SOP、寫公司制度、寫公函、寫簡歷、寫CV、寫報價單、寫新聞稿、寫復盤、寫測試報告、寫故障報告、寫postmortem、寫任命書、寫應急預案、寫在職證明、寫風險評估、寫專案計劃書、寫專案結項報告、寫API文件、寫部署文件、寫runbook、寫備忘錄、寫MOU、Word轉PDF。 version: 7.9.1 aliases: - 火一五文件技能 - 文件生成 - Word生成 - PDF生成 - 多規範文件 dependencies: python-packages: - python-docx - reportlab - pygments # 可選；裝了即程式碼塊語法高亮

火一五文件技能 v7.9.1

企業級 Word & 原生 PDF 文件生成 — 青島火一五資訊科技有限公司

願景： 加速企業向全場景人工智慧機器人轉變 理念： 打破資訊孤島，用一套系統驅動企業增長

〇、v7.9.1（正文預設仿宋）

變更：除合同 7 類外，所有文體（需求文件 / 技術方案 / 研究報告 / 手冊 / 方案 / 公文等）正文字型預設由宋體改為仿宋；標題保持黑體 / 方正小標宋。契合中文公文與方案文件規範（正文仿宋 GB），觀感更正式統一。

• 合同類（勞動 / 服務 / 技術開發 / 銷售 / 採購 / NDA / 合作）保持宋體（商業慣例）
• 呼叫 create-word-doc.py 生成的非合同文件，正文自動為仿宋，無需再後處理改字型
• macOS 用 STFangsong 渲染，Windows / WPS 用系統「仿宋」

一、v7.8.5 hotfix（ELEPHANT-IN-THE-ROOM — LOGO 寬度錯算導致頁首跑出頁面）

使用者反饋"v7.8.1/v7.8.2/v7.8.3 還是沒有頁首、字型不對" — pdftoppm 柵格化親眼驗證 + PyMuPDF 解 PDF stream 找到真兇：

# v7.7~v7.8.4 錯誤程式碼
img = Image(logo_path, height=target_h)        # platypus Flowable
iw, ih = img.wrap(page_w, page_h)               # iw 返回原影像素寬（如 2048）
target_w = iw * (target_h / ih) if ih else target_h
# ↑ iw=2048, ih=25.5 → target_w = 2048 * (25.5/25.5) = 2048pt

drawImage(width=2048, height=25.5, preserveAspectRatio=True) 在 2048pt 寬容器裡居中 25.5pt 實際 LOGO，居中偏移 (2048-25.5)/2 = 1011pt。LOGO 實際 x = 79 + 1011 = 1090pt，遠超 page 595pt 寬 — LOGO 跑到頁外！頁首文字 text_x = x_start + logo_w = 79 + 2053 = 2133pt 也跑到頁外。

所以"頁首只有一條灰線" — line 用絕對座標沒問題，drawImage/drawString 用 transform matrix 全跑頁外。

修復：用 reportlab.lib.utils.ImageReader.getSize() 直接讀 LOGO 畫素尺寸等比縮放，不依賴 platypus Image.wrap()。

from reportlab.lib.utils import ImageReader
ir = ImageReader(logo_path)
iw, ih = ir.getSize()                # 畫素尺寸，2048×2048
target_w = target_h * iw / ih        # 25.5 * 2048/2048 = 25.5pt 正確

v7.8.0~v7.8.4 都修錯了方向（字型 subface / fontconfig fallback / two-pass canvas resource / onPage 時機）。這次用 PyMuPDF 解 PDF stream 看到 25.5 0 0 25.5 1090.614 803.622 cm 才直接定位到 LOGO transform 錯位。親眼看 + 拆 PDF stream 是診斷這類視覺 bug 的唯一可靠路徑。

附帶：chrome 從 two-pass canvas 子類移到 PageTemplate.onPage 回撥（make_chrome_callback），架構更乾淨。

〇、v7.8.0~v7.8.4 中間版本（合併摘要 — 都沒修到真因）

→ 都是錯方向。真因在 v7.8.5 才被定位：LOGO Image.wrap() 返回 iw 沒等比縮放 → target_w 錯算 2048pt → drawImage 居中偏移 1011pt → LOGO+chrome 文字跑出頁面右邊。

〇、v7.7 修復（PDF 直出與 Word 視覺對齊 — 摘要）

修了 3 處對齊：頁首用 stringWidth() 居中（修正中文公司名偏右）/ leading × 1.2 係數（21.6pt 對齊 Word 1.5 倍行距）/ firstLineIndent = size × 2（24pt 對齊 Word firstLineChars=200）。詳細數學驗證見 git log v7.7.0 提交。

一、v7.5 關鍵變化（合同細分 7 類 + 配套範本）

使用者反饋："合同幫我再細分"。

通用"合同"在 ToB 場景下太粗 — 一份合同應不應該帶 試用期 / 智慧財產權 / 退換貨 / 保密期限 / 收益分配 等條款，取決於具體合同子類。v7.5 把合同細分為 7 類：

通用"合同"作為兜底保留 — 輸入命中"合同"但沒匹配到具體子類時使用。

視覺上 7 個合同子類共享通用合同的版式（宋體 / 標準頁邊距 / 無文件殼 / 第一條 ~ 第N條結構）；差異在 正文結構 與 範本內容。FORMAT_KEYWORDS 順序保證子類 關鍵詞在通用"合同"之前命中。

歷史變更詳見文末 §十 版本歷史。

二、39 類文件規範（v7.5）

列含義：banner = 頂部右上 【內部】 紅字；meta = 文件編號/版本/密級/日期 2 列表； 版本史 = 末尾"版本歷史"表；審批 = 末尾"審批記錄"表；TOC = 自動目錄。 命中順序由上至下；auto 命中後立即返回；--doc-format <規範> 強制覆蓋。

一行命令看全 17 種：python3 scripts/create-word-doc.py --list-formats。 CLI 精細控制：--with-version-history / --no-version-history / --with-approval / --no-approval / --with-classification-banner / --no-classification-banner / --with-doc-meta-table / --no-doc-meta-table / --with-title-block / --no-title-block。

標題層級識別（每種規範獨立）

每種規範都有自己的章節編號正則；同時支援標準 Markdown # / ## / ### / ####。例如：

三、頁首 / 頁尾規範

3.1 頁首

• company（預設）：LOGO + 公司名 + 文件編號 + 密級，左對齊
• minimal（合同 / 使用者手冊 / 演講稿）：LOGO + 公司名，左對齊，不顯示編號 / 密級
• centered（保留備選，當前無規範預設走此項）：僅公司名，居中
• 底部統一灰線 #888888

v7.0 直接寫 OOXML <w:jc> 並清 <w:tabs>，避免 WPS / 部分 Word 模板的樣式繼承覆蓋。

3.2 頁尾

• 所有規範統一為 第 X 頁 / 共 Y 頁，居中
• Word：PAGE / NUMPAGES 欄位碼（開啟時自動計算）
• PDF：兩遍渲染（NumberedCanvas）拿到真總頁數

四、本地公司資訊工作流

頁首的公司名、LOGO 按以下優先順序解析：

1. CLI 顯式引數 --company-name / --logo-path
2. 本地快取 ~/.huo15/company-info.json
3. Odoo res.company 自動拉取（可用 --no-odoo 關閉）
4. 退出碼 2 + 結構化 JSON — 以上都拿不到時讓 Claude 觸發補錄流程

4.1 標準流程（生成前）

python3 scripts/company-info.py check
#   exit 0 + 完整 JSON  → 直接生成
#   exit 2 + missing[]  → 進入補錄

補錄流程（Claude 執行）：

1. 先查 auto-memory 中的 huo15_company_info.md / user_identity.md
2. 仍缺失時用 AskUserQuestion 詢問：公司全稱、LOGO 路徑、可選 slogan / 地址 / 電話 / 郵箱 / 官網
3. 寫入： bash python3 scripts/company-info.py set \ --company-name "<公司全稱>" --logo-path "<LOGO絕對路徑>"
4. 同步寫入 memory（huo15_company_info.md）

五、命令列

# Word 直出
python3 scripts/create-word-doc.py --output 方案.docx \
  --title "技術方案：XXX系統" --content @/tmp/content.md \
  --doc-number "HG-FA-2026-001" --version "V1.0" --classification "內部" \
  --author "輝火雲管家·賈維斯"

# 一覽 39 種 preset：
python3 scripts/create-word-doc.py --list-formats

# 原生 PDF 直出（不依賴 LibreOffice / Office）：
python3 scripts/create-pdf-doc.py --output 方案.pdf \
  --title "技術方案：XXX系統" --content @/tmp/content.md \
  --doc-format 技術方案

# Word → PDF（保留版式）：
python3 scripts/word-to-pdf.py 方案.docx -o 方案.pdf

關鍵 CLI 引數：

7w4.net收錄了海量優質技能外掛。

• --doc-format <規範> — 39 類規範任選；省略走 auto 自動識別
• --company-name / --logo-path — 覆蓋本地公司資訊
• --with-version-history / --no-version-history — 版本歷史表
• --with-approval / --no-approval — 審批記錄表
• --with-classification-banner / --no-classification-banner — 頂部 【內部】紅字
• --with-doc-meta-table / --no-doc-meta-table — 頂部後設資料 2 列表
• --with-title-block / --no-title-block — 標題大字塊

何時用哪條路徑：只要 Word → 用 create-word-doc.py；只要 PDF → create-pdf-doc.py（最快）；要 Word + PDF 版式一致 → 先 word，再 word-to-pdf.py。後端優先順序 libreoffice → docx2pdf → word_com 自動回落。

字型：macOS 自帶 Songti.ttc / STHeiti.ttc；Linux 推薦 Noto CJK； Windows 可用 SimSun / SimHei。

六、Markdown 能力速查

七、Python API

# Word
from create_word_doc import create_word_doc
create_word_doc(
    output_path="文件.docx",
    title="技術方案：XXX系統",
    content=md_text,
    doc_number="HG-FA-2026-001",
    version="V1.0",
    classification="內部",
    author="輝火雲管家·賈維斯",
    doc_format="auto",            # 12 類規範名 / 'auto'
)

# PDF
from create_pdf_doc import create_pdf_doc
create_pdf_doc(output_path="文件.pdf", title="...", content=md_text,
               doc_format="商業計劃書")

# Word → PDF
from word_to_pdf import convert_to_pdf
ok, path = convert_to_pdf("方案.docx", "方案.pdf",
                          backend="auto", keep_fonts=True)

缺公司資訊時三個入口都拋 RuntimeError，message 是結構化 JSON，Claude 據此觸發補錄。

八、觸發詞

通用：寫 word / 寫 PDF / 寫文件 / 生成 word / 生成 PDF / 建立文件 / 匯出文件 / Word 轉 PDF。

39 類規範觸發詞由 §二 表格中"觸發關鍵詞"列定義。常用：寫合同 / 寫協議 / 寫勞動合同 / 寫服務合同 / 寫技術開發合同 / 寫銷售合同 / 寫採購合同 / 寫 NDA / 寫保密協議 / 寫戰略合作協議 / 寫方案 / 寫報告 / 寫會議紀要 / 寫需求文件 / 寫 PRD / 寫商業計劃書 / 寫 BP / 寫使用者手冊 / 寫培訓手冊 / 寫招標書 / 寫投標書 / 寫演講稿 / 寫研究報告 / 寫白皮書 / 寫驗收單 / 寫立項書 / 寫 SOP / 寫公司制度 / 寫公函 / 寫邀請函 / 寫簡歷 / 寫 CV / 寫報價單 / 寫新聞稿 / 寫復盤 / 寫測試報告 / 寫故障報告 / 寫 postmortem / 寫任命書 / 寫應急預案 / 寫在職證明 / 寫風險評估 / 寫專案計劃書 / 寫專案結項報告 / 寫 API 文件 / 寫部署文件 / 寫 runbook / 寫備忘錄 / 寫 MOU。

九、目錄結構

scripts/
├── doc_core.py          # 共享核心：32 類預設 + Block AST 解析 + 內聯 token
│                        # v7.4：再擴 15 類預設 + 關鍵詞優先順序調整
│                        # v7.3：FormatPreset 增 4 個文件殼開關
├── company-info.py      # 本地公司資訊讀寫 + Odoo 回落
├── create-word-doc.py   # Word 渲染（python-docx + 強制 OOXML jc）
│                        # v7.3：_strip_markdown_emphasis + _maybe_dedupe_h1_title
├── create-pdf-doc.py    # 原生 PDF 渲染（reportlab + NumberedCanvas）
│                        # v7.3：與 Word 端文件殼邏輯保持一致
└── word-to-pdf.py       # Word → PDF 多後端轉換

templates/               # v7.4：15 份可直接複製改寫的 markdown 範本
├── 個人簡歷.md
├── 報價單.md
├── 新聞稿.md
├── 復盤報告.md
├── 測試報告.md
├── 故障報告.md
├── 任命書.md
├── 應急預案.md
├── 在職證明.md
├── 風險評估報告.md
├── 專案計劃書.md
├── 專案結項報告.md
├── API文件.md
├── 部署文件.md
├── 備忘錄.md
└── README.md

十一、未來路線（已調研、未實施）

任何一項觸發剛需時再上；當前以穩定 + 中文友好 + 易維護為先。

十、版本歷史

詳細版本歷史見 git log。當前主要里程碑： - v7.8.6（最新）：Word emoji 亂碼修復 — markdown 內含 emoji(🎂🚗💰🦞✅⭐🇨🇳 等)生成 docx 後,在 WPS / LibreOffice / Linux Word 渲染時顯示 ▢▢ 佔位方塊。根因:_set_font 把 ascii/hAnsi/eastAsia 三個 slot 都設為中文字型(PingFang/宋體/黑體),中文字型不含 emoji glyph 就 fallback 到方塊。修復:(1)_set_font 加 w:cs slot 指向 Segoe UI Emoji 兜底;(2)新增 _add_run emoji-aware 包裝,內部按 _EMOJI_RE 正則把 emoji 字元切到獨立 run + 用 emoji 字型;(3)render_inline 改用 _add_run 覆蓋所有 markdown 內聯文本(bold/italic/code/text)。Mac/Linux 系統會自動 fallback 到 Apple Color Emoji / Noto Color Emoji。 - v7.8.x：PDF 渲染保真度 — 字型 subface 修正 / leading 係數 / firstLineIndent 字元化 / LibreOffice filter 加固 / 平臺感知後端優先順序（詳見上方〇章節） - v7.5–v7.6：39 類規範 + 合同細分 7 類 + KV 後設資料歸併 / TOC 佔位回填 / PDF outline 修復 - v7.0–v7.4：原生 PDF 直出（create-pdf-doc.py）+ 27→39 類擴張 + Pygments 程式碼高亮 + CJK 段落 OOXML 直寫 - v6.x：Block AST 重寫 / 頁首恆含 LOGO / 頁尾欄位碼 - v5.x：多規範自動識別骨架 + company-info.py

技術支援： 青島火一五資訊科技有限公司

這個 Skill 質量不錯，能生成 Word 和 PDF 格式的企業文件，支援勞動合同、銷售合同、專案報告等 39 種常見文件型別，還有 22 份現成的模板可以直接修改使用，對中文辦公場景支援較好。缺點是需要安裝 Python 依賴庫，配置稍顯複雜；部分功能（如公司資訊記憶）可能在共享電腦上留下資料。普通使用者使用時注意確認公司資訊配置是否正確。總體適合需要頻繁起草商務文件的使用者。