前言¶
售前、交付或內部立項時，經常要在短時間內交出一份章節完整、格式像樣的技術方案。手寫往往卡在結構不統一、架構圖和表格反覆改、最後還要按公文樣式排 Word。通用對話式提示詞能寫出片段，但很難穩定覆蓋十五個章節，也未必能落到可下載的 .docx。
下面介紹 SkillHub 上的「解決方案專家」（@user_b7657b26/solution-cgl）。它用標準 SKILL.md 約定輸入、章節骨架和 Word 轉換優先級，讓 Agent 按同一套流程生成方案並儘量輸出政府文檔風格的 Word 文件。
這是什麼¶
「解決方案專家」是社區來源（community）的 Agent Skill，座標 @user_b7657b26/solution-cgl，當前版本 1.0.5，分類爲 business-ops，發佈者爲 user_b7657b26。SkillHub 頁面標註 requires_api_key=false，安裝後無需單獨配置 API Key。
技能包內的 SKILL.md 標題爲「技術方案編寫技能」。定位可以概括爲：
- 輸入：需求文檔（經
parse_file解析）或用戶的自然語言描述。 - 輸出：以 15 個章節爲主線的技術方案，並優先交付 Word（完整版約 50–80 頁量級，精簡版約 15–25 頁），而不是隻給 Markdown。
官方入口：
- SkillHub 展示頁：https://www.skillhub.cn/skills/user_b7657b26/solution-cgl
- API 座標頁：https://api.skillhub.cn/user_b7657b26/solution-cgl
（截至資料抓取時，SkillHub 顯示評分 100000、下載 1539、安裝 15。）
核心功能¶
以下能力均來自技能包 SKILL.md 與目錄結構，可按安裝後的文件自行覈對。
雙版本輸出¶
| 版本 | 章節 | 適用場景 | 頁數（技能內說明） |
|---|---|---|---|
| 完整版 | 15 章全部 | 投標、正式評審 | 50–80 頁 |
| 精簡版 | 1–4、5、8、11、14 等 8 塊內容 | 彙報、快速預覽 | 15–25 頁 |
生成時可在對話中指定版本，例如「生成精簡版技術方案」。
固定執行流程¶
- 解析需求（文檔或描述，信息不足時使用
[xxx]佔位）。 - 按章節模板生成方案正文（項目概述、需求分析、總體架構、技術選型、功能模塊、數據與安全、部署與接口、性能、實施與運維、預算、風險、附錄等）。
- 必須將 Markdown 轉爲 Word，並按優先級嘗試轉換方式。
- 返回 Word 路徑供下載（技能要求格式類似
[技術方案_xxx.docx](computer://路徑)）。
內容與版式約束¶
- 正文以段落爲主，表格僅用於對比、清單、配置等場景。
- 架構與流程默認提供 ASCII 圖，並可選附帶 Mermaid；若環境有
drawio-generator技能且用戶要求可編輯圖，可嘗試生成.drawio，否則降級爲 ASCII + Mermaid。 - 預算金額使用佔位符
[xxx萬元]，不編造具體數字；技能內附有小型/中型項目費用參考區間表，並註明以市場/招標爲準。 - Word 需符合技能內「政府文檔」字體字號表（如標題黑體、正文宋體、頁邊距與行距等），推薦通過
references/政府文檔模板.docx做 pandoc 引用。
附帶資源與腳本¶
安裝目錄通常包含：
references/模板.md、references/模板-精簡版.md：章節框架。references/示例-*.md：完整示例（用於對齊文風與深度）。scripts/md_to_docx.py、scripts/check.py等：Markdown 轉 Word 與檢查輔助。
安裝與啓用¶
SkillHub 官方安裝說明見：https://skillhub.cn/install/skillhub.md
1. 檢查或安裝 SkillHub CLI¶
command -v skillhub && skillhub --version
未安裝時可執行完整安裝（CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅需 CLI 時：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安裝本 Skill¶
安裝時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 可能無法被識別。
skillhub search solution-cgl
skillhub install solution-cgl --namespace user_b7657b26 --dir <你的 skills 目錄>
也可讓 Agent 按安裝文檔執行：根據 https://skillhub.cn/install/skillhub.md 安裝 @user_b7657b26/solution-cgl。
常用客戶端 skills 路徑（來自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下.agents/skills/
安裝後按你所用客戶端要求刷新或重啓 Agent，使技能被加載。
3. 運行環境（Word 轉換）¶
技能要求最終交付 Word。轉換優先級爲：
- pandoc（推薦，引用政府模板）
- 系統預置的 docx 技能（
skill_load("docx")） python scripts/md_to_docx.py（依賴 python-docx）
若三者均不可用，技能允許降級爲僅輸出 Markdown，並明確告知用戶當前環境無法自動轉 Word。
典型用法¶
從需求文檔生成完整版¶
- 將需求文檔放在 Agent 可讀路徑，並說明項目名稱與交付格式要求。
- 觸發技能後，Agent 應解析文檔並生成 15 章 Markdown，再執行 Word 轉換。
pandoc 示例（路徑以你本地生成文件爲準）：
pandoc 技術方案.md -o 技術方案.docx --reference-doc=references/政府文檔模板.docx
- 在對話中獲取
.docx下載路徑；技能建議的目錄形態爲：技術方案/[項目名稱]/技術方案_[項目名稱]_[日期].docx。
快速彙報用精簡版¶
在需求描述中寫明「生成精簡版技術方案」。技能會只保留精簡版所列章節（概述、需求、架構、選型、功能模塊簡化、部署、實施里程碑、風險等），頁數目標在技能內爲 15–25 頁。
質量自檢¶
生成後技能自帶檢查項，例如：15 章是否齊全、各章是否有實質內容、架構圖是否可讀、預算是否爲佔位符、技術選型是否與項目類型一致。Word 轉換後還需覈對標題/正文字體與表格邊框是否符合政府文檔表。
適用場景與注意¶
適合誰
- 需要反覆產出結構化技術方案的售前、解決方案、項目經理或研發負責人。
- 輸入以需求說明、招標文件摘錄或會議紀要爲主，希望 Agent 按統一目錄寫滿再出 Word。
- 政企或類似場景，需要接近公文排版的 Word，而不是純聊天裏的 Markdown。
限制與注意
- 技能強調必須嘗試 Word 輸出；本機未裝 pandoc、無 docx 技能、又無 python-docx 時，只能得到 Markdown 降級結果。
- 預算、部分量化指標依賴佔位或參考區間，不能當作真實報價；正式投標前仍需人工審覈與補數。
drawio-generator、全局docx技能是否可用取決於你當前 Agent 環境，技能已寫明降級策略。- 社區 Skill，能力邊界以包內
SKILL.md與references/爲準；SkillHub 公開展示頁未展開長文說明時，應以安裝後的文件爲權威。
結尾¶
「解決方案專家」把「解析需求 → 十五章（或精簡八塊）→ Word 政府文檔樣式 → 可下載路徑」寫成固定流水線，適合把技術方案寫作從即興對話改成可重複執行的 Skill 工作流。無需 API Key，通過 SkillHub CLI 安裝到對應 Agent 的 skills 目錄即可使用。
官方地址：https://www.skillhub.cn/skills/user_b7657b26/solution-cgl
