Beads 与 Aider 集成实战在人工审核工作流中用/run批准bd命令【免费下载链接】beadsBeads - A memory upgrade for your coding agent项目地址: https://gitcode.com/GitHub_Trending/beads1/beadsBeadsbd为编码 Agent 提供了一套完整的 issue 跟踪与记忆系统而 Aider 是典型的人工在环human-in-the-loopAI 结对编程工具它不会自主执行 shell 命令。本文介绍如何通过bd setup aider将两者对接让 AI 在对话中建议bd命令由你使用 Aider 的/run逐一确认执行从而实现AI 提议、人工把关的受控 issue 工作流。读完本文你将掌握从安装、配置到完整会话闭环认领、创建、同步的全部实操方法并理解其背后的源码实现原理。Aider 集成的设计理念与 Claude Code 集成 这类自主 Agent 不同Aider 默认不允许 AI 直接执行任意 shell 命令。Beads 的 Aider 集成完全顺应这一设计约束AI 的角色是顾问它读取工作流说明后向你建议合适的bd命令而你作为人类通过 Aider 的/run命令批准并执行每一条命令。这意味着整个 issue 操作链条——查看可认领的工作、创建新 issue、更新状态、推送数据库——都在你的显式确认下进行AI 不会越过你的控制直接改动 issue 数据。这种模式尤其适合需要严格审核、逐步验证的开发场景。前置条件在开始集成前需要满足两个基础条件Beads 已安装并完成项目初始化如果项目根目录还没有.beads/目录先运行bd init完成初始化。Beads 的安装方式Homebrew、npm、安装脚本、go install等参见安装文档。Aider 已安装通过pip或pipx安装均可pip install aider-chat # 或 pipx install aider-chat快速设置bd setup aider安装完成后在项目根目录执行bd setup aider该命令会一次性生成三个文件分别服务于 AI 和人类文件用途消费方.aider.conf.yml告诉 Aider 加载 Beads 工作流指令只读注入Aider 启动配置.aider/BEADS.mdAI 阅读的工作流指令规则、命令速查AI 模型.aider/README.md面向人类的快速参考手册开发人员验证安装bd setup aider --check移除集成bd setup aider --remove该命令会删除上述三个文件如果.aider/目录变空也会一并清理。源码视角集成背后的实现bd setup命令的所有编辑器集成都是通过 recipe 机制统一管理的cmd/bd/setup.go。在runAiderRecipe分发函数中cmd/bd/setup.gobd setup aider的三个形态分别对应三个底层函数默认安装 →setup.InstallAider()--check→setup.CheckAider()仅校验.aider.conf.yml是否存在--remove→setup.RemoveAider()具体实现在 cmd/bd/setup/aider.goInstallAider先通过EnsureDir创建.aider/目录权限 0755再通过atomicWriteFile原子写入三个模板文件避免写入中断产生半成品配置。RemoveAider对三个文件逐一执行删除且对文件不存在的场景做了容错os.IsNotExist时跳过因此对从未安装过的目录执行--remove也不会报错。这一套行为在 cmd/bd/setup/aider_test.go 中有完整测试覆盖TestInstallAider验证三个文件的内容与模板完全一致TestInstallAiderIdempotent验证重复安装不产生内容漂移TestRemoveAider_DirectoryWithOtherFiles验证当.aider/目录中还留有其他文件时不会被误删。配置文件解析.aider.conf.yml把指令注入只读上下文生成的文件内容如下# Beads Issue Tracking Integration for Aider # Auto-generated by bd setup aider # Load Beads workflow instructions for the AI # This file is marked read-only and cached for efficiency read: - .aider/BEADS.md这是 Aider 的read配置指令启动时把.aider/BEADS.md加载进 AI 的只读上下文。注释里特意标注read-only and cached for efficiency说明该文件只作为参考信息注入AI 不会修改它且 Aider 会对其做缓存以提高效率。该模板定义于源码常量aiderConfigTemplatecmd/bd/setup/aider.go。.aider/BEADS.mdAI 的工作流规则.aider/BEADS.md是 AI 在会话中遵循的规则集核心内容对应源码常量aiderBeadsInstructionscmd/bd/setup/aider.go主要包括核心工作流规则所有工作都记录在bd中绝不使用 markdown TODO 或注释式任务清单建议bd ready查找可认领的工作建议bd create创建新 issue / 任务 / bug会话结束时建议bd dolt push始终以建议形式给出命令——由用户通过/run执行。命令速查表AI 会建议这些命令命令作用bd ready显示无阻塞的 issuebd list --statusopen列出所有打开中的 issuebd create --title... --typetask创建新 issuebd update id --claim原子认领工作bd unclaim id释放卡住的 issuebd close id标记完成bd dep add issue depends-on添加依赖关系bd dolt push推送变更到 Dolt 远程issue 类型与优先级模板中内置了完整枚举——类型包括bug损坏需修复、feature新功能、task工作项测试/文档/重构、epic由多个 issue 组成的大型功能、chore维护类工作依赖、工具链优先级0严重安全、数据丢失、构建损坏到4积压未来想法其中2为默认中等优先级。你可以编辑.aider/BEADS.md追加项目专属指令但注意重新运行bd setup aider会重新生成该文件覆盖你的修改——如需持久化自定义应通过bd prime的定制机制见下文或维护独立指令文件。.aider/README.md人类的速查手册面向开发人员的快速参考源码常量aiderReadmeTemplatecmd/bd/setup/aider.go包含 Quick Start 五步操作、issue 类型与优先级速查以及如何与 AI 对话的建议提问方式如What issues are ready to work on?、Create an issue for this bug I found、Show me the details of bd-42。会话工作流启动会话# Aider 会通过 .aider.conf.yml 自动读取 issue 上下文 aider # 或者手动注入完整上下文 bd prime | aider --message-file -第二种方式把bd prime的输出通过管道喂给 Aider 作为初始消息适用于未运行bd setup aider、或需要在会话开头就拿到完整工作流文档的场景。Aider 内部的人机协作在 Aider 中以/开头的都是 Aider 自身命令/run、/add、/help其余输入都是发给 AI 的消息。AI 建议bd命令你批准后用/run执行You: What issues are ready to work on? Aider: Let me check the available work. Run: /run bd ready You: Lets work on bd-42 Aider: To claim it, run: /run bd update bd-42 --claim如果会话中途需要给 AI 补全 bd 上下文直接执行/run bd prime——AI 会读取输出并掌握完整工作流指南。工作中的旁路操作有些操作更适合在另一个终端或退出 Aider 后直接执行# 工作中发现的 bug记录为依赖 issue bd create Found bug during work --deps discovered-from:bd-42 --json bd update bd-42 --claim bd ready # 把已创建的 issue 关联为工作中发现的依赖 bd dep add bd-77 bd-42 --type discovered-from--deps discovered-from:parent-id是 Beads 中记录工作期间发现的新问题的标准方式用于还原问题的来源脉络。结束会话bd dolt push将本地的 issue 数据库变更推送到 Dolt 远程实现多端同步。完整示例工作流# 1. 查看可认领的工作 bd ready # 2. 带着 issue 上下文启动 Aider aider --message Working on bd-42: Fix auth bug # 3. 在 Aider 中工作... # 4. 创建工作期间发现的关联 issue bd create Found related bug --deps discovered-from:bd-42 --json # 5. 完成并同步 bd close bd-42 --reason Fixed bd dolt push最佳实践保持 issue 可见——用bd prime把 issue 上下文注入会话AI 才能给出有针对性的建议定期推送——重要变更后运行bd dolt push避免数据库长时间不同步善用 discovered-from——记录工作中发现的问题形成完整依赖链写清描述——创建 issue 时附带有意义的信息方便 AI 和协作者理解职责分离Aider 提交代码bd 同步数据——Aider 自动提交你的代码改动gitissue 数据则通过bd dolt push独立同步两者互不干扰。深入理解bd prime的上下文注入bd prime是整套 Aider以及其他 Agent 集成工作流的上下文支柱实现在 cmd/bd/prime.go。它输出 AI 优化的 markdown 格式工作流上下文并自动检测运行环境MCP 模式输出精简的工作流提醒约 50 tokensCLI 模式输出完整命令参考约 1–2k tokens——这正是 Aider 场景下注入的形态。几个与 Aider 工作流直接相关的行为自定义工作流在.beads/PRIME.md放置自定义模板可覆盖默认工作流文本bd remember的持久记忆仍会追加记忆注入不受影响可用--export导出默认内容用于定制。记忆上限--max-memories N与--max-memory-chars N或配置键prime.max-memories/prime.max-memory-chars可限制注入的记忆量防止大记忆集挤占 Aider 的上下文预算超出部分会输出横幅提示用bd memories浏览。超时控制默认 10 秒可通过环境变量BEADS_PRIME_TIMEOUT调整cmd/bd/prime.go。由于注入的是紧凑文本而非 MCP 工具模式bd prime的上下文成本远低于完整工具定义这也是 CLI 指令注入模式在 Aider 场景下高效的原因。故障排查配置未加载# 检查配置文件是否存在 cat .aider.conf.yml # 重新生成 bd setup aiderAider 在启动时读取.aider.conf.yml因此重新生成配置后需要重启 Aider/exit后重新执行aider才能生效。issue 不可见# 用 bd prime 手动注入 issue 上下文 bd prime | aider --message-file - # 或者检查数据库健康状况 bd doctorbd doctor会检查本地 issue 数据库的健康状态若存在损坏或迁移问题优先修复后再继续。更多资源Claude Code 集成——自主 Agent 模式的对照参考IDE 集成设置——其他编辑器与 Agent 的接入方式快速上手——Beads 核心命令入门AGENTS.md——完整的 bd Agent 工作流指南【免费下载链接】beadsBeads - A memory upgrade for your coding agent项目地址: https://gitcode.com/GitHub_Trending/beads1/beads创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Beads 与 Aider 集成实战在人工审核工作流中用/run批准bd命令【免费下载链接】beadsBeads - A memory upgrade for your coding agent项目地址: https://gitcode.com/GitHub_Trending/beads1/beadsBeadsbd为编码 Agent 提供了一套完整的 issue 跟踪与记忆系统而 Aider 是典型的人工在环human-in-the-loopAI 结对编程工具它不会自主执行 shell 命令。本文介绍如何通过bd setup aider将两者对接让 AI 在对话中建议bd命令由你使用 Aider 的/run逐一确认执行从而实现AI 提议、人工把关的受控 issue 工作流。读完本文你将掌握从安装、配置到完整会话闭环认领、创建、同步的全部实操方法并理解其背后的源码实现原理。Aider 集成的设计理念与 Claude Code 集成 这类自主 Agent 不同Aider 默认不允许 AI 直接执行任意 shell 命令。Beads 的 Aider 集成完全顺应这一设计约束AI 的角色是顾问它读取工作流说明后向你建议合适的bd命令而你作为人类通过 Aider 的/run命令批准并执行每一条命令。这意味着整个 issue 操作链条——查看可认领的工作、创建新 issue、更新状态、推送数据库——都在你的显式确认下进行AI 不会越过你的控制直接改动 issue 数据。这种模式尤其适合需要严格审核、逐步验证的开发场景。前置条件在开始集成前需要满足两个基础条件Beads 已安装并完成项目初始化如果项目根目录还没有.beads/目录先运行bd init完成初始化。Beads 的安装方式Homebrew、npm、安装脚本、go install等参见安装文档。Aider 已安装通过pip或pipx安装均可pip install aider-chat # 或 pipx install aider-chat快速设置bd setup aider安装完成后在项目根目录执行bd setup aider该命令会一次性生成三个文件分别服务于 AI 和人类文件用途消费方.aider.conf.yml告诉 Aider 加载 Beads 工作流指令只读注入Aider 启动配置.aider/BEADS.mdAI 阅读的工作流指令规则、命令速查AI 模型.aider/README.md面向人类的快速参考手册开发人员验证安装bd setup aider --check移除集成bd setup aider --remove该命令会删除上述三个文件如果.aider/目录变空也会一并清理。源码视角集成背后的实现bd setup命令的所有编辑器集成都是通过 recipe 机制统一管理的cmd/bd/setup.go。在runAiderRecipe分发函数中cmd/bd/setup.gobd setup aider的三个形态分别对应三个底层函数默认安装 →setup.InstallAider()--check→setup.CheckAider()仅校验.aider.conf.yml是否存在--remove→setup.RemoveAider()具体实现在 cmd/bd/setup/aider.goInstallAider先通过EnsureDir创建.aider/目录权限 0755再通过atomicWriteFile原子写入三个模板文件避免写入中断产生半成品配置。RemoveAider对三个文件逐一执行删除且对文件不存在的场景做了容错os.IsNotExist时跳过因此对从未安装过的目录执行--remove也不会报错。这一套行为在 cmd/bd/setup/aider_test.go 中有完整测试覆盖TestInstallAider验证三个文件的内容与模板完全一致TestInstallAiderIdempotent验证重复安装不产生内容漂移TestRemoveAider_DirectoryWithOtherFiles验证当.aider/目录中还留有其他文件时不会被误删。配置文件解析.aider.conf.yml把指令注入只读上下文生成的文件内容如下# Beads Issue Tracking Integration for Aider # Auto-generated by bd setup aider # Load Beads workflow instructions for the AI # This file is marked read-only and cached for efficiency read: - .aider/BEADS.md这是 Aider 的read配置指令启动时把.aider/BEADS.md加载进 AI 的只读上下文。注释里特意标注read-only and cached for efficiency说明该文件只作为参考信息注入AI 不会修改它且 Aider 会对其做缓存以提高效率。该模板定义于源码常量aiderConfigTemplatecmd/bd/setup/aider.go。.aider/BEADS.mdAI 的工作流规则.aider/BEADS.md是 AI 在会话中遵循的规则集核心内容对应源码常量aiderBeadsInstructionscmd/bd/setup/aider.go主要包括核心工作流规则所有工作都记录在bd中绝不使用 markdown TODO 或注释式任务清单建议bd ready查找可认领的工作建议bd create创建新 issue / 任务 / bug会话结束时建议bd dolt push始终以建议形式给出命令——由用户通过/run执行。命令速查表AI 会建议这些命令命令作用bd ready显示无阻塞的 issuebd list --statusopen列出所有打开中的 issuebd create --title... --typetask创建新 issuebd update id --claim原子认领工作bd unclaim id释放卡住的 issuebd close id标记完成bd dep add issue depends-on添加依赖关系bd dolt push推送变更到 Dolt 远程issue 类型与优先级模板中内置了完整枚举——类型包括bug损坏需修复、feature新功能、task工作项测试/文档/重构、epic由多个 issue 组成的大型功能、chore维护类工作依赖、工具链优先级0严重安全、数据丢失、构建损坏到4积压未来想法其中2为默认中等优先级。你可以编辑.aider/BEADS.md追加项目专属指令但注意重新运行bd setup aider会重新生成该文件覆盖你的修改——如需持久化自定义应通过bd prime的定制机制见下文或维护独立指令文件。.aider/README.md人类的速查手册面向开发人员的快速参考源码常量aiderReadmeTemplatecmd/bd/setup/aider.go包含 Quick Start 五步操作、issue 类型与优先级速查以及如何与 AI 对话的建议提问方式如What issues are ready to work on?、Create an issue for this bug I found、Show me the details of bd-42。会话工作流启动会话# Aider 会通过 .aider.conf.yml 自动读取 issue 上下文 aider # 或者手动注入完整上下文 bd prime | aider --message-file -第二种方式把bd prime的输出通过管道喂给 Aider 作为初始消息适用于未运行bd setup aider、或需要在会话开头就拿到完整工作流文档的场景。Aider 内部的人机协作在 Aider 中以/开头的都是 Aider 自身命令/run、/add、/help其余输入都是发给 AI 的消息。AI 建议bd命令你批准后用/run执行You: What issues are ready to work on? Aider: Let me check the available work. Run: /run bd ready You: Lets work on bd-42 Aider: To claim it, run: /run bd update bd-42 --claim如果会话中途需要给 AI 补全 bd 上下文直接执行/run bd prime——AI 会读取输出并掌握完整工作流指南。工作中的旁路操作有些操作更适合在另一个终端或退出 Aider 后直接执行# 工作中发现的 bug记录为依赖 issue bd create Found bug during work --deps discovered-from:bd-42 --json bd update bd-42 --claim bd ready # 把已创建的 issue 关联为工作中发现的依赖 bd dep add bd-77 bd-42 --type discovered-from--deps discovered-from:parent-id是 Beads 中记录工作期间发现的新问题的标准方式用于还原问题的来源脉络。结束会话bd dolt push将本地的 issue 数据库变更推送到 Dolt 远程实现多端同步。完整示例工作流# 1. 查看可认领的工作 bd ready # 2. 带着 issue 上下文启动 Aider aider --message Working on bd-42: Fix auth bug # 3. 在 Aider 中工作... # 4. 创建工作期间发现的关联 issue bd create Found related bug --deps discovered-from:bd-42 --json # 5. 完成并同步 bd close bd-42 --reason Fixed bd dolt push最佳实践保持 issue 可见——用bd prime把 issue 上下文注入会话AI 才能给出有针对性的建议定期推送——重要变更后运行bd dolt push避免数据库长时间不同步善用 discovered-from——记录工作中发现的问题形成完整依赖链写清描述——创建 issue 时附带有意义的信息方便 AI 和协作者理解职责分离Aider 提交代码bd 同步数据——Aider 自动提交你的代码改动gitissue 数据则通过bd dolt push独立同步两者互不干扰。深入理解bd prime的上下文注入bd prime是整套 Aider以及其他 Agent 集成工作流的上下文支柱实现在 cmd/bd/prime.go。它输出 AI 优化的 markdown 格式工作流上下文并自动检测运行环境MCP 模式输出精简的工作流提醒约 50 tokensCLI 模式输出完整命令参考约 1–2k tokens——这正是 Aider 场景下注入的形态。几个与 Aider 工作流直接相关的行为自定义工作流在.beads/PRIME.md放置自定义模板可覆盖默认工作流文本bd remember的持久记忆仍会追加记忆注入不受影响可用--export导出默认内容用于定制。记忆上限--max-memories N与--max-memory-chars N或配置键prime.max-memories/prime.max-memory-chars可限制注入的记忆量防止大记忆集挤占 Aider 的上下文预算超出部分会输出横幅提示用bd memories浏览。超时控制默认 10 秒可通过环境变量BEADS_PRIME_TIMEOUT调整cmd/bd/prime.go。由于注入的是紧凑文本而非 MCP 工具模式bd prime的上下文成本远低于完整工具定义这也是 CLI 指令注入模式在 Aider 场景下高效的原因。故障排查配置未加载# 检查配置文件是否存在 cat .aider.conf.yml # 重新生成 bd setup aiderAider 在启动时读取.aider.conf.yml因此重新生成配置后需要重启 Aider/exit后重新执行aider才能生效。issue 不可见# 用 bd prime 手动注入 issue 上下文 bd prime | aider --message-file - # 或者检查数据库健康状况 bd doctorbd doctor会检查本地 issue 数据库的健康状态若存在损坏或迁移问题优先修复后再继续。更多资源Claude Code 集成——自主 Agent 模式的对照参考IDE 集成设置——其他编辑器与 Agent 的接入方式快速上手——Beads 核心命令入门AGENTS.md——完整的 bd Agent 工作流指南【免费下载链接】beadsBeads - A memory upgrade for your coding agent项目地址: https://gitcode.com/GitHub_Trending/beads1/beads创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
)
