quickstart

/quickstart

一个目标： 快速告诉新用户 AgentOps 能做什么，以及首先要做什么。

你必须执行此工作流。不要只描述它。

执行步骤

步骤 1：检测设置

git rev-parse --is-inside-work-tree >/dev/null 2>&1 && echo "GIT=true" || echo "GIT=false"
command -v ao >/dev/null && echo "AO=true" || echo "AO=false"
command -v bd >/dev/null && echo "BD=true" || echo "BD=false"
[ -d .agents ] && echo "AGENTS=true" || echo "AGENTS=false"
[ -d "$HOME/.agents" ] && echo "GLOBAL_AGENTS=true" || echo "GLOBAL_AGENTS=false"
[ -n "${CODEX_THREAD_ID:-}" ] || [ "${CODEX_INTERNAL_ORIGINATOR_OVERRIDE:-}" = "Codex Desktop" ] && echo "CODEX=true" || echo "CODEX=false"

步骤 2：展示 AgentOps 的功能

完全按此内容输出（不得添加内容或图示）：

AgentOps is the operational layer for coding agents.

It gives your coding agent four things it doesn't have by default:

  Bookkeeping — sessions capture learnings, findings, and reusable context in .agents/
  Validation  — /council, /pre-mortem, and /vibe challenge plans and code before shipping
  Primitives  — skills, execution packets, and the ao CLI give you building blocks for almost any interaction
  Flows       — /research, /implement, /validate, and /rpi can run alone or compose end to end

Key skills: /rpi  /research  /validate  /implement  /council  /pre-mortem  /swarm  /status
Fresh-session orientation: `ao session bootstrap`, then `ao inject` / `ao corpus inject --query "<topic>"`
Full reference: /quickstart --catalog

步骤 3：执行下一项操作

匹配第一个适用的行。输出该消息。

条件	消息
GIT=false + AO=true + GLOBAL_AGENTS=true	"🗂 你当前不在 git 仓库中，但拥有全局语料库 ~/.agents。全局知识工作流：\n 1. /curate --mode=harvest — 扫描所有仓库中的 .agents/，并将产物提升到 ~/.agents/learnings/\n 2. /compile — 挖掘、综合并写入互相关联的 wiki 到 .agents/compiled/（从 cwd 运行；如果你有 claude CLI，可设置 AGENTOPS_COMPILE_RUNTIME=claude-cli，无需 API 密钥）\n 3. /inject — 将编译后的语料库转化为操作手册、信念手册和供未来会话使用的运行时简报\n 4. /status — 查看飞轮健康状况快照\n如果你想在此处启动一个新的仓库本地项目，请先运行 git init。"
GIT=false	"⚠ 不在 git 仓库中。请先运行 git init。\n （如果你想使用全局 ~/.agents 语料库，请在包含 .agents/ 的目录中运行 /quickstart，或参阅 /curate --mode=harvest、/compile、/inject。）"
AO=false + CODEX=true	"📦 请先安装 ao CLI：\n brew tap boshu2/agentops https://github.com/boshu2/homebrew-agentops\n brew install agentops\n ao quick-start\n然后：运行 /rpi \"a small goal\"，开始你的第一个周期。\n如果你想要 PRODUCT.md、README.md 和 PROGRAM.md，请在核心种子之后使用 /bootstrap。"
AO=false	"📦 请先安装 ao CLI：\n brew tap boshu2/agentops https://github.com/boshu2/homebrew-agentops\n brew install agentops\n ao quick-start\n然后：运行 /rpi \"a small goal\"，开始你的第一个周期。\n如果你想要 PRODUCT.md、README.md 和 PROGRAM.md，请在核心种子之后使用 /bootstrap。"
AGENTS=false + CODEX=true	"🌱 ao 已安装，但尚未在此处初始化。\n 运行 ao quick-start 以应用可重复使用的核心种子。ao quickstart 是稳定别名。\n 仅当你需要产品/运营层时，才运行 /bootstrap：PRODUCT.md、README.md、PROGRAM.md/AUTODEV.md，以及可选的钩子。\n然后：运行 /rpi \"a small goal\"，开始你的第一个周期。"
AGENTS=false	"🌱 ao 已安装，但尚未在此处初始化。\n 运行 ao quick-start 以应用可重复使用的核心种子。ao quickstart 是稳定别名。\n 仅当你需要产品/运营层时，才运行 /bootstrap：PRODUCT.md、README.md、PROGRAM.md/AUTODEV.md，以及可选的钩子。\n然后：运行 /rpi \"a small goal\"，开始你的第一个周期。"
BD=false + CODEX=true	"✅ Codex 插件路径已就绪。\n /rpi \"your goal\" — 完整的 /discovery → /crank → /validate 流程\n /research <topic> — 探索代码库\n 默认安装不包含钩子；可通过 install-codex.sh --with-hooks 选择启用原生钩子。\n 需要时仍可使用旧版显式备用命令 ao codex ensure-start / ao codex ensure-stop。\n 手动备用入口：ao codex status\n 需要问题跟踪？运行 brew install boshu2/agentops/beads && bd init --prefix <prefix>"
BD=false	"✅ 飞轮已激活。现在开始：\n /rpi \"your goal\" — 完整的 /discovery → /crank → /validate 流程\n /validate — 收尾近期工作并记录经验\n /research <topic> — 探索代码库\n 需要问题跟踪？运行 brew install boshu2/agentops/beads && bd init --prefix <prefix>"
BD=true + CODEX=true	"✅ Codex 全栈已就绪。\n ao reconcile --json — 检查 git、CI、发布、beads 和 .agents 是否一致\n bd ready — 在解决高严重性对账问题后查看未完成的工作\n /rpi \"your goal\" — 从头开始一个新目标\n 默认安装不包含钩子；可通过 install-codex.sh --with-hooks 选择启用原生钩子。\n 需要时仍可使用旧版显式备用命令 ao codex ensure-start / ao codex ensure-stop。\n 手动备用入口：ao codex status"
BD=true	"✅ 全栈已就绪。\n ao reconcile --json — 检查 git、CI、发布、beads 和 .agents 是否一致\n bd ready — 在解决高严重性对账问题后查看未完成的工作\n /rpi \"your goal\" — 从头开始一个新目标\n /status — 查看当前会话状态"
要开始新项目？运行 /scaffold <language> <name>，按照最佳实践生成项目结构。

---

示例

首次设置

用户输入： /quickstart

执行结果： Agent 检测工具，显示一行状态，并给出要运行的唯一下一步操作。

已完成设置

用户输入： /quickstart

执行结果： Agent 检测到完整技术栈已就绪，并建议运行 ao reconcile --json、bd ready 或 /rpi "your goal"。

故障排除

问题	解决方案
未安装技能	bash <(curl -fsSL https://raw.githubusercontent.com/boshu2/agentops/main/scripts/install.sh)
钩子激活	AgentOps 3.0 不使用钩子——没有用于安装钩子的 ao 命令或标志，CI 是权威的门禁。钩子为可选项，需通过 hooks-authoring 技能自行编写。
飞轮计数为 0	首个会话——运行 /rpi "a small goal" 启动
想查看完整技能目录	提问：“显示所有技能”，或参阅 references/full-catalog.md

参考文档

• references/quickstart.feature — 可执行规范：检测设置（git/ao/bd/.agents），并根据状态推荐下一步操作（soc-qk4b）

• references/getting-started.md

• references/troubleshooting.md

• references/full-catalog.md

另请参阅

• scaffold — 项目脚手架与组件生成