BMAD 全自动项目编排 Skill，适用于所有支持 Skill 的 Coding Agent（Claude Code、OpenClaw、Cursor、Windsurf 等）。
从需求到部署的完整研发流水线，编排 9 个专业 Agent 自动完成完整研发周期。
方式一：克隆到 Coding Agent 的 Skills 目录
| 工具 | Skills 目录 |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Cursor | ~/.cursor/skills/ |
| Windsurf | ~/.windsurf/skills/ |
| Trae | ~/.trae/skills/ |
| OpenAI Codex | ~/.codex/skills/ |
# 以 Claude Code 为例
git clone https://github.com/echoVic/boss-skill.git ~/.claude/skills/boss
# 以 OpenAI Codex 为例
git clone https://github.com/echoVic/boss-skill.git ~/.codex/skills/boss方式二：适配 Google Antigravity (Beta)
Google Antigravity 要求技能存放在项目的 .agent/skills/ 目录下。我们提供了一个适配脚本，可以将 Boss Skill 快速集成到你的 Antigravity 环境中：
# 在你的项目根目录下运行 (假设你已经在项目外克隆了 boss-skill)
/path/to/boss-skill/scripts/adapt-antigravity.sh方式三：适配 OpenAI Codex (Beta)
OpenAI Codex 建议将项目相关的技能存放在 .agents/skills/ 目录下（注意是 agents 复数）。
# 在你的项目根目录下运行
/path/to/boss-skill/scripts/adapt-codex.sh方式四：集成到 OpenCode
OpenCode (sst/opencode) 识别技能的默认路径为项目根目录下的 .opencode/skills/。
# 在你的项目根目录下运行
mkdir -p .opencode/skills/boss
git clone https://github.com/echoVic/boss-skill.git .opencode/skills/boss方式五：手动复制 SKILL.md
将 SKILL.md 复制到你的 Coding Agent 支持的 Slash Command 目录，然后根据需要将 agents/、references/、templates/、scripts/ 目录一起放入同一位置。
方式六： cc-switch 导入（Beta）
cc-switch 导入 zip 时，建议压缩包内包含一个顶层目录，例如 boss/，并让 SKILL.md、agents/、references/、templates/、scripts/ 都位于这个目录下。
推荐直接使用仓库内置打包脚本：
./scripts/package-cc-switch.sh默认会生成：
dist/boss-skill-cc-switch.zip导入步骤：
- 在 cc-switch 中选择导入本地 Skill zip 包
- 选择
dist/boss-skill-cc-switch.zip - 导入完成后，确认 Skill 已出现在 cc-switch 的技能列表中
注意：
- 这是兼容性导入方案，仍按 Beta 看待
- 不建议把
SKILL.md和各目录直接放在 zip 根部；这类包在 cc-switch 中可能会被落到.tmpxxxxxx隐藏目录，导致界面不显示 - 不建议直接使用 GitHub 自动生成的源码 zip；目录结构不可控，容易与 cc-switch 的导入逻辑不匹配
- 如果导入失败，先检查 zip 内是否为
boss/SKILL.md这样的结构
Boss Agent 不直接写代码，而是编排专业 Agent 按四阶段流水线执行：
需求 → [PM → Architect → UI] → [Tech Lead → Scrum Master] → [Dev → QA] → [DevOps] → 交付
阶段 1: 规划 阶段 2: 评审+拆解 阶段 3: 开发 阶段 4: 部署
每个阶段产出文档，下一阶段基于前一阶段产物，测试不通过不能部署。
| Agent | 职责 |
|---|---|
| PM | 需求穿透 — 显性、隐性、潜在、惊喜需求 |
| Architect | 架构设计、技术选型、API 设计 |
| UI Designer | UI/UX 设计规范 |
| Tech Lead | 技术评审、风险评估 |
| Scrum Master | 任务分解、测试用例定义 |
| Frontend | UI 组件、状态管理、前端测试 |
| Backend | API、数据库、后端测试 |
| QA | 测试执行、Bug 报告 |
| DevOps | 构建部署、健康检查 |
触发词：boss mode、/boss、全自动开发、从需求到部署
/boss 做一个 Todo 应用
/boss 用户认证 --template
/boss 给现有项目加用户认证 --skip-ui
/boss 快速搭建 API 服务 --skip-deploy --quick
/boss 继续上次中断的任务 --continue-from 3
/boss 轻量模式 --roles core --hitl-level off
| 参数 | 说明 |
|---|---|
--skip-ui |
跳过 UI 设计（纯 API/CLI） |
--skip-deploy |
跳过部署阶段 |
--quick |
跳过确认节点，全自动 |
--template |
初始化项目级模板目录（.boss/templates/）并暂停流水线 |
--continue-from <1-4> |
从指定阶段继续，跳过已完成阶段 |
--hitl-level <level> |
人机协作：auto（默认）/ interactive / off |
--roles <preset> |
角色预设：full（默认，9 个）/ core（PM/Architect/Dev/QA） |
如果你希望先按项目规范调整文档模板，再开始流水线，可以先执行：
/boss 用户认证 --template
或直接运行初始化脚本：
./scripts/init-project.sh user-auth --template执行后会创建项目级模板目录：
.boss/templates/
├── prd.md.template
├── architecture.md.template
├── ui-spec.md.template
├── tech-review.md.template
├── tasks.md.template
├── qa-report.md.template
└── deploy-report.md.template
后续生成文档时，Boss 会优先读取 .boss/templates/ 中的模板；如果不存在，再回退到 Skill 内置 templates/。
scripts/init-project.sh 仍只负责创建轻量占位文件；Boss 在真正生成某个产物前，会再调用 scripts/prepare-artifact.sh 按同样的优先级准备该文档骨架。
如果 .boss/templates/ 已存在，--template 默认会停止初始化，避免覆盖你已修改的模板。此时可以先删除该目录后重试；如果你明确要覆盖，可使用 --force。
建议保留：
## 摘要section- 核心产物文件名（如
prd.md、tasks.md） - 必要的验收、风险、测试等关键结构
所有产物保存在 .boss/<feature>/ 目录：
.boss/templates/ # 项目级模板（可选，优先于内置 templates/）
.boss/<feature>/
├── prd.md # 产品需求文档
├── architecture.md # 系统架构
├── ui-spec.md # UI 规范（可选）
├── tech-review.md # 技术评审
├── tasks.md # 开发任务
├── qa-report.md # QA 报告
├── deploy-report.md # 部署报告
└── .meta/
└── execution.json # 执行追踪（阶段状态、Token、质量门禁）
三层门禁，不可绕过：
| 门禁 | 时机 | 检查内容 |
|---|---|---|
| Gate 0 | 开发后、测试前 | TypeScript 编译、Lint |
| Gate 1 | QA 后、部署前 | 测试覆盖率 ≥ 70%、无 P0/P1 Bug、E2E 通过 |
| Gate 2 | 部署前（Web） | Lighthouse ≥ 80、API P99 < 500ms |
boss-skill/
├── SKILL.md # 工作流 checklist
├── DESIGN.md # 设计文档
├── agents/ # 9 个 Agent Prompt（按需加载）
│ ├── boss-pm.md
│ ├── boss-architect.md
│ ├── boss-ui-designer.md
│ ├── boss-tech-lead.md
│ ├── boss-scrum-master.md
│ ├── boss-frontend.md
│ ├── boss-backend.md
│ ├── boss-qa.md
│ └── boss-devops.md
├── references/ # 按需加载的规范文档
│ ├── bmad-methodology.md # BMAD 方法论
│ ├── artifact-guide.md # 产物保存规范
│ ├── testing-standards.md # 测试标准
│ └── quality-gate.md # 质量门禁
├── templates/ # 产物模板
│ ├── prd.md.template
│ ├── architecture.md.template
│ ├── ui-spec.md.template
│ ├── tech-review.md.template
│ ├── tasks.md.template
│ ├── qa-report.md.template
│ └── deploy-report.md.template
└── scripts/
├── init-project.sh # 项目初始化脚本（创建轻量占位文件）
├── resolve-template.sh # 模板路径解析（项目模板优先）
└── prepare-artifact.sh # 按模板优先级准备当前产物骨架
基于 BMAD（Breakthrough Method of Agile AI-Driven Development）方法论，详见 references/bmad-methodology.md 和 DESIGN.md。
MIT