SuperAPI AI 工具集

quickstart

编程与开发

查看项目

更新于 10-14 20:20

技能介绍

用途

quickstart 是 AgentOps 的入门技能,只承担一项任务:告诉新用户 AgentOps 是什么,以及第一步该做什么,并且要求尽快完成。技能规范明确要求必须执行工作流本身,而不是只描述它。

主要能力

工作流分为三步:

  1. 检测环境配置:通过一组命令检测当前状态,输出 GIT、AO、BD、AGENTS、GLOBAL_AGENTS、CODEX 这些布尔标记。检测内容包括是否在 git 工作树内、是否可找到 ao 与 bd 命令、是否存在本地 .agents 目录、是否存在全局 $HOME/.agents 目录,以及是否处于 Codex 环境。

  2. 说明 AgentOps 的作用:要求原样输出固定文案,不加任何额外内容或图示。文案将 AgentOps 定位为“面向编码智能体的运维层”,并说明它为编码智能体补足四项默认不具备的能力:

    • Bookkeeping(记账):会话在 .agents/ 中捕获学习、发现和可复用上下文。
    • Validation(验证):/council、/pre-mortem 和 /vibe 在发布前挑战计划与代码。
    • Primitives(原语):skills、execution packets 和 ao CLI 提供几乎任意交互的构建块。
    • Flows(流程):/research、/implement、/validate 和 /rpi 既可单独运行,也可端到端组合。 同时列出关键技能 /rpi、/research、/validate、/implement、/council、/pre-mortem、/swarm、/status,以及新会话定向方式 ao session bootstrap,随后 ao inject 或 ao corpus inject --query "<topic>",并提示完整参考为 /quickstart --catalog。
  3. 给出一条下一步行动:按顺序匹配第一条适用的条件并输出对应消息。可能的输出包括:不在 git 仓库内时先运行 git init;已安装 ao 但未初始化时运行 ao quick-start;ao 未安装时先通过 Homebrew 安装 ao CLI;环境就绪时建议运行 /rpi "your goal"、ao reconcile --json、bd ready 或 /status 等。在“不在 git 仓库但有全局語料”的情况下,会引导走 /curate --mode=harvest、/compile、/inject、/status 的全局知识流程。

使用方式

用户直接调用 /quickstart。技能随后自动完成检测、输出说明并给出唯一一条建议。若想查看完整技能目录,可询问“show me all the skills”,或使用 /quickstart --catalog,也可查阅 references/full-catalog.md。启动新项目时可运行 /scaffold <language> <name> 生成符合最佳实践的项目结构。

相关参考文档包括 references/quickstart.feature(可执行规范:检测 git/ao/bd/.agents 并推荐符合状态的下一步行动)、references/getting-started.md、references/troubleshooting.md、references/full-catalog.md。另见 scaffold(项目脚手架与组件生成)。

适用场景

适合首次接触 AgentOps 的新用户,在任意目录运行以快速了解定位并获得下一步操作;也适合已配置环境的老用户,用于确认当前全栈状态(如 ao、bd、.agents 是否齐备)。示例中给出两种典型情形:首次配置时,智能体检测工具、显示一行状态并给出唯一的下一步;已配置完成时,检测到全栈就绪并建议 ao reconcile --json、bd ready 或 /rpi "your goal"。

限制与说明

  • AgentOps 3.0 是无钩子(hookless)的:没有任何 ao 命令或参数会安装钩子,CI 是权威关卡;钩子需自行编写,属于可选,通过 hooks-authoring 技能完成。
  • 若技能未安装,可用 bash <(curl -fsSL https://raw.githubusercontent.com/boshu2/agentops/main/scripts/install.sh) 安装。
  • 若飞轮计数为 0,说明是首次会话,运行 /rpi "a small goal" 即可启动。
  • 环境检测部分的具体判定命令、各条件下的完整推荐文案,均以资料原文为准,此处不逐一改写。
  • 关于收费、价格、平台支持范围、性能效果等,资料未提供相关信息。