用途：管理 agents.toml 中声明的智能体技能依赖。dotagents 负责解析、安装并符号链接技能，让多个智能体工具（Claude Code、Cursor、Codex、VS Code、OpenCode）从 .agents/skills/ 统一发现技能。若 dotagents 不是直接可用的命令，可用 npx @sentry/dotagents 代替，例如 npx @sentry/dotagents sync，所有命令与参数用法相同。
主要命令：dotagents init 初始化 agents.toml 与 .agents/ 目录；install 安装 agents.toml 中全部技能；add <specifier> 添加技能依赖；remove <name> 移除技能；update [name] 更新到最新版本；sync 协调状态（收养孤儿、修复符号链接、校验完整性）；list 列出已安装技能及状态；mcp 添加、移除或列出 MCP 服务器声明。所有命令支持 --user，改为操作用户级 ~/.agents/ 而非当前项目。
用法示例：dotagents init；dotagents add getsentry/skills find-bugs；dotagents add getsentry/skills find-bugs code-review commit；dotagents add getsentry/skills --all；dotagents add getsentry/warden@v1.0.0；dotagents install；dotagents list。
来源格式：GitHub 简写 owner/repo；带钉选的 owner/repo@tag 或分支/提交；SSH 克隆 URL；完整 HTTPS URL；任意非 GitHub 的 git 远端 git:https://...；本地路径 path:./my-skills/custom（相对项目根目录）。
关键概念：.agents/skills/ 是所有已安装技能的规范位置；agents.toml 声明依赖，agents.lock 固定精确提交与完整性哈希；符号链接使 .claude/skills/、.cursor/skills/ 指向 .agents/skills/；通配符 name = "*" 可从某来源安装全部技能并可选排除列表；[trust] 段可限制允许的来源；[[hooks]] 声明可将工具事件钩子写入各智能体配置；gitignore = true 时，受管技能被 gitignore，自定义就地技能仍被跟踪；--user 在 ~/.agents/ 管理跨项目共享技能。更完整的命令选项见 references/cli-reference.md，配置编辑见 references/configuration.md，字段与默认值见 references/config-schema.md。