sindri-extension-guide

此技能作為開發者的權威助手，專門用於構建 Sindri 雲端開發環境系統的宣告式擴充功能。它簡化了擴充功能的創建、驗證與註冊表維護流程。無論您是定義核心系統組件、Node.js 或 Python 等程式語言執行環境，還是複雜的基礎設施工具，本指南都能確保您的 YAML 定義符合正確的架構規範。此工具旨在協助工程師與平台架構師，在多種雲端供應商（包括本地 Docker、Fly.io 以及透過 DevPod 的 Kubernetes 工作流程）之間部署一致且可重現的開發環境。

本助手提供關於 Sindri 擴充架構的深入技術見解，包含近期新增的功能系統。這支援了進階整合場景，如專案初始化（project-init）、多重認證方法（API 金鑰與 CLI 認證）、安裝前後的生命週期勾子（hooks），以及 Model Context Protocol (MCP) 伺服器註冊。透過遵循本指南，使用者可確保其擴充功能被正確分類、列入目錄中，並通過嚴格的架構驗證。

• 提供關於 extension.yaml 結構、元數據定義與依賴關係管理的專業指引。

• 使用專用斜線指令實現擴充功能創建與文件更新的自動化流程。

• 提供針對 mise、apt 與二進制安裝方法的詳細整合說明。

• 支援實作生命週期勾子與 MCP 等進階擴充功能能力的技術指導。

• 維護架構驗證與註冊表更新規範，確保專案層級的一致性。

• 務必遵循建議的目錄結構 (v2/docker/lib/extensions/{name}/) 以確保相容性。

• 利用 /extension/new 與 /extension/update-docs 等指令來保持程式碼與文件的同步。

• 清楚區分標準擴充功能與需要選擇性功能系統的進階擴充功能。

• 確保所有新擴充功能皆在主 registry.yaml 中註冊並分類正確，以利於發現。

• 輸入內容通常包含擴充功能元數據、配置需求與安裝指令碼，輸出為經過完全驗證、可部署的環境模組。