技巧与窍门
Beads 速查表
Section titled “Beads 速查表”本工作流日常依赖的核心命令。其余命令——日常维护、恢复、协调——见下方链接的上游参考文档。
| 命令 | 功能 |
|---|---|
bd ready / --parent <epic> / --explain |
未被阻塞的工作 / epic 剩余任务 / 就绪原因 |
bd blocked |
等待依赖项的 beads |
bd show <id> |
某个 bead 的完整详情 |
bd query "status=open AND priority<=1" |
复合查询——替代 bd list + jq |
bd count --by-status |
分组计数（--by-priority / --by-type） |
bd epic status <id> / --eligible-only |
该 epic 的完成状态 / 仅显示可关闭的 epic |
bd create "Epic: name" -t epic -p 2 |
新建优先级为 2 的 epic |
bd create "Task: title" -t task --parent <epic> |
在 epic 下创建任务 |
bd worktree create .worktrees/<name> |
在指定路径创建 worktree——裸 <name> 会落在 ./<name>，与你的项目文件同级。路径相对于当前目录解析，因此请在仓库根目录下运行 |
bd import - |
从标准输入的 JSONL 一次性原子创建多个富任务——与 bd export 互为往返，格式始终可查 |
bd q "quick title" |
快速捕获——不打断当前思路，随手记下一个想法 |
bd update <id> --claim |
认领为进行中 |
bd close <id> --reason "..." |
附带证据完成任务 |
bd dep add <child> <depends-on> |
添加依赖关系 |
bd note <id> "context" |
向 bead 追加证据 |
bd remember "insight" / bd memories <kw> / bd forget <id> |
持久化 / 搜索 / 删除学习内容 |
bd list --label <topic> --status all / bd search "<kw>" --status all |
搜索知识库——已标记 kb 标签的延迟 research/design/decision beads（正文词条：--desc-contains "<kw>"；然后用 bd show <id1> <id2> 或 --flat --long -n 10 读取命中）。 |
bd dolt push / pull |
将 beads 数据库同步到/从你的 beads 远端 |
Land the Plane： 每次会话结束时执行 bd close → bd dolt push（同步到你的 beads 远端） → git push（推送到你的代码仓库）。finishing-a-development-branch 技能负责强制执行此流程。
| 我需要… | 调用 |
|---|---|
| 会话开始时定向 | getting-up-to-speed |
| 编码前先设计 | brainstorming |
| 对设计进行压力测试 | stress-test |
| 编写任务计划 | writing-plans |
| 按任务执行并逐任务审查 | subagent-driven-development |
| 在单次会话中执行计划 | executing-plans |
| 编写功能或修复 bug | test-driven-development |
| 调试失败问题 | systematic-debugging |
| 声明工作已完成 | verification-before-completion |
| 获取代码审查 | requesting-code-review |
| 回应审查反馈 | receiving-code-review |
| 合并或关闭分支 | finishing-a-development-branch |
| 并行运行独立任务 | dispatching-parallel-agents |
| 发布后更新文档 | document-release |
| 研究某个主题 | research-driven-development |
| 编写面向用户的文档 | write-documentation |
| 整合或去重记忆 | memory-curator |
using-superpowers 引导技能（会话开始时自动加载）包含完整的路由逻辑；如有疑问，请让 Claude Code 读取它。
安装和配置问题，请参阅入门指南——故障排查。以下是最常见问题的快速解决方法：
技能未加载 — /plugins 应列出 beads-superpowers，/skills 应显示 21 个技能。若未显示，请重新安装。
bd: command not found — 运行 brew install beads 或 npm install -g @beads/bd。
重复上下文注入 — 插件会检测 bd setup claude hooks，并跳过自身的 beads 上下文部分；同一事件的重复触发会由去重标记抑制。若仍出现重复，请运行 bd setup claude --remove。
bd dolt push 失败 — 未配置 beads 远端。如果不需要远程同步，此错误无害。
Windows
Section titled “Windows”SessionStart hook（hooks/session-start）是 bash 脚本。在 Windows 上，多格式包装器 hooks/run-hook.cmd 通过 Git Bash 调用它。该 .cmd 文件同时是有效的批处理文件和 bash 脚本：在 Windows 上，cmd.exe 找到 Git Bash 并重新执行；在 Unix 上，: 命令是空操作，bash 运行其余部分。只要安装了 Git for Windows，无需 WSL 即可正常工作。
技能是纯 Markdown，不含任何平台特定代码。只有 hook 包装器处理平台差异。
| 来源 | 基准版本 | 跟踪内容 |
|---|---|---|
| obra/superpowers | v6.1.1 | 技能内容、新技能、hooks |
| gastownhall/beads | v1.1.0 | CLI 命令、bd prime 格式 |
创建: 2026-06-28最后更新: 2026-07-19