SuperAPI AI 工具集

command-development

编程与开发

查看项目

更新于 11-10 18:22

技能介绍

命令开发是面向 Google Antigravity 的技能,用于创建斜杠命令。斜杠命令是写在 Markdown 文件里的提示词,用户输入 /command-name 时,Antigravity 会按命令内容执行。它适用于把常用提示固化、统一团队工作流、在项目或个人范围内复用复杂指令。

需要特别注意:命令是写给 Antigravity 的指令,不是给用户看的说明。应写成“审查以下代码的安全漏洞……”这类直接指令,而不是“本命令将为你审查代码”这类面向用户的描述。

命令分为三类:项目命令放在 .claude/commands/,在 /help 中标记为 (project);个人命令放在 ~/.gemini/config/commands/,标记为 (user);插件命令放在 plugin-name/commands/,标记为 (plugin-name)。资料还指出 .claude/commands/ 属于旧格式,新技能推荐使用 .agents/skills/<name>/SKILL.md,两者加载方式相同,仅文件布局不同。

文件格式为 .md。基础命令可以不带 frontmatter。可选的 YAML frontmatter 字段有:description(/help 中显示的简述,默认取命令首行);allowed-tools(限定可用工具,如 view_file、run_command(git:*));model(指定 sonnet、opus、haiku 等执行模型);argument-hint(参数提示,利于自动补全);disable-model-invocation(禁止 SlashCommand 工具以编程方式调用,只允许手动触发)。

动态参数方面:$ARGUMENTS 捕获全部参数;$1、$2、$3 捕获位置参数;两者可混用。文件引用使用 @ 语法,例如 @$1 或 @package.json,Antigravity 会在处理命令前读取文件内容。run_command 可在命令内联执行 bash 命令,用于动态收集仓库状态或环境信息,具体语法见 references/plugin-features-reference.md。

组织方式上,小型命令集可用扁平结构;15 个以上或分类清晰时使用子目录命名空间,如 ci/、git/、docs/,在 /help 中显示为 (project:ci) 等命名空间。

最佳实践包括:单一职责;清晰描述;必要时显式声明 allowed-tools;始终提供 argument-hint;使用动词-名词命名;校验参数并处理缺失或非法输入;限定 run_command 范围、避免破坏性操作、保持命令快速;补充用法注释与示例。资料还给出审查、测试、文档生成、PR 工作流等常见模式。

插件命令可访问 ${ANTIGRAVITY_PLUGIN_ROOT},用于可移植地引用插件脚本、配置与模板。命令还能与插件中的代理、技能和钩子协作,组合出多阶段工作流,例如静态分析、深度审查、标准校验、按模板出报告。

排查方面覆盖:命令不出现、参数失效、run_command 执行失败、文件引用无效等常见问题的检查方向。关于收费、价格、平台支持范围等,资料暂未提供。