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 中注册并分类正确，以便于发现。

• 输入内容通常包含扩展元数据、配置需求与安装脚本，输出为经过完全验证、可部署的环境模块。