用途：ao session bootstrap 是 AgentOps 仓库中每个被启动的智能体首先要运行的通用初始化命令。其目标是在同一仓库内，无论使用 Claude 还是 Codex 等模型，智能体都从一致的起始状态开始，便于在任务中途安全替换模型。
主要能力：命令以四步 fail-open（失败不阻塞）方式生成 session-bootstrap.v1 状态快照：1）确认分层 AGENTS.md 是否存在，包括 AGENTS-WORKFLOW.md、AGENTS-CI.md、AGENTS-CODEX.md、AGENTS-RUNTIME.md，仅报告存在情况，不读取内容；2）调用 onboard --auto，目前尚未实现，返回 skipped:not-implemented；3）统计可认领的 bead 数量（bd ready --json）；4）可选探测 mcp-agent-mail 的未读数量。任一步骤失败均记为 null 或 skipped，命令仍以 0 退出。
使用方式：手动启动智能体后运行 ao session bootstrap；可在自定义 SessionStart 钩子中自动执行 ao session bootstrap --robot 并忽略退出码；流水线或 CI 中在认领任务前运行 ao session bootstrap --json。标志：--json 输出完整机器可读状态；--robot 等同 --json 并附带面向钩子的退出码约定；--no-mail 跳过邮件探测；无标志时输出一行人类可读摘要，缺少 AGENTS.md 时在 stderr 警告。输出为固定 JSON 结构，字段全部必填，可为空字段在跳过或出错时填 null，schema 位于 schemas/session-bootstrap.v1.schema.json。
适用场景：多智能体协作仓库、流水线无头 CI 智能体、需要模型可互换且共享相同起始环境的场合。
限制：它只是状态快照，不认领任务、不派发、不修改状态，也不是硬性门禁。它不提供长引导文档内容，智能体仍需自行阅读 AGENTS.md。mcp-agent-mail 为软依赖；onboard 子命令暂未实现；尚未新增专门的 schema CI 校验门禁。
分类依据：命令用于智能体会话初始化与多智能体协作框架，属于智能体与模型方向。