核心用法
Buildwright 是一套面向 AI Agent 的轻量级工程规范框架，通过结构化命令实现「理解→测试→实现→文档→验证→审查→交付」的完整开发闭环。核心命令包括：
/bw-work：执行缺陷修复、重构或功能开发，内置 TDD 循环（Red→Green→Refactor）/bw-plan：纯研究型任务，输出调研文档但不改动代码/bw-verify：运行质量门禁（类型检查、Lint、测试、构建）/bw-ship：完整发布流程，含验证、安全审查、Staff Engineer 审查及 PR 创建/bw-analyse：遗留代码分析，自动生成技术栈、架构、规范与风险文档
系统通过 .buildwright/steering/ 目录实现递归式配置管理，默认植入 KISS、YAGNI、DRY、Fail Fast 等工程哲学，并支持项目级技术栈与产品上下文配置。
显著优点
1. 标准化约束：强制文档同步（文档不更新则须声明理由），避免代码与文档脱节
2. 内置质量门禁：TDD、安全审查（支持 Semgrep/Gitleaks/TruffleHog）、Staff Engineer 级代码审查
3. 多平台兼容：支持 Claude Code、OpenCode、Cursor、Codex CLI 等主流 Agent 环境
4. 防御性安全设计：禁止编辑 .env、禁止强制推送或合并 PR、仅暂存当前工作文件
潜在局限
- 依赖 Git 和 GitHub CLI 环境，纯 SVN/Mercurial 项目无法直接使用
- 安全扫描依赖外部工具（Semgrep 等），未内置时需手动配置
- 提示词驱动的「人格化审查」深度受限于底层模型能力
- 轻量级定位意味着复杂企业级审批流（如多级人工 Review）需自行扩展
适合人群
- 使用 AI Agent 进行开发的个人开发者或小型团队
- 追求代码规范与文档一致性的技术负责人
- 需要快速建立工程纪律的初创项目或 brownfield 改造场景
常规风险
- 质量门禁通过不代表生产环境无风险，仍需 CI/CD 流水线兜底
- 提示词审查非真人审计，关键安全场景建议补充人工确认
- 递归读取 steering 文件可能因配置错误导致意外行为，建议版本化管控配置变更