ww-w-ai/bkit-claude-code

解决的问题

bkit 是 Claude Code 的一个插件，将 AI 原生开发转变为结构化系统。它通过引入严格的验证、上下文管理以及多代理编排工作流，解决了「氛围编码」（vibe-coding）问题——即 AI 生成的代码看似合理，但实际可能与原始设计或需求不匹配。

如何工作

bkit 采用「上下文工程」方法，使用一组专用代理和质量门控机制。它通过三个主要命令运行：

• /sprint：通过将多功能发布拆分为「上下文预算内冲刺」（通常 ≤ 75K 令牌）来管理多功能发布，防止 AI 失去焦点或内存耗尽。使用主计划在会话间跟踪进度。
• /pdca：对单个功能执行「计划-执行-检查-行动」（PDCA）循环。这涉及一个由专家代理（PM、CTO、开发者、QA）组成的团队，他们创建 PRD、设计文档和代码，然后验证结果是否符合设计。
• /control：一个单一的自主性旋钮（0-4 级），决定流程在多大程度上无人值守运行，从完全手动到完全自主。

为确保质量，bkit 使用 质量门控（如 M1 matchRate）来衡量设计规范与生成代码之间的对齐程度。如果匹配率低于 90%，系统将自动触发自我修复循环。

适用人群

• AI 编码新手：希望在无需深厚资深工程直觉的情况下交付生产级软件的人。
• 独立开发者和初创构建者：需要一个「盒中团队」来并行处理前端、后端、QA 和安全的人。
• 团队负责人：管理超出单个 AI 会话上下文窗口的复杂发布的人。
• 非英语使用者：能够用多种语言描述需求（支持 8 种语言自动检测）。

主要亮点

• 上下文预算冲刺：通过将项目拆分为可管理的、依赖感知的模块，防止上下文窗口溢出。
• 代码化文档：遵循「文档 = 代码」理念，每个功能都会生成 PRD、设计和报告，这些文件随后成为验证的契约。
• 自动自我修复：使用 gap-detector 和 pdca-iterator 自动修复偏离设计规范的代码。
• 多代理编排：生成专业代理（如 pm-lead、cto-lead、qa-lead）来处理开发生命周期的不同阶段。
• 详细的质量门控：包含 11 个具体门控，包括 7 层数据流完整性检查。