confluence-docs

Confluence Docs 技能為 AI 驅動的開發環境提供了一套結構化的技術文件管理框架。專為開發人員、架構師與技術撰稿人設計，此技能透過強制執行架構決策記錄 (ADR)、營運手冊、系統架構規範與知識移轉 (KT) 文件等標準化模板，確保專案文件的一致性。透過集中化文件模式，幫助團隊在技術審查與系統交接過程中保持清晰的歷史背景與營運可視性，有效降低認知負荷。

• 提供標準化的 ADR 模板，包含決策背景、決策理由、實作說明與影響分析，利於長期架構追蹤。

• 具備營運手冊模板，涵蓋先決條件、步驟程序、驗證方式、回滾策略與疑難排解流程。

• 系統架構文件模式，捕獲高階概覽、組件依賴關係、安全性、效能考量與監控可觀測性指標。

• 針對與工單綁定的知識移轉 (KT) 格式，促進複雜實作任務後的背景知識分享。

• 內建文件檢查清單，確保內容品質、正確的標題層級、代碼區塊一致性，並排除敏感安全資料。

• 當啟動新的設計決策、記錄基礎設施服務或完成開發功能時，應啟用此技能。

• 文件輸出會自動分配至特定目錄，例如 docs/adr/、docs/runbooks/、docs/architecture/ 與 docs/agent-outputs/technical-docs/。

• 檔案必須遵循定義的命名慣例（如 ADR-XXX-{description}.md 或 KT-{{TICKET_PREFIX}}-XXX-{topic}.md），以確保系統可發現性。

• 必須遵守所提供的格式與規範，包括 H1-H3 標題層級及 Markdown lint 檢查，以維護專案標準。

• 確保所有架構變更均有對應的 ADR 支援，為數據存取模式、CI 基礎設施或安全性實作等系統級變更提供審計追蹤。