SuperAPI AI 工具集

integrate-with-gcx

编程与开发

查看项目

更新于 10-15 21:55

技能介绍

用途:在 grafana/gcx 代码库中新增或扩展一项能力,并让编码智能体自主完成从定位到实现、再到评审准备的全过程。该技能没有审批门,仅在仓库证据无法决定时才提问。

主要能力:分为 Place(定位)、Build(构建)、Review(评审)三种模式。Place 阶段先盘点命令树,运行 bin/gcx help-tree、bin/gcx commands --flat -o json、bin/gcx resources list-types、bin/gcx providers list,确定必要性、命令路径、后端与接线、就绪度四项,并以简短要点呈现。就绪度结果中 ready、bounded bootstrap 可继续;backend prerequisite 无可行切片或 not gcx 则终止,不得凭空编造契约或实现。

使用方式:先运行 mise run build,再执行 bin/gcx commands >/dev/null && echo ok,并阅读 AGENTS.md。Build 阶段先覆盖契约(用途、稳定性、输入类型与约束、输出协议类、错误恢复、token 成本、非目标等),再搜索共享实现,例如 grep -rn "LoadContextAndConfig" internal/datasources/query/、grep -rn "func NewClient" internal/query/grafanaquery/、grep -rn "BindListLimit|AttachListMeta" internal/output/、grep -rn "ConfirmDestructive" internal/providers/。提交前格式化并运行门禁:mise exec -- gofmt -w <编辑的 .go 文件>、mise run gate、GCX_AGENT_MODE=false mise run all。

适用场景:为 gcx 添加新叶子命令、扩展已有命令、准备 PR 评审。可交接给 add-provider 或 add-datasource 技能,交接前须先完成契约。

限制:迁移旧 CLI 的 provider 不在本版本范围内,需人工驱动。命令名在主要版本内冻结。部分规则由 CI 强制(如输出类 fixture、token 成本、agent 模式单一 JSON 值),部分仅为约定(如 Args: 校验、llm_hint)。无法本地运行的门禁应报告 SKIPPED 而非通过。资料未提供具体收费、平台或效果信息。