extension-guide

用途

Sindri Extension Guide 用于引导用户创建 Sindri 扩展。在创建扩展之前，需要先确定目标平台是 V2 还是 V3，然后使用对应的专项技能继续。

版本差异

Sindri 支持 V2（Bash/Docker）和 V3（Rust CLI）两个平台的扩展。两版的主要差异如下：

• 实现：V2 为 Bash（约 52K 行），V3 为 Rust（约 11.2K 行）。
• 扩展目录：V2 为 v2/docker/lib/extensions/，V3 为 v3/extensions/。
• Schema 位置：V2 为 v2/docker/lib/schemas/extension.schema.json，V3 为 v3/schemas/extension.schema.json。
• CLI：V2 为 ./v2/cli/extension-manager，V3 为 sindri extension。
• 安装方式：V2 有 6 种（mise、apt、binary、npm、script、hybrid），V3 有 7 种（新增 npm-global）。
• 分类：V2 有 11 个，V3 有 12 个（分类集合不同）。
• VisionFlow：V2 支持，V3 不可用。

V2 分类：base、agile、language、dev-tools、infrastructure、ai、database、monitoring、mobile、desktop、utilities。

V3 分类：ai-agents、ai-dev、claude、cloud、desktop、devops、documentation、languages、mcp、productivity、research、testing。

何时选择 V2

• 需要 VisionFlow 工作流：vf-* 扩展仅在 V2 中可用。
• 看重经过验证的稳定性：代码库经过实战检验。
• Docker 优先：深度 Docker/容器集成。
• 团队熟悉 Bash：V2 脚本全部为 Bash。

何时选择 V3

• 新项目：采用现代架构。
• 需要 Windows 支持：提供原生 Windows 二进制。
• 追求性能：CLI 操作快 10-50 倍。
• 需要高级冲突处理：针对克隆项目的智能合并策略。
• 需要项目上下文合并：CLAUDE.md 文件管理。

使用方式

创建扩展前，先使用 AskUserQuestion 确定：

1. 目标 Sindri 版本（V2 或 V3）？
2. 扩展的基本信息（名称、分类、用途）。

然后委派给对应的专项技能：

• V2：使用 /extension-guide-v2 技能
• V3：使用 /extension-guide-v3 技能

斜杠命令：

• /extension-guide：本路由（先选择版本）
• /extension-guide-v2：V2 专用扩展指南
• /extension-guide-v3：V3 专用扩展指南

快速决策树：

• 需要 VisionFlow（vf-*）？→ 仅 V2。
• 新的 AI/Claude 工具？→ 推荐 V3（分类更好、冲突处理更强）。
• 语言运行时（Node、Python 等）？→ 两者均可（新项目优先 V3）。
• 需要 Windows 支持？→ 仅 V3。

共享能力

V2 和 V3 都支持用于高级扩展的 capabilities 系统：

• project-init：初始化项目的命令
• auth：API 密钥与 CLI 认证
• hooks：生命周期钩子（安装前/后、项目初始化前/后）
• mcp：Model Context Protocol 服务器注册
• features：高级功能的特性开关

大多数扩展不需要 capabilities，它们面向管理项目设置的扩展（如 Claude Flow、Agentic QE、Spec-Kit）。

限制

资料未提供具体安装命令、价格、平台支持范围之外的细节或效果数据。