SuperAPI AI 工具集

bd-to-br-migration

办公与效率

查看项目

更新于 10-15 21:09

技能介绍

用途:把 AGENTS.md 等文档中的 bd(beads)引用迁移为 br(beads_rust),避免因文档未更新导致智能体执行过时的 bd sync 指令、误以为会自动提交而丢失工作。

主要能力:提供单文件迁移的精确步骤,按固定顺序执行转换;处理命令重命名、同步命令改写、问题 ID 变换、链接更新;明确列出需删除的过时内容与需保留的仍有效内容;附验证脚本和 grep 检查。

核心行为差异:bd sync 会自动提交到 git,而 br sync --flush-only 仅导出 JSONL,不会执行任何 git 命令;因此每次 sync 后必须手动补充 git add .beads/ 与 git commit -m "sync beads"。

转换顺序(依次执行):1. 章节标题 “bd (beads)” 改为 “br (beads_rust)”;2. 在 beads 章节标题后添加非侵入式说明;3. 命令 bd X 改为 br X,适用于 ready/list/show/create/update/close/dep/stats;4. bd sync 改为 br sync --flush-only;5. 在每个 sync 后添加 git 步骤 git add .beads/、git commit -m "sync beads";6. 问题 ID bd-### 改为 br-###,覆盖 thread_ids、subjects、reasons、commits;7. 链接 beads_viewer 改为 beads_rust(如存在)。批量迁移时可对多文件依次应用,10 个以上文件建议分批使用并行子代理。

需完全删除:daemon 引用、自动提交假设、钩子安装提及、RPC 模式。需保持不变:SQLite/WAL 注意事项、bv 集成、P0-P4 优先级系统、问题类型、依赖跟踪、.beads/ 作为事实来源。

验证方式:使用 ./scripts/verify-migration.sh file.md 检查;或执行 grep -c '`bd ' 与 grep -c 'bd sync' 应返回 0,grep -c 'br sync --flush-only' 应大于 0;也可用 ./scripts/find-bd-refs.sh /path 查找待迁移文件。任何 bd 残留即表示迁移不完整,需重新应用转换。

适用场景:更新单一智能体文档、批量迁移项目文档、核验既有迁移是否完成。

限制:这是低自由度的确定性任务,只有一种正确输出,不允许创造性解释、可选改进或风格选择;命令须严格按指定形式应用。文中未提供该技能的安装方式、可用平台、收费与价格信息,暂未提供。