SuperAPI AI 工具集

sindri-extension-guide

通用与其它

查看项目

更新于 10-16 03:14

技能介绍

用途:该技能用于指导用户为 Sindri 创建扩展。Sindri 扩展是声明式 YAML 文件而非 bash 脚本,所有配置由 YAML 定义驱动。

主要能力:讲解扩展目录结构(extension.yaml、可选 scripts/、templates/、mise.toml);说明必需段 metadata、install、validate 与可选段 requirements、configure、remove、upgrade、bom、capabilities;介绍多种安装方式(mise、apt、binary、npm、script、hybrid);提供注册表登记、校验与测试命令,以及创建后必须完成的文档更新清单。

使用方式:推荐使用斜杠命令 /extension/new <name> [source] 创建扩展、/extension/update-docs <name> 更新文档。创建后需将扩展加入 v2/docker/lib/registry.yaml,并执行 ./v2/cli/extension-manager validate {name} 校验、./v2/cli/extension-manager install {name} 测试安装。文档需更新 docs/extensions/{NAME}.md 与 v2/docs/EXTENSIONS.md。

能力系统(可选,2026 年 1 月新增):仅面向扩展项目管理功能的扩展,支持 project-init、auth(API key 与 CLI 认证)、hooks(安装与项目初始化前后钩子)、mcp(注册为 Model Context Protocol 服务器)。常规扩展如 nodejs、python、docker 无需 capabilities。

适用场景:语言运行时、开发工具、CLI 工具、复杂混合安装,以及带项目初始化与 MCP 集成的 AI/项目管理类扩展。

限制:资料未提供具体收费、价格、平台支持范围与效果数据;脚本需以 #!/usr/bin/env bash 开头并包含 set -euo pipefail,需可执行;校验失败常见原因包括 YAML 语法、依赖缺失、超时与正则转义。