beads-create

Beads 创建

使用此技能根据计划/规格创建 Beads，并完成审核，让实现者可以直接接手问题并交付。此技能必须同时适用于经典 Beads（bd）和 beads_rust（br）。

工作流

1. 先确定使用哪个跟踪器

   • 如果用户明确指定 bd、br、beads 或 beads_rust，则遵照指定。
   • 否则，检测实际安装的工具：
     • 如果只安装了 br，则使用 br。
     • 如果只安装了 bd，则使用 bd。
     • 如果两者都已安装，则优先使用已管理当前工作区/历史记录的跟踪器。检查本地 .beads/ 状态和现有工作流文档，再作判断。
     • 如果两者都已安装，且工作区情况仍不明确，则针对性地提问一个问题，而不是贸然决定。
   • 一次操作中不得混用两个跟踪器的命令。

2. 按需加载相应的本地指南

   • 查找用户设备上已加载、涵盖所选跟踪器的本地技能，并优先使用。
   • 对于 bd，如果有本地 beads 技能，优先使用。
   • 对于 br，如果有已加载的本地 br、beads_rust 或同类跟踪器技能，优先使用。
   • 如果没有本地技能，则参考本地 CLI 帮助和已安装的工具本身：
     • bd --help、bd create --help、bd update --help
     • br --help、br create --help、br update --help
   • 不要让用户查阅此技能之外的公共网络文档。
   • 对于 br，只要可用，面向 Agent 的命令都应使用 --json。

3. 确定当前模式

   • 如果用户已有最终版计划/规格，并希望登记 Beads，则执行创建模式。
   • 如果用户已有 Beads，并希望改进，则执行审核模式（直接跳到第 6 步）。

4. 确认计划已准备就绪（创建模式）

   • 确保 Beads 之外已有最终版计划或规格。
   • 如果计划仍不明确，先要求修改，并在导入前最多迭代 5 次。

5. 将计划转换为跟踪器结构（创建模式）

   • 创建史诗，对应主要里程碑或交付成果。
   • 为具体、可实施的任务创建问题。
   • 对于 bd：
     • 如果史诗下有子里程碑/任务，应将其创建为层级子项，并使用点分隔 ID（如 EPIC.1、EPIC.2），而不是创建为独立的顶层问题。
     • 按照 bd create ... --parent <epic-id> 的流程操作，让 bd 自动分配 EPIC.N ID。
     • 核实返回的 ID。如果 bd 未分配点分隔 ID，则停止并询问用户如何处理。
   • 对于 br：
     • 使用史诗/父项关系，但不要求子项使用点分隔 ID。br 支持父子结构，不受旧版 bd 点分隔 ID 规则的限制。
     • 先创建史诗，再使用 --parent <epic-id> 创建或更新子问题。
     • 在有先后顺序要求时添加明确的依赖，并通过 br dep cycles --json 确保依赖图无环。
   • 添加依赖、顺序约束，以及可并行工作的机会。

6. 审核并完善（创建模式 + 审核模式）

   • 修正含糊的标题、缺失的验收标准或不明确的范围。
   • 确保每个问题都能由一个 Agent 在单项任务中完成。
   • 检查依赖、顺序安排和可并行工作的机会。
   • 补充缺失的设计说明/决策背景。
   • 拆分过大的问题，合并重复项，删除无关内容。
   • 对于 br，优先使用结构化更新，避免自由格式带来的歧义：
     • br update ... --description
     • br update ... --design
     • br update ... --acceptance-criteria
     • br update ... --notes
   • 对于 bd，使用已安装版本提供的本地 bd 字段/工作流来填写描述、设计、备注和验收标准。

7. 补充实现细节

   • 为每个问题添加设计说明、假设和验收标准。
   • 将任务拆分得足够小且明确，让新的 Agent 可以独立接手单项问题。

8. 离开前验证跟踪器状态

   • 对于 br，运行 br dep cycles --json 并确认结果为空。
   • 对于 br，请记住同步是显式操作。如果你更改了跟踪器状态，并且需要更新 JSONL 导出文件，请运行 br sync --flush-only。
   • 对于 bd，遵循已安装版本支持的本地同步／导出工作流。

9. 单次执行

   • 在当前上下文中进行一次有针对性的处理。
   • 如果需要再次处理，请明确说明，并建议单独进行后续运行。

10. 重启 Agent

• 完成此任务后停止。建议为下一个任务启用新的 Agent，以保持会话精简。

输出要求

• 简洁列出你创建的史诗和问题之间的对应关系。
• 说明你使用的跟踪器：bd 或 br。
• 指出需要用户确认的任何依赖项或阻塞项。
• 如果被要求进行超过 5 轮的计划修订，请说明你认为已无法进一步改进。