docs-write

此技能提供了一套完整的框架，用於創建、組織和維護面向開發者的技術文件。它確保專案遵循一致的結構，使開發者能夠更輕鬆地瀏覽、貢獻並理解複雜的程式碼庫。透過為專案目錄佈局（包括架構決策紀錄 ADR、API 規範、CLI 指令參考及開發工作流）建立明確標準，該技能為維護者和新進貢獻者創造了一個可預測的工作環境。

• 標準化專案根目錄文件（如 README.md、CONTRIBUTING.md 和 CHANGELOG.md），提供清晰的入門路徑。

• 實施分層文件架構，重點關注 TypeScript 型別定義、行內 JSDoc/TSDoc 註釋以及結構化的 /docs 資料夾。

• 定義 README 專用模板，確保功能介紹、安裝步驟與快速啟動指南易於掃描與操作。

• 包含嚴格的 CLI 文件標準，如語法概述、參數說明、選項配置及錯誤處理範例。

• 明確區分 README 內容（快速啟動）與深入文件（架構、API、教學指南）。

• 利用穩定的成熟度標籤（Stable/Active/Early）來釐清不同元件、套件或系統的狀態。

• 專為技術團隊、開源維護者及重視可維護性的內部專案開發者設計。

• 最適合用於初始化新儲存庫、重構過時文件，或在組織內實施一致的專案標準。

• 建議搭配 internal:styleguide 技能以確保文風與語調一致，並配合 internal:voice 進行哲學導向的審查。

• 預期輸入包括專案結構目標、架構決策與 API 元數據。輸出為結構嚴謹、專業且易於存取的文件，作為專案的單一事實來源。