用途：为任意代码库一键完成面向 AI 辅助开发的初始化，生成 AI 工具所需的上下文文件、配置环境，并检测已有配置，只补充缺失部分。
主要能力：
- --project（默认）：初始化当前项目。检查并安装 Beads 任务追踪（必要时执行 npm install -g @beads/bd），生成 AGENTS.md（项目上下文）、创建 CLAUDE.md 链接、生成 STYLE_GUIDE.md，初始化 .beads/（bd init），创建 .claude/learnings/ 与 docs/claude/ 目录。
- --global：配置机器级设置 ~/.claude/settings.json，包括通知钩子与推荐插件清单；只报告缺失插件并提供安装命令，不自动安装。
- --check：只读审计，报告环境中已配置、缺失及需注意项，不写入任何内容。
必要用法：
- 无参数或 --project：初始化项目。
- 生成 CLAUDE.md 链接：macOS/Linux 使用 ln -sf AGENTS.md CLAUDE.md；Windows 使用 copy AGENTS.md CLAUDE.md（因符号链接需开发者模式或管理员权限）。
- Beads 常用命令：bd create、bd list、bd show <id>、bd update <id> --status <status>、bd close <id>；提交前运行 bd backup，.beads/ 变更随提交一起纳入。
- 通知钩子按平台不同：macOS 使用 afplay 播放 Funk 声音，Linux 可建议 paplay 或 aplay，Windows/WSL 可建议 PowerShell 播放系统声音。
适用场景：需要在项目中统一 AI 上下文与编码规范、接入 Beads 任务管理、或在多台机器上统一 Claude Code 全局配置的开发者。
限制与安全规则：绝不覆盖已存在的 CLAUDE.md、AGENTS.md、STYLE_GUIDE.md，除非用户明确确认并先备份（如 cp AGENTS.md AGENTS.md.bak）；不使用 Write 工具改写已有文件，只可追加；不替用户做选择，需先给出选项等待确认。STYLE_GUIDE.md 只记录代码中实际观察到的模式，不得臆造约定；模式不一致时指出并请用户决定。若只缺一个文件，则优雅跳过其余步骤。具体价格、平台支持范围等细节暂未提供。