用途
Agent Bootstrap 用于从仓库根目录的 agent.toml 清单文件引导智能体开发环境。它读取清单并据此配置当前工具（如 Claude Code、OpenCode 等），实现无外部依赖的自引导：清单文件加本技能即可完成环境搭建，无需 curl|bash、包管理器或外部工具。
主要能力
- 读取仓库根目录的 agent.toml，解析其中的清单版本、环境要求、技能定义、插件配置、MCP 服务器定义、钩子定义和验证检查。
- 校验环境：检查必需的环境变量是否设置、必需的命令是否在 PATH 中、运行时版本是否满足约束。
- 配置当前工具：检测当前工具（通过 .claude/、.opencode/、.cline/、.cursor/ 等目录），为 Claude Code 更新 .claude/settings.json 中的启用插件，生成 .mcp.json 中的 MCP 服务器配置，并报告钩子配置（钩子需用户手动设置）。
- 安装远程技能：根据技能定义中的 source 字段，从 GitHub、skills.sh 注册表、原始 URL 或 Git URL 安装远程技能，支持版本固定。
- 运行验证检查：在 --verify 模式下运行 agent.toml 中定义的验证检查，报告每个检查的通过或失败状态。
使用方式
命令形式：
- /agent-bootstrap：校验环境并配置工具。
- /agent-bootstrap --verify：运行所有验证检查。
- /agent-bootstrap --check：干跑模式，报告将会配置的内容，不做任何更改。
执行过程分为多个阶段：解析清单、安装远程技能、校验环境、配置工具、报告状态，以及在 --verify 模式下运行验证检查。
远程技能安装根据 source 格式选择不同命令：
- owner/repo@skill：npx skills add owner/repo@skill -g -y
- owner/repo@skill 加版本：npx skills add owner/repo@skill#version -g -y
- skills.sh/name：npx skills add name -g -y
- https://.../raw/.../skill：直接获取 SKILL.md 到 ~/.claude/skills/
- https://....git@skill：npx skills add <url> -g -y
环境变量检查只检查是否设置，不读取值。命令检查使用 command -v。运行时版本检查使用相应命令输出版本号。
适用场景
- 在新仓库中开始工作时。
- 环境感觉配置错误时。
- 检查意外失败时。
- 在新机器上设置环境时。
限制与注意事项
- 需要显式调用 /agent-bootstrap，不会自动运行引导。
- 钩子配置需要用户手动添加到工具设置中。
- 只配置清单中声明的内容，不做过度配置。
- 写入文件时只写 ${VAR_NAME} 引用，不写环境变量值，避免密钥泄露。
- 远程技能安装可能失败，需报告失败并建议重试。
- 验证检查中 trigger = "explicit" 的检查在非 --verify 模式下会跳过。
- 完整清单模式规范参见 docs/agent-toml-spec.md。