用途:为 beads(bd)任务追踪器提供 Dolt 与 DoltHub 感知层,处理 Dolt 后端、DoltHub 可见性以及 bd 与 Dolt 的常见故障。它不替代全局 beads 技能,而是与其组合使用。
主要能力:Step 0 用 dolt-detect.py 自动检测 Dolt 栈类型(live-server > repo > embedded > file),输出连接描述符并据此路由;诊断“beads 未出现在 DoltHub”问题(根因通常是未配置 remote);配置 DoltHub remote 并推送;解释 JSONL 导出节流;按场景分派五个内置 agent(dolt-sync-advisor、bead-epic-auditor、bead-dependency-mapper、bead-recovery-specialist、beads-guru)。
必要用法:检测命令 python3 ${CLAUDE_PLUGIN_ROOT}/scripts/dolt-detect.py;诊断用 bd dolt show 与 bd dolt remote list;修复用 bd dolt remote add origin https://doltremoteapi.dolthub.com/ORG/REPO 与 bd dolt push --remote origin;JSONL 节流可设 bd config set export.interval 1s。DoltHub 数据库须先在 UI 创建,推送不会自动创建。
适用场景:DoltHub 可见性排查、推送与备份、epic 闭合审计、依赖图分析、快速写入竞态恢复、嵌入式到服务器模式迁移、空闲 dolt sql-server 回收。
限制:需 bd >= 1.0.4 且为 Dolt 后端工作区;SQL 类 agent 需 dolt-mcp-server 二进制并固定版本;嵌入式模式只读,doltlite 为 alpha 只读,dumbo 仅报告;认证依赖 dolt creds 或环境变量。具体版本行为以已安装二进制与上游文档为准。