SuperAPI AI 工具集

migrate-provider

通用与其它

查看项目

更新于 10-15 21:55

技能介绍

用途:把旧版 grafana-cloud-cli(其二进制也曾名为 gcx)中的资源客户端迁移到本仓库的 gcx provider 体系,包含核心适配器、schema/示例注册、CRUD 重定向命令和附属子命令。该技能由人工驱动,不属于 integrate-with-gcx v1 工作流;构建使用 bin/gcx,旧二进制路径需显式命名。

主要能力与流程:分五个严格顺序阶段,每阶段之间有必须通过的关卡。阶段0自主收集需求,读取旧 CLI 源码、合规文档并选定模式参考,产出上下文包;阶段1交互式设计(1A CLI UX、1B 资源适配器、1C 认证与配置、1D 架构),产出 ADR 并需用户批准;阶段2产出 spec.md、plan.md、tasks.md,plan.md 必须含 HTTP 客户端参考,tasks.md 必须含各输出格式的冒烟测试任务;阶段3由 Build-Core 与 Build-Commands 两个代理按文件所有权分工构建;阶段4执行构建门禁、冒烟测试、适配器冒烟、规格合规检查与 recipe 更新,并产出对比报告。

必要用法:前置条件包括 bin/gcx --version 成功、bin/gcx config view 显示可用上下文、已创建 internal/providers/{name} 目录、具备真实 Grafana 实例用于冒烟测试。构建门禁命令为 GCX_AGENT_MODE=false mise run all。冒烟测试需对每个 show/list 命令测试 -o json、-o table、-o wide、-o yaml 四种格式。

限制:仅注册流程(providers.Register() + TypedRegistrations() 及 TypedCRUD Descriptor/Aliases 字段)已对照当前代码核查,其余步骤未审计,需边做边验证。无真实实例时冒烟测试须标记为 UNVERIFIED,不得声称与旧 CLI 一致。禁止推断响应信封结构,反序列化代码须逐字复制旧 CLI 源码。不适用于从零构建 provider(应使用 /add-provider)。