技能

dotbrain 插件会分发它那些与 Brain 配合的技能，相当于已连接项目的操作手册。它们涵盖连接、规划、执行、分诊和 Brain 维护。其中有几个借鉴并改编自 mattpocock/skills。

工作流程展示了它们如何配合。

技能的链接由你自己管理：

• 全局技能在 ~/dotbrain/skills/skills.yaml 里选择
• 项目技能在 brainspaces/<name>/.brain/project.yaml 里选择

选择和同步技能

两种范围都可以选单个技能，也可以选一个技能包目录：

# ~/dotbrain/brainspaces/my-app/.brain/project.yaml
skills:
  - my-collection/specific-skill
  - another-collection

# ~/dotbrain/skills/skills.yaml
global_extra:
  - another-collection

包含 SKILL.md 的目录只选中它自己，即使它下面还有子技能。否则，dotbrain 会递归查找所有包含 SKILL.md 的 子目录，node_modules 除外。重复选中同一来源会去重。不同来源映射到同一个目标名（包括在不区分大小写的文件系统 上只有大小写不同）时，会在改动目标之前失败。路径不存在、不是目录或技能包为空时，也会失败并给出可操作的提示。

dotbrain skills list                         # discover sources
dotbrain skills link                         # current wired checkout
dotbrain skills link --project my-app         # registered checkout
dotbrain skills link --scope global           # explicit global homes
dotbrain skills link --runtime codex           # declared Codex workspace only

在选中的技能包里增删技能，下次同步时就会生效，声明本身不变。被移除的、dotbrain 自己的链接会被清理， 其他来源的条目会保留。projects show、技能目录和 doctor 都使用同样的展开结果。

配置

• wire-brain：创建或修复仓库与其私有 Brain 之间的 Brainspace 连接，包括恢复链接出来的 worktree 的 .brain 和 .beads。第一次使用时，如果缺少 dotbrain CLI 会自动安装。
• dotbrain：操作约定本身。会话启动 hook 会自动注入它；在不运行 hook 的运行时里，可以直接调用它。

规划

• to-design：把一项多步骤的工作写成一份持续更新的 active 设计文档，存进 Brain，并创建一个 epic bead。 适合在拆分之前需要明确设计、或需要一个地方跟踪未知项的工作。
• to-issues：把设计文档拆成可以独立处理的 bead 任务，带验收标准和依赖，并用 --spec-id design:<slug> 把每个 bead 关联回设计。
• grill-decisions：对照项目的术语和决策对计划做压力测试，再把长期有效的结论写进 CONTEXT.md 和 adr/。
• find-unknowns：在确定设计之前，找出陌生领域里的盲点和隐含假设。
• close-design：把设计文档推进到终态：记录证据，把需要保留的内容提升到 adr/ 和 CONTEXT.md，关闭 epic。

执行

• manage-work-graph：在私有工作图里创建、查看、认领、拆分、更新和关闭工作项
• run-execution：完成一个工作项或一批固定的工作项：分派 worker，让每个改动都经过独立审阅，合并，检查， 在限度内修复，必要时上报或恢复
• iterate-design：用 Agent 原生的循环模式推进一份 active 设计文档：规划、实现、验证、反思，通过一个 draft PR 交付，完成后转为 ready 等你审阅，在成功或阻塞时停下

分诊与审阅

• review-gate：运行一次持久的审阅关卡（代码、简化或就绪性），并把结果记录在任务上；代码审阅在你合并 对应 PR 后关闭，其他审阅由你来关闭
• curate-project-context：在公开项目和私有 Brain 中找出并修复过时、重复、放错位置、无法访问或泄露的上下文
• triage-public：对公开任务跟踪里的条目分类，把准备好的工作提升到私有执行中
• review-architecture：审查代码库，寻找可以加深架构的机会

写作

• write-agent-docs：为公开项目文档、私有 Brain 内容、用户自己的技能，以及 Agent 通过指针读到的指引 提供写作规范

Brain 站点

• brain-site：手动调用，用 dotbrain site 创建、维护、构建或预览 Brain 的私有站点， 包括侧边栏、主题和页面渲染检查

学习

学习路径、暂存的概念和会话之间的延续，请看学习你的项目。

• teach-me：跨多个会话，根据 Brain 教你了解自己的项目：在对话中讲解，按一条以 learn: bead 跟踪的 学习路径推进，记录你展示出的理解，并把认可的课程保存到 .brain/learning/

子 Agent

除了技能，dotbrain 还自带能读 Brain 的子 Agent：worker、reviewer、verifier 和 researcher。见 会话上下文。

安装

技能随插件一起提供，每个 Agent 运行时装一次，而不是每个仓库装一次。安装命令见快速开始。 插件装在用户级别，所以它的技能在每个会话里都可用，包括还没连接的仓库。

内置技能直接在 plugin/skills/ 里编辑。