SuperAPI AI 工具集

biome

通用与其它

查看项目

更新于 10-16 09:29

技能介绍

biome 是一个母技能(mother skill),用于定义什么是 BIOME:生态系统中一个有边界的区域,拥有自己的居民与气候,并与姊妹区域沿既定网关交换物质、能量与信息。平台描述类的 daughter skill 通过在其 CARD.yml、GLANCE.yml 或 SKILL.md frontmatter 中声明 inherits: biome 来继承本技能,其目录结构也镜像本技能定义的骨架。

用途:为一个有边界的基础设施面(云 VM、本地硬件、CI runner、镜像源、身份或网络平面等)编码运维知识。并非所有技能都是 biome;流程技能、工作负载技能与元技能(如 skill、card、cauldron、schema、file-system-object)不属于 biome。

主要能力与结构:每个 biome 必须包含 GLANCE.yml(50-100 行)、CARD.yml(150-300 行,声明 inherits: [biome])、SKILL.md(300-500 行)、README.md(50-80 行)。标准子目录包括 recipes/(可运行命令)、instances/(按部署的知识)、runbooks/(端到端流程)、gotchas/(已知故障模式)、protocols/(机制与不变量)、scripts/、cost/(带日期的账单分析);云类 biome 另有 quota/、regions/;边缘类另有 stacks/、templates/。可选的 cli_tools: 块列出 gcloud、az、aws、gh 等命令及其角色、安装与认证方式。跨多个 biome 使用的工具应记录在消费方仓库的 biomes/gateways.yml 中,kind 为 shared_cli_tool。

使用方式:消费方仓库采用本技能后,填充自己的 biomes/registry.yml、biomes/gateways.yml 及各自的 per-biome daughter skill;可 fork 示例存根并用站点专属内容扩展,或编写继承自存根的轻量叠加技能。新增 biome 可从 templates/BIOME/ 脚手架实例化。本技能附带的六个示例 biome(gcp、aws、azure、github、tailscale、cloudflare)是厂商中立的参考资料,不是可用注册表。

适用场景:跨 biome 的交换、共生、迁移、气候(各自速率常数)与生态位(各支持其他 biome 不支持的工作负载)等运维知识的结构化记录。

限制:本技能为骨架与约定定义,具体部署内容需由消费方填充;资料未提供官方安装命令、收费、价格或性能数据。