用途:在项目中初始化 Beat 配置,或更新已有配置(产物语言、测试框架、规则),并根据技术栈推荐测试框架。触发示例:“Set up Beat”“Initialize Beat”“Configure Beat for this project”“Update Beat config”。不适用于直接编辑 beat/config.yaml(直接改文件即可)、配置非 Beat 工具,或创建变更/编写功能文件(用 /beat:design)。
主要流程:1) 检查 beat/config.yaml 是否存在;存在则读取展示并询问更新或保留,不存在则创建。2) 检查 superpowers 依赖(技能列表中有 superpowers:* 即视为可用);未安装时提示可用命令 /plugin marketplace add obra/superpowers 安装,也可继续。3) 询问产物语言:English (en) 默认、繁體中文 (zh-TW)、简体中文 (zh-CN) 或自定义 BCP 47 标签。4) 收集项目上下文:可由用户描述,或从 package.json、Cargo.toml、go.mod 等清单及测试配置自动检测技术栈与主语言。5) 配置测试框架:先问项目类型(Web 应用、API 服务、CLI 工具、库/SDK),再按语言与类型推荐行为测试和 E2E 框架组合,用户可接受默认或自定义;若明确不需要测试,可设 testing.required: false,不应坚持。库类项目通常省略 E2E。6) 可选询问产物规则(proposal、gherkin、design、tasks、adr);若 docs/adr/TEMPLATE.md 已存在会被自动用作 ADR 骨架。7) 按 references/config-schema.md 写入 beat/config.yaml,并创建 beat/changes/ 与 beat/features/ 目录。beat/CONTEXT.md、docs/adr/、beat/ARCHITECTURE.md 等为惰性创建,首次需要时才出现,小项目可能始终不需要。最后展示摘要:配置文件、目录、superpowers 状态、测试框架,并提示可运行 /beat:design 或 /beat:explore。
限制与护栏:不得在未询问的情况下覆盖已有配置;配置可选,最小化设置只需创建目录;写入前按 schema 校验;上下文应简洁(2KB 软限、50KB 硬限);框架推荐仅为建议,用户可覆盖。