前言¶
讓 AI 直接寫長文檔時，常見問題是結構跑偏、重點錯位，改稿往往比從零寫還費時間。若能在動筆前先對齊章節與要點，再進入正文，返工會少很多。下面介紹 SkillHub 上的「專家寫作小助手」，它把流程固定爲兩階段：先出結構化大綱供確認，再寫正文。
這是什麼¶
「專家寫作小助手」是面向專業文檔寫作的 Agent Skill，座標爲 @user_8a026320/confirm-expert-writer，當前版本 1.0.2，來源爲 community，分類 content-creation，由發佈者 user_8a026320 維護。
與「一句話讓模型直接生成全文」不同，本技能強調先大綱、後正文，並在確認後支持兩種正文路徑：基於召回的私有化文檔內容撰寫，或直接生成正文。標籤 requires_api_key=false，不依賴額外 API Key 配置。
核心功能¶
已覈實的能力如下：
- 兩階段流程：大綱 → 用戶確認 → 正文，官方表述爲「確保一次寫對」。
- 結構化大綱：先生成可供審閱、修改的提綱，再進入寫作。
- 正文生成方式：確認大綱後，可選用私有化文檔召回結果寫正文，也可不依賴召回直接生成正文。
- 自定義大綱模板：可按團隊或文檔類型約定大綱結構。
- 自然語言觸發：可用「幫我寫個文檔」「生成大綱」「寫方案」「先出大綱」「確認後再寫」等表述喚起技能。
安裝與啓用¶
SkillHub 頁面給出的安裝提示是：讓 AI 按官方安裝文檔執行，並安裝指定座標。
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_8a026320/confirm-expert-writer`。
若本機已安裝 skillhub CLI，可將技能裝到當前 Agent 的 skills 目錄（未指定 --dir 時默認落在 ./skills/，部分客戶端不會自動加載）。通用安裝方式如下。
command -v skillhub && skillhub --version
未安裝 CLI 時，可按 SkillHub 文檔執行完整安裝：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝技能時把 --dir 指向當前環境識別的 skills 目錄，例如：
skillhub install @user_8a026320/confirm-expert-writer --dir ~/.cursor/skills/
其他常見路徑（以 SkillHub 安裝文檔爲準）：Claude Code 爲 ~/.claude/skills/；Codex 爲 ~/.codex/skills/ 或項目下的 .agents/skills/。裝好後按所用客戶端要求刷新或重啓，使 Skill 生效。
典型用法¶
官方未提供獨立示例倉庫；用法可從簡介與觸發詞還原爲可復現的對話流程。
- 在已啓用該 Skill 的 Agent 中，用觸發詞說明任務，例如：「先出大綱，幫我寫個文檔：XXX 技術方案」。
- 審閱模型返回的結構化大綱，提出增刪改，直到結構滿意。
- 明確「確認後再寫」，並說明正文偏好：
- 需要貼合內部資料時，依賴 Agent 側已配置的私有化文檔召回能力；
- 不需要引用私有庫時，可直接要求生成正文。 - 若團隊有固定文檔形態，可在對話中說明或引用自定義大綱模板，再重複步驟 1～3。
全程保持「先對齊結構、再寫全文」，避免在成稿階段大改章節邏輯。
適用場景與注意¶
適合誰
- 需要寫方案、說明、規範類長文檔，且對章節結構有明確要求的開發者或技術寫作者。
- 希望正文與內部知識庫對齊、又願意在大綱階段投入一次確認成本的團隊。
限制與注意
- 私有化正文質量取決於 Agent 的文檔召回與上下文配置，Skill 本身只聲明支持該路徑，不替代知識庫接入工作。
- 評分與下載量以 SkillHub 頁面爲準（資料抓取時：評分 100000，下載 1974）；安裝數在部分統計中爲 0，可能與統計口徑有關，以商店實時數據爲準。
- 技能遵循通用 SKILL.md 格式，行爲以
@user_8a026320/confirm-expert-writer包內說明爲準；升級時注意版本號（當前 1.0.2）。
結尾¶
「專家寫作小助手」把文檔寫作拆成「大綱確認」與「正文生成」兩步，並支持自定義大綱模板與可選的私有化內容召回，適合不想在成稿後推倒重來的寫作場景。
- SkillHub 頁面：https://www.skillhub.cn/skills/user_8a026320/confirm-expert-writer
- API 入口：https://api.skillhub.cn/user_8a026320/confirm-expert-writer
