前言¶
在 Cursor、Claude Code 等環境裏寫文檔，常見做法是每次在對話裏重複說明章節結構、標題層級和輸出格式。同類內容換一篇報告或 Brief，又要從頭描述一遍。若希望 Agent 按固定骨架輸出 Markdown，並能在 Typora、GitHub 或導出 PDF 時少改格式，需要一個專門約束「文檔形態」的 Skill。下面介紹 SkillHub 上的 結構化 Markdown 文檔生成器（座標 @user_d82fedf3/document-engine），它把「通用文檔生成」收斂成可安裝的 Skill 能力。
這是什麼¶
結構化 Markdown 文檔生成器是社區發佈的辦公效率類 Skill（分類 office-efficiency，版本 1.0.0）。發佈者爲 user_d82fedf3，SkillHub 頁面標註作者爲 EastSeaO。官方簡介概括爲：通用文檔生成引擎，支持報告、分析、SOP、Brief 等結構化 Markdown 輸出，並聲明兼容 Typora、GitHub 與 PDF 等常見渲染/導出路徑。
該 Skill 基於通用 SKILL.md 格式分發；標籤標明 requires_api_key=false，即不依賴額外 API Key 即可使用（以 SkillHub 頁面信息爲準）。
核心功能¶
以下能力均來自 SkillHub 與預抓取資料，未展開的實現細節以安裝後 Agent 加載的 SKILL.md 爲準。
- 多類文檔模板語義：面向報告、分析、SOP、Brief 等常見辦公文檔，輸出帶結構的 Markdown，而不是零散段落。
- 結構化 Markdown：強調標題層級、章節劃分等可預測結構，便於後續在編輯器或倉庫中維護。
- 輸出環境兼容：官方說明兼容 Typora、GitHub 風格 Markdown 以及 PDF 導出鏈路（具體排版仍取決於本地工具與主題）。
- 無強制 API Key：適合在本地 Agent 環境中直接啓用，無需單獨配置第三方密鑰（見 SkillHub 標籤）。
安裝與啓用¶
SkillHub 推薦兩種方式：讓 AI 按安裝文檔操作，或使用 skillhub CLI 安裝到當前 Agent 的 skills 目錄。
方式一：提示詞安裝（官方頁面原文）¶
將下面提示發給支持 Skill 的 AI，由其按 SkillHub 安裝說明拉取技能：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_d82fedf3/document-engine`。
方式二：CLI 安裝¶
先確認本機是否已有 skillhub：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 安裝文檔執行完整安裝（含 CLI 與默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝技能時必須用 --dir 指向當前 Agent 識別的 skills 目錄；裝到默認 ./skills/ 可能不會被 Agent 加載。常見路徑如下（摘自 SkillHub 安裝文檔）：
| 環境 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
在對應目錄下執行（將 <skills 目錄> 替換爲實際路徑）：
skillhub install user_d82fedf3/document-engine --dir <skills 目錄>
也可先搜索再安裝：
skillhub search document-engine
skillhub install user_d82fedf3/document-engine --dir <skills 目錄>
安裝後按你所用客戶端要求重啓或刷新 Agent，使 Skill 生效。Cursor、Codex CLI、Claude Code 的差異主要體現在 skills 目錄位置，安裝命令本身一致；若某客戶端使用項目級 skills 目錄，將 --dir 指向該項目路徑即可。
典型用法¶
公開頁面未提供逐條複製的官方示例對話。可復現的用法是：在已啓用該 Skill 的 Agent 中，用自然語言說明文檔類型與素材，並明確要求「按結構化 Markdown」輸出。類型與官方簡介對齊，例如：
- 報告 / 分析：給出主題、數據或結論要點，要求分章節（背景、分析、結論等）的 Markdown。
- SOP：給出流程步驟與角色，要求固定章節（目的、範圍、步驟、注意事項等）的 Markdown。
- Brief：給出項目背景與目標受衆，要求短結構（摘要、要點、行動項等）的 Markdown。
生成後可在 Typora 或 GitHub 預覽；需 PDF 時使用本地導出工具，並檢查標題層級是否符合你的模板習慣。
適用場景與注意¶
適合誰：需要反覆讓 Agent 寫同類辦公文檔、又希望 Markdown 結構穩定的一線研發、產品、運營與文檔維護者；分類爲 office-efficiency，側重效率而非代碼倉庫自動化。
社區與版本：來源爲 community，當前頁面版本爲 1.0.0；SkillHub 統計（以預抓取資料爲準）評分 100000，下載 1271 次。頁面數據會更新，以 SkillHub 實時展示爲準。
注意：
- 未在公開資料中承諾的具體章節名、front matter 字段或腳本命令，不應假設存在；複雜格式以安裝後的
SKILL.md爲準。 - PDF 最終效果依賴導出工具與 CSS，Skill 只保證 Markdown 結構化輸出方向。
- 安裝目錄錯誤是常見坑：務必
--dir到當前 Agent 的 skills 路徑。
結尾¶
結構化 Markdown 文檔生成器把「報告、分析、SOP、Brief」等輸出收斂爲可安裝的 Skill，減少每次手寫格式說明的成本，並面向 Typora、GitHub、PDF 等下游場景。官方入口：
- SkillHub 頁面：https://www.skillhub.cn/skills/user_d82fedf3/document-engine
- API 座標頁：https://api.skillhub.cn/user_d82fedf3/document-engine
