前言¶
改完功能再補文檔，往往靠記憶和自覺：哪些頁面受影響、API 參考要不要改、PR 裏有沒有漏掉 docs/ 下的 MDX，審查時很難系統化覈對。手工對照 diff 掃目錄，既慢又容易漏。
下面介紹 SkillHub 上的「技術文檔更新」（@user_e40a4360/documentation-updater）。它是一套面向 Next.js 項目文檔的引導式工作流，根據源代碼變更去分析、更新或新建文檔，並把 PR 階段的文檔完整性檢查拆成可重複執行的步驟，而不是每次從零想 checklist。
這是什麼¶
「技術文檔更新」是社區來源（community）的 Agent Skill，座標 @user_e40a4360/documentation-updater，當前版本 1.0.0，分類爲 knowledge-management，由發佈者 user_e40a4360（SkillHub 頁面展示作者爲踏山河）維護。Skill 採用通用的 SKILL.md 格式，不需要 API Key（requires_api_key=false）。
定位可以概括爲：在 Next.js 文檔倉庫裏，用標準化引導把「代碼改了什麼」映射到「文檔該動哪裏」，減少代碼與 docs/、MDX、API 參考之間的漂移。
核心功能¶
依據官方簡介，已覈實的能力包括：
- 變更驅動的文檔分析：根據源代碼變更，判斷需要更新或新建的文檔範圍。
- 引導式工作流：通過一系列標準化步驟規範文檔修改過程，而不是一次性自由發揮。
- PR 文檔完整性：面向 Pull Request 審查場景，用於檢查本次改動是否配套了應有的文檔更新。
- Next.js 文檔語境：工作流針對 Next.js 項目文檔結構，簡介中明確關聯
docs/、docs/01-app、docs/02-pages、.mdx、MDX、API reference等路徑與形式。
Agent 在以下意圖下應啓用該 Skill（原文觸發表述，便於你對照使用）：
- 用戶要求 update documentation for my changes、check docs for this PR、what docs need updating、sync docs with code、scaffold docs for this feature、document this feature、review docs completeness、add docs for this change、what documentation is affected、docs impact；
- 或對話中出現
docs/、docs/01-app、docs/02-pages、MDX、documentation update、API reference、.mdx files等關鍵詞。
安裝與啓用¶
SkillHub 頁面給出的安裝方式是：讓 AI 參照官方安裝說明，安裝座標 @user_e40a4360/documentation-updater。安裝文檔地址爲 SkillHub 安裝與優先源配置。
先做環境檢查，再安裝 Skill 到當前 Agent 能識別的 skills 目錄（安裝時必須指定 --dir，否則默認落在 ./skills/ 且可能不被識別）。
command -v skillhub && skillhub --version
若未安裝 CLI，可使用安裝文檔中的完整安裝命令：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝本 Skill 時，將 <skills 目錄> 換成你當前客戶端使用的路徑。安裝文檔中列出的常見路徑包括：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
示例（目錄需按你的環境替換）：
skillhub install @user_e40a4360/documentation-updater --dir ~/.cursor/skills/
也可在對話中直接發送 SkillHub 頁面提供的提示詞，讓 AI 按 skillhub.md 完成安裝，效果等價於上述流程。
典型用法¶
公開資料未附帶固定 CLI 子命令；使用方式是在已安裝 Skill 的 Agent 裏，用自然語言描述本次代碼變更或 PR 目標，並點明文檔同步需求。下列表述與官方簡介中的觸發場景一致，可直接複用或改寫：
我這次 PR 改了 App Router 下的配置行爲，請 check docs for this PR，列出 docs/01-app 裏哪些 .mdx 需要更新。
sync docs with code：根據當前分支相對 main 的改動，說明 what documentation is affected，並 scaffold docs for this feature 的草稿結構。
review docs completeness：這次變更是否缺少 API reference 或 docs/02-pages 下的對應頁面？
經過上面的步驟，Agent 會按 SKILL.md 中的引導式工作流推進：從變更範圍推導文檔影響面，再組織更新或新建文檔，而不是隻給泛泛的寫作建議。
適用場景與注意¶
適合誰
- 維護 Next.js 官方風格或類似結構的文檔站（
docs/分區、MDX、API 參考並存）的開發者與文檔貢獻者。 - 在 PR 審查中需要可重複的「文檔是否跟代碼一起變」檢查清單的團隊。
限制與注意
- 工作流面向 Next.js 項目文檔；非 Next.js 或文檔目錄命名完全不同的倉庫，觸發詞裏的路徑（如
docs/01-app）可能不完全匹配，需自行說明實際目錄結構。 - 評分 100000、下載 1401、安裝 2 等數據來自 SkillHub 頁面統計，僅作選用參考，不代表與你本地倉庫的兼容結論。
- 文檔內容質量仍取決於變更說明是否清晰、倉庫內現有 MDX 約定是否一致；Skill 規範的是過程與檢查維度，不能替代人工對技術準確性的終審。
結尾¶
若你經常在 PR 裏追問「文檔改了嗎、改全了嗎」，「技術文檔更新」把 Next.js 文檔同步收成一條可重複的引導式路徑，並與 docs/、MDX、API 參考等常見觸點對齊。安裝與詳情見 SkillHub：
- 頁面：https://www.skillhub.cn/skills/user_e40a4360/documentation-updater
- API 入口：https://api.skillhub.cn/user_e40a4360/documentation-updater
