boss

boss-skill

BMAD Harness Engineer — 全自动研发流水线编排 Skill，兼容 Claude Code、OpenClaw、Codex、Antigravity、Hermes。

从需求到部署的完整研发流水线，编排 9 个专业 Agent 自动完成完整研发周期。

定位说明：Boss 提供可审计的 runtime 工作流与质量门禁；子 Agent 仍需按协议配合。门禁与 DAG 由 CLI/hooks 约束，不能等同于「装了就 100% 自动交付」——见下方 质量与评测。

适合 / 不适合用 Boss

适合	不适合（直接让 Agent 改即可）
新 feature：从需求到可运行/可部署	单文件修改、一行 bug、改个变量名
需要 PRD、架构、任务拆解、测试证据	纯读代码、解释实现、代码审查问答
团队希望产物落在 .boss/<feature>/ 可追溯	已有完整 spec，只想快速 patch
API/全栈/带 UI 的中小项目	极小事（<30 分钟人工能做完）

经验法则：若你不需要 .boss/ 里一整套文档与门禁记录，就不要开 /boss。

5 分钟快速上手

目标：用最少角色跑通一条 feature，先熟悉产物目录与 runtime，再开完整 9 Agent 流水线。

1. 安装并启动 Agent

npm install -g @blade-ai/boss-skill
boss-skill
# Claude Code:
claude --plugin-dir "$(boss-skill path)"

2. 在 Agent 里触发（推荐轻量参数）

/boss 做一个 Todo 应用，个人用户本地记录 --roles core --skip-deploy

• --roles core：PM / Architect / Dev / QA，跳过 UI Designer、Scrum Master、DevOps 等重型角色
• --skip-deploy：只做到开发与测试证据，不跑部署阶段

3. 跑完后应看到的目录

.boss/todo-app/
├── design-brief.md      # 需求澄清（非 --quick 时）
├── prd.md
├── architecture.md
├── tasks.md
├── qa-report.md
└── .meta/
    ├── events.jsonl       # 状态真相源（只通过 boss runtime 追加）
    ├── execution.json     # 只读投影（调度看 workflow.nextNodeIds）
    └── workflow-plan.json

4. 本地自检（可选）

boss status todo-app --json
boss runtime inspect-pipeline todo-app
npm run evals                    # 默认 smoke 确定性评测
npm run evals:release            # release + pipeline-compliance

下一步：熟悉后去掉 --roles core，按需加 UI、部署；大项目保留完整 full 流水线。

安装

npm install -g @blade-ai/boss-skill
boss-skill

CLI 自动检测已安装的 Coding Agent，一条命令全部搞定：

Detected 5 agent(s):

  ✅ OpenClaw: ~/.openclaw/skills/boss       (copied + metadata injected)
  ✅ Codex: ~/.codex/skills/boss             (copied + metadata injected)
  ✅ Antigravity: ~/.gemini/.../skills/boss   (copied + metadata injected)
  ✅ Hermes: ~/.hermes/skills/boss           (copied + metadata injected)
  ✅ Claude Code: plugin ready at /path/to/boss-skill
     Use:  claude --plugin-dir "$(boss-skill path)"

Agent	检测条件	安装方式
OpenClaw	~/.openclaw/ 存在	复制到 ~/.openclaw/skills/boss/ + 注入 metadata.openclaw
Codex	~/.codex/ 存在	复制到 ~/.codex/skills/boss/ + 注入 metadata.codex
Antigravity	~/.gemini/antigravity/ 存在	复制到 ~/.gemini/antigravity/skills/boss/ + 注入 metadata.antigravity
Hermes	~/.hermes/ 存在	复制到 ~/.hermes/skills/boss/ + 注入 metadata.hermes
Claude Code	始终	Plugin 模式 — claude --plugin-dir "$(boss-skill path)"

Claude Code 使用

Claude Code 采用原生 Plugin 架构，无需复制文件到项目：

claude --plugin-dir "$(boss-skill path)"

启动后即可使用 /boss 命令、9 个 Agent、所有 hooks 和 skills。

升级：

npm update -g @blade-ai/boss-skill

工作原理

用户一句话 → [需求澄清] → [PM → Architect → UI] → [Tech Lead → Scrum Master] → [Dev → QA] → [DevOps] → 交付
              Step 0        阶段 1: 规划              阶段 2: 评审+拆解          阶段 3: 开发    阶段 4: 部署

需求澄清（Brainstorming）

用户只说了一句话（如"帮我做个记账 APP"），Boss 会自动判断需求完整度：

用户输入	判断	处理
"帮我做个记账 APP"	缺「给谁用」和「核心场景」	→ 自动启动需求澄清
"做一个面向设计师的素材管理工具，能上传、搜索、分类"	三要素齐全	→ 确认后直接开跑

三要素检查：做什么 + 给谁用 + 核心场景。缺任何一个就自动触发 brainstorming，把一句话翻译成一页纸的 design-brief.md。

四阶段流水线

• 阶段 1 — 规划：PM 需求穿透 → Architect 架构设计 → UI Designer 输出 ui-spec.md + ui-design.json（并行）
• 阶段 2 — 评审：Tech Lead 技术评审 → Scrum Master 任务拆解
• 阶段 3 — 开发：Frontend + Backend 并行开发 → 执行中会话对齐 → QA 测试 → 质量门禁
• 阶段 4 — 部署：DevOps 构建部署 → 最终报告

每个阶段由 Harness Engine 驱动，状态机追踪，门禁不可绕过。

执行中会话层

Boss 仍然以文档为正式媒介，但执行过程不再只有“交付文档”这一种协作方式：

• 任意 Agent 可发起 ask、challenge、propose、request_change、escalate、huddle、resolve
• 每条会话都必须锚定到 artifact、task、scope 或 decision
• resolve 后必须落成至少一个 single-owner todo；只有触及正式 source of truth 时才升级为正式修订循环

9 个专业 Agent

Agent	职责
PM	需求穿透 — 显性、隐性、潜在、惊喜需求
Architect	架构设计、技术选型、API 设计
UI Designer	UI/UX 设计规范 + 可渲染设计 JSON
Tech Lead	技术评审、风险评估
Scrum Master	任务分解、测试用例定义
Frontend	UI 组件、状态管理、前端测试
Backend	API、数据库、后端测试
QA	测试执行、Bug 报告
DevOps	构建部署、健康检查

使用方式

触发词：boss mode、/boss、全自动开发、从需求到部署

/boss 做一个 Todo 应用
/boss 用户认证 --template
/boss 给现有项目加用户认证 --skip-ui
/boss 把现有原生 HTML 组件迁移成 shadcn 组件
/boss 快速搭建 API 服务 --skip-deploy --quick
/boss 继续上次中断的任务 --continue-from 3
/boss 轻量模式 --roles core --hitl-level off