用途
该技能用于按照作者偏好的配置，初始化（initialize）或引导（bootstrap）beads（bd）问题跟踪器。它适用于两种仓库状态：没有 .beads/ 目录时执行初始化；.beads/ 已被 git 跟踪且没有 .beads/embeddeddolt/ 或 .beads/dolt/ 时执行引导。如果 .beads/ 已有数据库，技能会说明已设置完成，并可选择将偏好应用到旧初始化中。
主要能力
- 初始化模式：运行
bd init，然后修改 init 刚创建的提交，将作者设置纳入该提交。设置包括：export.auto: false（写入.beads/config.yaml）、在.beads/.gitignore中忽略*.jsonl、在根.gitignore和.beads/.gitignore中忽略*.gate.lock*、将AGENTS.md和CLAUDE.md精简为指向.agents/skills/beads/SKILL.md的短指针、确保.beads/目录权限为 0700。 - 引导模式：运行
bd bootstrap从 git origin 克隆 Dolt 数据库。beads.role始终设为maintainer。引导不会恢复每个克隆的接线，可能在过程中编辑被跟踪的文件；技能会报告并还原.beads/config.yaml中由 bootstrap 添加的sync.remote。 - 角色配置：
beads.role写入本地.git/config（从不提交）。初始化时询问仓库是用户自己的还是其贡献的 fork，fork 使用contributor；引导时固定为maintainer。 - 报告：输出结构化报告，包含 bd 实际做了什么、应用的设置、引导足迹、已验证项和未完成项，并优先列出需要用户注意的事项。
使用方式
- 从仓库根目录运行（
cd "$(git rev-parse --show-toplevel)"）。 - 根据仓库状态选择模式：无
.beads/时阅读并遵循references/initialize.md；.beads/被跟踪且无数据库时阅读并遵循references/bootstrap.md；已有数据库时说明已设置，可选应用设置步骤。 - 规则：绝不在已有
.beads/上运行bd init；不传--reinit-local、--force、--discard-remote；只按路径暂存 bd 自己的文件，不使用git add -A；仅当 HEAD 提交主题为bd init: initialize beads issue tracking时才使用--amend；绝不推送；显式传递--non-interactive和--yes。 - 使用
git show --stat、bd config get、git check-ignore验证结果，并报告实际状态而非意图。
适用场景
- 新仓库需要按照作者偏好设置 beads 问题跟踪。
- 克隆的仓库已跟踪
.beads/但缺少本地数据库，需要引导。 - 希望将作者偏好应用到旧的 bd 初始化中。
限制
- 不推送任何更改。
- 不处理已有数据库的
.beads/目录（仅可应用设置）。 - 依赖 bd 1.3.0 的行为（例如无跳过提交的标志）。
beads.role只从 git config 读取，新克隆在设置前会打印warning: beads.role not configured（GH#2950）。.beads/目录权限在 git clone 时由 umask 决定，可能不是 0700。