前言¶
投標準備裏，格式往往和正文一樣費時間：封面要不要標【正本】、標題用哪套多級編號、頁腳是不是「X/100」、章節是否必須跟招標文件的「投標文件格式」一章對齊。手工在 Word 裏搭樣式和目錄，容易漏項，也容易和本次招標的格式要求不一致。
下面介紹 SkillHub 上的 Agent Skill「投標文件編制專家」。它把「讀招標格式 → 定編號與版式 → 出 docx 骨架」收成一條可複用的工作流，由 Agent 按 SKILL.md 引導執行，並附帶解析 docx 與生成文檔的腳本。
這是什麼¶
「投標文件編制專家」是面向通用投標文件格式排版的 Skill，座標爲 @user_010a3d49/bid-format-template，當前版本 v1.0.0，來源爲 SkillHub community，分類 office-efficiency（頁面展示爲「文檔處理」）。發佈者爲 user_010a3d49。官方條目地址：
- API 座標頁：https://api.skillhub.cn/user_010a3d49/bid-format-template
- SkillHub 展示頁：https://www.skillhub.cn/skills/user_010a3d49/bid-format-template
簡介說明：按招標文件格式要求自動生成投標文件框架；技能不包含任何公司專屬信息，可自由分享和使用。標籤 requires_api_key=false，安裝與使用不依賴 API Key。
核心功能¶
以下能力均來自官方 SKILL.md 與 SkillHub 簡介，可按需組合使用。
解析招標文件 docx¶
上傳或指定招標文件的 .docx，用腳本提取章節結構、頁面設置、字體信息，並推斷編號體系，輸出 JSON 配置供後續生成使用。
四套標題編號體系¶
| 體系 | 說明 |
|---|---|
| 體系一 | 純阿拉伯數字級聯（默認）：1 → 1.1 → 1.1.1 … |
| 體系二 | 阿拉伯數字 + 符號轉換：末級可爲 (1)、① 等 |
| 體系三 | 政府/事業單位：一 → （一） → 1 → （1） → ① |
| 體系四 | 工程類：第一章 → 第一節 → 一、 → （一） → 1. |
各級標題字體、字號、加粗可在生成前按 Skill 說明逐級調整（默認以宋體爲主）。
版式與封面、頁腳¶
生成結果面向常見投標排版習慣，包括：A4、約 2.5 cm 邊距、正文小四與 1.5 倍行距、目錄 TOC 域、封面右上角 【正本】（或副本標記）、頁腳 X/100（首頁不顯示、從第二頁起編頁碼等規則見 Skill 內 references/formatting.md）。
項目信息與章節來源¶
支持填寫項目名稱、代理編號、投標人、招標人、自定義項目編號（按招標文件封面格式）、日期等。章節結構可來自：解析招標 docx（推薦）、手動輸入 H1–H5 列表，或使用默認 14 章框架。
附帶腳本¶
Skill 包內包含 parse_bidding_docx.py、generate_bid_template.js、fix_xml.py 等，用於解析、生成 docx，以及修復 docx-js 9.6.1 的已知 XML 問題。
安裝與啓用¶
Skill 基於通用 SKILL.md 格式。SkillHub 頁面提供三種常見入口，可按環境選擇。
方式一：讓 Agent 按官方說明安裝（推薦）¶
將下面提示詞發給支持 Skill 的 AI（Cursor、Claude Code、Codex CLI 等），由 Agent 讀取安裝文檔並安裝到當前環境的 skills 目錄：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_010a3d49/bid-format-template`。
安裝文檔要求：使用 skillhub install 時必須加 --dir，指向當前 Agent 實際使用的 skills 目錄，否則默認裝到 ./skills/ 可能無法被識別。
SkillHub 文檔中的常用路徑示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
若本機尚未安裝 SkillHub CLI，可先執行（來自 https://skillhub.cn/install/skillhub.md）：
command -v skillhub && skillhub --version
未安裝時可用完整安裝腳本（CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝技能示例（將 <skills 目錄> 換成上面對應路徑）：
skillhub install user_010a3d49/bid-format-template --dir <skills 目錄>
方式二：下載 Zip¶
在 SkillHub 技能頁使用「下載 Zip 包安裝」，將包解壓到 Agent 的 skills 目錄（與上述 --dir 目標一致）。包內包含 SKILL.md 與 scripts/、references/。
方式三：WorkBuddy¶
SkillHub 頁面標註該 Skill 支持 WorkBuddy；WorkBuddy 的 skills 路徑在官方安裝文檔中記爲 ~/.workbuddy/skills/（若你使用 WorkBuddy，按其產品說明放置即可）。
安裝或解壓後，在對話中說明要編制投標文件、並提供招標 docx 或章節列表，Agent 會按 Skill 中的五步流程引導確認後再生成。
典型用法¶
典型流程與官方 SKILL.md 一致：先定章節 → 選編號與字體 → 填項目信息 → 生成 docx → 再填正文。
1. 解析招標文件¶
在 Skill 目錄下執行（將路徑換成你的招標文件）：
python scripts/parse_bidding_docx.py 招標文件.docx --output config.json
輸出含章節結構、檢測到的編號體系、頁面與字體信息。解析結果應在生成前由用戶確認或編輯。
2. 生成投標文件骨架¶
使用配置文件生成（需本機已安裝 Node，並按 Skill 說明配置 NODE_PATH）：
NODE_PATH=$(npm root -g) node scripts/generate_bid_template.js --config config.json --out 投標文件.docx
也可在 Node 中調用 generateBidDocument，傳入 numbering（如 scheme1）、project（含 customNo、copyMark: '【正本】' 等）、fonts、chapters 等字段；完整字段示例見 Skill 內「完整使用示例」。
3. 修復 docx XML（按需）¶
若使用 docx-js 9.6.1 生成後出現兼容問題，可執行：
python scripts/fix_xml.py 投標文件.docx
4. 與 Agent 協作¶
不跑腳本時，也可在啓用該 Skill 的對話中上傳招標 docx，讓 Agent 按 Skill 流程選擇編號體系、確認章節與項目信息後調用生成邏輯；正文、資質、報價等仍需自行或藉助其他知識庫技能填寫（Skill 中 Step 5 提到可結合「標書內容生成技能」）。
適用場景與注意¶
適合誰
- 經常投標、需要快速搭出與招標格式一致的 Word 骨架的團隊或個人。
- 已有招標文件的 docx，希望自動對齊「投標文件格式」章節結構。
- 需要在多套編號體系（政府、工程、純數字級聯等）之間切換，並統一封面、目錄、頁腳規則。
限制與注意
- 招標件爲 PDF 時，Skill 說明寫明無法自動解析，需手動輸入章節或選用默認框架。
- 技能不提供公司資質、案例、人員、報價等內容，僅解決格式與結構。
- 生成依賴 Skill 包內的 Python / Node 腳本與環境；首次使用建議在副本上驗證版式是否滿足本次招標文件的特殊要求。
- 平臺側面對該包做過安全掃描（SkillHub 頁展示科恩實驗室、雲鼎實驗室「安全，無風險」報告入口），仍建議只從官方 SkillHub 渠道獲取安裝包。
結尾¶
「投標文件編制專家」把投標 Word 的共性排版（編號體系、封面【正本】、X/100 頁腳、目錄與章節骨架）固化成可安裝的 Agent Skill，並支持從招標 docx 抽取結構，減少重複搭模板的時間。需要安裝或查看更新時，以 SkillHub 官方頁爲準：
https://www.skillhub.cn/skills/user_010a3d49/bid-format-template
