用途:作为 OpenSpec 与 Beads 之间的桥接器,将已批准的 OpenSpec 规格转换为可追踪的 Beads 工单,并保持可追踪性、主动发现实现缺口。
激活时机:用户运行 openspec apply <change>、说“implement this spec”或“start working on X”,或在批准提案后提到“ready”“let's go”;也可手动要求“convert spec to beads”或“create issues for this change”。查看规格、创建提案、评审规格时不激活。
主要能力:读取 openspec/changes/<change>/ 下的 proposal.md、tasks.md、specs/*/spec.md、design.md,先做批判性分析(任务范围、依赖、缺失的测试/文档/部署、潜在风险),再智能转换而非机械 1:1 映射;按优先级规则分配优先级,按描述推断类型,自动构建依赖链,主动检测缺失的回归计划、限流、错误处理、监控和测试,并创建 Epic 工单与发现类工单,最后输出按优先级分组的可执行报告。
必要用法:先用命令 openspec show <change-name> 与 bd list --json 检查前置条件;若 Beads 未初始化,运行 bd init --prefix <project-name>。
适用场景:在团队把规划规范落地为开发任务、需要追踪状态与依赖关系时使用。
限制:仅适用于已存在且格式正确的 OpenSpec 变更;tasks.md 解析失败时只能尽力转换;资料未提供具体安装命令、平台范围、收费方式或效果保证。