documentation-standards

documentation-standards 技能為 PRPM 生態系統內的儲存庫技術資訊管理提供了全面的架構。它為文件放置建立了清晰的分類法，將內容區分為開發專用指南、使用者教學以及 AI 代理的專業知識庫。遵循這些標準，貢獻者和自動化系統可以可預測地定位資訊，減少上下文切換並提高 AI 輔助編碼作業的可靠性。此技能作為儲存庫維護、文件版本控制和生命週期管理的結構化參考。

• 將文件分類為內部 (development/docs/)、使用者導向 (docs/)、專案層級 (root) 以及 AI 專用 (.claude/skills/) 目錄，實現直覺式導航。

• 定義明確的 Markdown 結構要求，包括前言使用、標題層級 (H1-H3)、長篇文章目錄及標準化的代碼區塊格式。

• 提供遷移檢查清單，確保在文件重組期間的連結完整性和儲存庫健康度，並包含使用 markdown-link-check 進行自動連結檢查。

• 強制執行套件專屬的 README 結構，以促進個別套件目錄內的 API 參考、使用教學與 CLI 指令文件。

• 整合 TypeDoc、VitePress 和 Docusaurus 等自動化文件工具，支援未來的靜態網站生成與多格式輸出。

• 使用相對路徑強制執行交叉引用規範，確保內部開發資源與外部使用者指南之間的導航連結保持穩固。

• 專為 PRPM 貢獻者、維護者、套件作者以及在儲存庫中運作的 AI 代理設計。

• 提供新增、棄用與審查文件的最佳實踐，確保資訊隨著專案演進保持準確與關聯性。

• 透過 markdownlint 支援自動化 lint 工作流程，以維護風格一致性並防止格式回歸。

• 非常適合管理多套件儲存庫的複雜性，解決技術債通常表現為無組織或過時的文件之問題。

• 鼓勵進行季度審查並系統性更新 CHANGELOG.md，確保所有功能新增與專案里程碑皆能妥善記錄。