# 珠子 (bd) 使用规则 ## 首次设置 **如果没有找到`bd`命令**，告诉用户： > 运行：`curl -fsSL https://raw.githubusercontent.com/schlenks/superpowers-bd/main/scripts/setup-beads-local.sh | bash` 这会安装珠子，初始化隐身模式，并添加 git worktree 支持。对于团队使用（共享“.beads/”），请使用“bd init”，而不使用“--stealth”。 ## 长篇大论；博士 bd 准备好 # 我可以做什么？ bd update --claim # 我正在开始这个 bd close # 我已经完成了 bd 同步 # 保存我的更改 **关键规则：** * 切勿在 `--acceptance` 中使用分号（触发权限提示） * 切勿使用“bd edit”（打开交互式编辑器） * 在结束会话之前始终运行“bdsync” ## 权限规避（关键） * 切勿在 `--acceptance` 中使用分号：`;` 模式会触发提示。使用逗号或 `$'...\n...'` * 对多行内容使用 `--body-file`：换行符会破坏模式匹配。首先写入临时文件 * 切勿使用“rm”删除临时文件：触发权限提示。留给人类清理 ## 问题操作 * 创建史诗：`bd create --silent --typeepics "Title" --body-file temp/desc.md -p 1` * 创建子任务：`bd create --silent --parent "Title" --body-file temp/desc.md -p 2` * 添加依赖项： `--deps "id1,id2"` （逗号分隔，无空格） * 查看问题：`bd show ` * 更新问题：`bd update --status=in_progress` * 声明问题：`bd update --claim`（原子设置受让人 + in_progress） * 关闭问题：`bd close ` * 关闭多个：`bd close ` * 关闭原因：`bd close --reason "explanation"` * 添加评论：`bd comments add "评论文字"` * 从文件添加注释：`bd comments add -f temp/comment.md` ## 查询命令 * 准备工作（无阻碍）：“bd 准备好” * 被阻止的工作：`bd被阻止` * 搜索问题：`bd search --query "text" --status open` * 带过滤器的列表：`bd list --status open --type task --priority-max 2` * 查看依赖图：`bd graph ` * 检查过时问题：`bd stale --days 14` * Lint 问题：`bd lint --status open` ## 维护命令 * 健康检查：`bd doctor` * 自动修复问题：`bd doctor --fix` * 清理旧问题：`bd cleanup` * Prime AI 上下文：`bd prime` * 数据库信息：`bd info` ## 关键标志 * `--silent`：仅输出 ID（用于脚本） * `--json`: 以JSON格式输出 * `--quiet`: 抑制非必要的输出 * `--type`：bug、特性、任务、史诗、琐事、合并请求、分子、门 * `--parent `：创建为史诗的子级 * `-d "text"`：单行描述（多行首选 `--body-file`） * `--body-file `: 从文件中读取描述 * `-p N`：优先级 0-4（0=关键，4=积压） * `--deps "id1,id2"`：依赖项（被这些阻止） * `--acceptance "..."`：接受标准（没有分号！） * `--external-ref "ref"`：外部链接（例如“sc-1234”） * `-l "label1,label2"`: 标签（以逗号分隔） ## 会话结束协议 bd create "Remaining work" -d "..." -p 2 # 1. 归档剩余工作 bd close # 2. 关闭已完成（解锁依赖项） bd 同步 #3. 强制同步（绕过 30 秒去抖） git status #4.检查发生了什么变化 git add # 5. 阶段代码更改 git commit -m "..." # 6. 提交更改 ## 与技能整合 * `superpowers-bd:plan2beads`：将 Markdown 计划转换为具有子任务的史诗 * `superpowers-bd:writing-plans`：使用 `Depends on:` 和 `Files:` 部分创建计划 * `superpowers-bd:subagent-driven-development`：具有依赖性感知的并行执行 ## 参考文件 * `references/acceptance-and-multiline.md`：编写接受标准或多行描述 * `references/bd-edit-and-sandbox.md`：遇到 bd 编辑使用或沙箱错误 * `references/dependency-management.md`：创建依赖项、修复死锁、验证 dep 结构 * `references/workflow-patterns.md`：运行自主工作循环，检查状态值 * `references/session-end-details.md`：为什么 bd 同步很重要或临时分支处理 * `references/sync-workflow.md`：使用sync子命令，日常维护计划 * `references/troubleshooting.md`：数据库同步问题、工作树限制、合并冲突 * `references/parallel-execution-safety.md`：调度并行子代理、史诗范围、优先级值、ID 格式

珠子

包含技能