尧图网站建设 
Beads 与 Kiro CLI 集成指南通过bd setup kiro安装 Workspace Steering 工作流指引【免费下载链接】beadsBeads - A memory upgrade for your coding agent项目地址: https://gitcode.com/GitHub_Trending/beads1/beads导读本文介绍如何在 Kiro CLI 中使用 Beadsbd的 issue tracking 能力。通过一条bd setup kiro命令即可把 Beads 的工作流指引写入 Kiro 的 workspace steering 目录.kiro/steering/beads.md让 Kiro 在每次启动会话时自动加载 Beads 的完整工作流上下文配合--check与--remove标志可实现安装状态校验与一键卸载。读完本文你将掌握 Kiro 集成的完整安装、验证、卸载流程并理解其底层 recipe 机制与写入内容。一、Kiro 集成概览Kiro CLI 通过workspace steering guidance工作区引导文件机制与 Beads 协同工作bd setup kiro把 Beads 的工作流指引写入.kiro/steering/beads.md而 Kiro 在启动会话时读取 workspace steering 文件从而让 Kiro 中的编码 Agent 自动获得 Beads 的 issue 工作流规范何时bd ready、如何bd create、何时bd close等无需人工反复粘贴提示词。与仓库中其他编辑器集成如 Cursor、Claude Code、Codex相比Kiro 集成属于轻量级引导文件型集成它不安装 hooks、不写入 MCP 配置只落盘一个 Markdown 文件。这一点在 internal/recipes/recipes.go 的内置 recipe 定义中可以看到kiro的类型为TypeFile路径为.kiro/steering/beads.md描述为 Kiro steering file。二、安装bd setup kiro在项目根目录执行bd setup kiro命令执行后Beads 会在当前工作区创建.kiro/steering/目录并写入beads.md工作流指引文件。从 cmd/bd/setup.go 的runRecipe流程可以看到Kiro 走的是通用 recipe 安装路径通过lookupSetupRecipe(kiro)在内置 recipe 表中查找kiro校验 recipe 类型为TypeFile取目标路径.kiro/steering/beads.md若目标目录不存在则自动创建os.MkdirAll权限0o755通过recipes.ContentForPath取得模板内容并写入文件权限0o644输出安装成功信息及写入的文件路径。一个值得注意的特性是Kiro 集成不要求先初始化 Beads 工作区。lookupSetupRecipe在找不到.beads目录时会回退到编译进二进制文件的内置 recipecmd/bd/setup.go因此即使在未运行过bd init的项目中也能直接安装。对应的回归测试 cmd/bd/setup_test.goTestRunRecipe_KiroWorksWithoutWorkspace专门验证了这一点在无BEADS_DIR、无.beads目录的临时目录中执行runRecipe(kiro)断言输出包含 Installing Kiro CLI integration 且.kiro/steering/beads.md的内容与模板完全一致。三、校验安装状态bd setup kiro --checkbd setup kiro --check该命令检查.kiro/steering/beads.md是否存在已安装输出✓ Kiro CLI integration installed并列出文件路径未安装输出✗ Kiro CLI integration not installed提示运行bd setup kiro并列出缺失文件见 cmd/bd/setup.go。--check的实现非常直接对 recipe 的每个目标路径调用os.Stat判断是否存在。它适合放进 CI 脚本或 Agent 会话启动前的自检流程快速确认引导文件是否就位。四、卸载bd setup kiro --removebd setup kiro --remove卸载逻辑cmd/bd/setup.go会删除.kiro/steering/beads.md并顺带清理空的.kiro/steering目录若文件本就不存在则输出 No integration files found 而不报错保证幂等性。五、写入的内容steering 文件里有什么bd setup kiro写入的不是空占位符而是 Beads 的通用工作流模板recipes.Template定义于 internal/recipes/template.goKiro 启动会话时会把该文件作为 steering 上下文注入。其核心内容涵盖核心规则所有工作必须用bd跟踪禁止 Markdown TODO 或评论式任务清单bd ready查找可做的工作bd create新建 issue/task/bug将 commit、push、Dolt remote 同步视为策略控制的交接动作默认采取保守的 git 权限策略未获用户/编排者/仓库配置显式授权时不擅自 commit/sync/push。快速命令参考模板原样写入bd prime # Load complete workflow context (SSOT) bd ready # Show issues ready to work (no blockers) bd list --statusopen # List all open issues bd create title -t task -p 2 # Create new issue bd update id --claim # Claim work atomically bd unclaim id # Release stuck issue (agent crashed) bd close id # Mark complete bd dep add issue depends-on # Add dependency bd dolt push # Sync with remote when authorized标准工作流bd ready→bd update id --claim原子认领 → 干活 →bd close id标记完成 → 交接时报告改动文件、验证结果、issue 状态及建议的 commit/sync/push 命令。Issue 类型bug故障、feature新功能、task测试/文档/重构等工作项、epic带子任务的大特性、chore依赖/工具维护。优先级0严重安全、数据丢失、构建损坏→1高重要特性、关键 bug→2中默认→3低打磨、优化→4积压未来想法。上下文加载指引提示 Agent 用bd prime获取完整的 AI 优化格式工作流文档并视其为操作命令与会话工作流的单一事实来源SSOT。由于该模板是所有文件型 recipe 共用的Kiro 与 Windsurf.windsurf/rules/beads.md、Cody.cody/rules/beads.md、Kilo Code.kilocode/rules/beads.md等集成获得的是同源的工作流规范只是落盘位置与读取机制不同。六、相关命令与自定义扩展bd setup命令本身还提供了一组与 Kiro 集成配套的通用能力见 cmd/bd/setup.go 的 flag 注册bd setup --list # 列出所有可用 recipe含 kiro bd setup --print # 把模板内容打印到 stdout便于人工审阅 bd setup -o rules.md # 把模板写到自定义路径 bd setup --add myeditor .myeditor/rules.md # 添加自定义 recipe其中bd setup --list会列出内置 recipe 的来源与描述cmd/bd/setup.go--add会把自定义 recipe 保存到.beads/recipes.toml用户 recipe 优先于同名内置 recipe见 internal/recipes/recipes.go。这意味着如果团队需要为 Kiro 定制一份专属 steering 文件可以通过自定义 recipe 机制扩展而不必改动内置模板。七、小结操作命令效果安装bd setup kiro写入.kiro/steering/beads.md工作流指引校验bd setup kiro --check检查引导文件是否存在并给出明确提示卸载bd setup kiro --remove删除引导文件并清理空目录幂等Kiro 集成的本质是把 Beads 的 issue 工作流规范以 steering 文件的形式注入 Kiro 会话让编码 Agent 从会话一开始就清楚如何跟踪工作、何时认领、何时关闭、如何交接。整个过程不依赖 Beads 工作区初始化、不安装 hooks是一条极轻量、可随时回滚的集成路径。集成后Kiro 会话中的 Agent 即可直接使用bd prime、bd ready、bd create、bd close等命令参与 Beads 的 issue 生命周期管理。【免费下载链接】beadsBeads - A memory upgrade for your coding agent项目地址: https://gitcode.com/GitHub_Trending/beads1/beads创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Beads 与 Kiro CLI 集成指南：通过 `bd setup kiro` 安装 Workspace Steering 工作流指引
Beads 与 Kiro CLI 集成指南通过bd setup kiro安装 Workspace Steering 工作流指引【免费下载链接】beadsBeads - A memory upgrade for your coding agent项目地址: https://gitcode.com/GitHub_Trending/beads1/beads导读本文介绍如何在 Kiro CLI 中使用 Beadsbd的 issue tracking 能力。通过一条bd setup kiro命令即可把 Beads 的工作流指引写入 Kiro 的 workspace steering 目录.kiro/steering/beads.md让 Kiro 在每次启动会话时自动加载 Beads 的完整工作流上下文配合--check与--remove标志可实现安装状态校验与一键卸载。读完本文你将掌握 Kiro 集成的完整安装、验证、卸载流程并理解其底层 recipe 机制与写入内容。一、Kiro 集成概览Kiro CLI 通过workspace steering guidance工作区引导文件机制与 Beads 协同工作bd setup kiro把 Beads 的工作流指引写入.kiro/steering/beads.md而 Kiro 在启动会话时读取 workspace steering 文件从而让 Kiro 中的编码 Agent 自动获得 Beads 的 issue 工作流规范何时bd ready、如何bd create、何时bd close等无需人工反复粘贴提示词。与仓库中其他编辑器集成如 Cursor、Claude Code、Codex相比Kiro 集成属于轻量级引导文件型集成它不安装 hooks、不写入 MCP 配置只落盘一个 Markdown 文件。这一点在 internal/recipes/recipes.go 的内置 recipe 定义中可以看到kiro的类型为TypeFile路径为.kiro/steering/beads.md描述为 Kiro steering file。二、安装bd setup kiro在项目根目录执行bd setup kiro命令执行后Beads 会在当前工作区创建.kiro/steering/目录并写入beads.md工作流指引文件。从 cmd/bd/setup.go 的runRecipe流程可以看到Kiro 走的是通用 recipe 安装路径通过lookupSetupRecipe(kiro)在内置 recipe 表中查找kiro校验 recipe 类型为TypeFile取目标路径.kiro/steering/beads.md若目标目录不存在则自动创建os.MkdirAll权限0o755通过recipes.ContentForPath取得模板内容并写入文件权限0o644输出安装成功信息及写入的文件路径。一个值得注意的特性是Kiro 集成不要求先初始化 Beads 工作区。lookupSetupRecipe在找不到.beads目录时会回退到编译进二进制文件的内置 recipecmd/bd/setup.go因此即使在未运行过bd init的项目中也能直接安装。对应的回归测试 cmd/bd/setup_test.goTestRunRecipe_KiroWorksWithoutWorkspace专门验证了这一点在无BEADS_DIR、无.beads目录的临时目录中执行runRecipe(kiro)断言输出包含 Installing Kiro CLI integration 且.kiro/steering/beads.md的内容与模板完全一致。三、校验安装状态bd setup kiro --checkbd setup kiro --check该命令检查.kiro/steering/beads.md是否存在已安装输出✓ Kiro CLI integration installed并列出文件路径未安装输出✗ Kiro CLI integration not installed提示运行bd setup kiro并列出缺失文件见 cmd/bd/setup.go。--check的实现非常直接对 recipe 的每个目标路径调用os.Stat判断是否存在。它适合放进 CI 脚本或 Agent 会话启动前的自检流程快速确认引导文件是否就位。四、卸载bd setup kiro --removebd setup kiro --remove卸载逻辑cmd/bd/setup.go会删除.kiro/steering/beads.md并顺带清理空的.kiro/steering目录若文件本就不存在则输出 No integration files found 而不报错保证幂等性。五、写入的内容steering 文件里有什么bd setup kiro写入的不是空占位符而是 Beads 的通用工作流模板recipes.Template定义于 internal/recipes/template.goKiro 启动会话时会把该文件作为 steering 上下文注入。其核心内容涵盖核心规则所有工作必须用bd跟踪禁止 Markdown TODO 或评论式任务清单bd ready查找可做的工作bd create新建 issue/task/bug将 commit、push、Dolt remote 同步视为策略控制的交接动作默认采取保守的 git 权限策略未获用户/编排者/仓库配置显式授权时不擅自 commit/sync/push。快速命令参考模板原样写入bd prime # Load complete workflow context (SSOT) bd ready # Show issues ready to work (no blockers) bd list --statusopen # List all open issues bd create title -t task -p 2 # Create new issue bd update id --claim # Claim work atomically bd unclaim id # Release stuck issue (agent crashed) bd close id # Mark complete bd dep add issue depends-on # Add dependency bd dolt push # Sync with remote when authorized标准工作流bd ready→bd update id --claim原子认领 → 干活 →bd close id标记完成 → 交接时报告改动文件、验证结果、issue 状态及建议的 commit/sync/push 命令。Issue 类型bug故障、feature新功能、task测试/文档/重构等工作项、epic带子任务的大特性、chore依赖/工具维护。优先级0严重安全、数据丢失、构建损坏→1高重要特性、关键 bug→2中默认→3低打磨、优化→4积压未来想法。上下文加载指引提示 Agent 用bd prime获取完整的 AI 优化格式工作流文档并视其为操作命令与会话工作流的单一事实来源SSOT。由于该模板是所有文件型 recipe 共用的Kiro 与 Windsurf.windsurf/rules/beads.md、Cody.cody/rules/beads.md、Kilo Code.kilocode/rules/beads.md等集成获得的是同源的工作流规范只是落盘位置与读取机制不同。六、相关命令与自定义扩展bd setup命令本身还提供了一组与 Kiro 集成配套的通用能力见 cmd/bd/setup.go 的 flag 注册bd setup --list # 列出所有可用 recipe含 kiro bd setup --print # 把模板内容打印到 stdout便于人工审阅 bd setup -o rules.md # 把模板写到自定义路径 bd setup --add myeditor .myeditor/rules.md # 添加自定义 recipe其中bd setup --list会列出内置 recipe 的来源与描述cmd/bd/setup.go--add会把自定义 recipe 保存到.beads/recipes.toml用户 recipe 优先于同名内置 recipe见 internal/recipes/recipes.go。这意味着如果团队需要为 Kiro 定制一份专属 steering 文件可以通过自定义 recipe 机制扩展而不必改动内置模板。七、小结操作命令效果安装bd setup kiro写入.kiro/steering/beads.md工作流指引校验bd setup kiro --check检查引导文件是否存在并给出明确提示卸载bd setup kiro --remove删除引导文件并清理空目录幂等Kiro 集成的本质是把 Beads 的 issue 工作流规范以 steering 文件的形式注入 Kiro 会话让编码 Agent 从会话一开始就清楚如何跟踪工作、何时认领、何时关闭、如何交接。整个过程不依赖 Beads 工作区初始化、不安装 hooks是一条极轻量、可随时回滚的集成路径。集成后Kiro 会话中的 Agent 即可直接使用bd prime、bd ready、bd create、bd close等命令参与 Beads 的 issue 生命周期管理。【免费下载链接】beadsBeads - A memory upgrade for your coding agent项目地址: https://gitcode.com/GitHub_Trending/beads1/beads创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考