boss-skill
BMAD Harness Engineer — 全自动研发流水线编排 Skill，兼容 Claude Code、OpenClaw、Codex、Antigravity。
从需求到部署的完整研发流水线，编排 9 个专业 Agent 自动完成完整研发周期。
安装
npm install -g @blade-ai/boss-skill
boss-skill
CLI 自动检测已安装的 Coding Agent，一条命令全部搞定：
Detected 4 agent(s):
✅ OpenClaw: ~/.openclaw/skills/boss (copied + metadata injected)
✅ Codex: ~/.codex/skills/boss (copied + metadata injected)
✅ Antigravity: ~/.gemini/.../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 |
| 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 设计规范（并行）
- 阶段 2 — 评审：Tech Lead 技术评审 → Scrum Master 任务拆解
- 阶段 3 — 开发：Frontend + Backend 并行开发 → QA 测试 → 质量门禁
- 阶段 4 — 部署：DevOps 构建部署 → 最终报告
每个阶段由 Harness Engine 驱动，状态机追踪，门禁不可绕过。
9 个专业 Agent
| 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 把现有原生 HTML 组件迁移成 shadcn 组件
/boss 快速搭建 API 服务 --skip-deploy --quick
/boss 继续上次中断的任务 --continue-from 3
/boss 轻量模式 --roles core --hitl-level off
Boss 支持自然语言需求：执行前会先推导一个英文 kebab-case 的 feature slug 作为产物目录名，例如“做一个 Todo 应用”会落到 .boss/todo-app/。如果用户只是补充技术约束或团队偏好，例如“不要用原生 html 组件，我们引入了 shadcn”，Boss 会暂停并询问这条约束要应用到哪个 feature，而不是新建目录。
| 参数 | 说明 |
|---|
--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） |
Harness Engine
状态机
每个阶段遵循状态转换：pending → running → completed/failed → retrying → running
状态变更通过 runtime 直接追加到 .meta/events.jsonl，再由 runtime/projectors/materialize-state.js 物化为只读的 .meta/execution.json。
Runtime / CLI 编排面
runtime/cli/*.js 与 runtime/cli/lib/pipeline-runtime.js 是唯一的 runtime-first surface。对外能力以 runtime CLI 为准，不再把 shell wrapper 视为兼容契约。
| 编排动作 | Runtime CLI |
|---|
| 初始化流水线 | runtime/cli/init-pipeline.js |
| 查询 ready artifacts | runtime/cli/get-ready-artifacts.js |
| 记录产物完成 | runtime/cli/record-artifact.js |
| 更新阶段状态 | runtime/cli/update-stage.js |
| 更新 Agent 状态 | runtime/cli/update-agent.js |
| 执行门禁 | runtime/cli/evaluate-gates.js |
| 注册插件 | runtime/cli/register-plugins.js |
| 执行插件 Hook | runtime/cli/run-plugin-hook.js |
| 检查阶段状态 | runtime/cli/check-stage.js |
| 回放事件/快照 | runtime/cli/replay-events.js |
| 诊断流水线状态 | runtime/cli/inspect-pipeline.js |
| 查看最近事件 | runtime/cli/inspect-events.js |
| 查看 progress 流 | runtime/cli/inspect-progress.js |
| 查看插件生命周期 | runtime/cli/inspect-plugins.js |
| 生成流水线报告 | runtime/cli/generate-summary.js |
| 生成诊断页 | runtime/cli/render-diagnostics.js |
Pack 选择和插件生命周期现在都是 runtime 事件，不再只是 shell 侧副作用：
- pack 选择通过
PackApplied 进入状态真相。
- 插件发现/激活通过
PluginDiscovered / PluginActivated 进入事件流。
- 插件 hook 执行通过
PluginHookExecuted / PluginHookFailed 进入事件流。