by echoVic
Boss Skill - BMAD 全自动研发流水线(多 Agent 编排)
# Add to your Claude Code skills
git clone https://github.com/echoVic/boss-skillLast scanned: 5/22/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-05-22T07:44:52.014Z",
"semgrepRan": false,
"npmAuditRan": true,
"pipAuditRan": true
}boss-skill is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by echoVic. Boss Skill - BMAD 全自动研发流水线(多 Agent 编排). It has 546 GitHub stars.
Yes. boss-skill passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/echoVic/boss-skill" and add it to your Claude Code skills directory (see the Installation section above).
boss-skill is primarily written in TypeScript. It is open-source under echoVic on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh boss-skill against similar tools.
No comments yet. Be the first to share your thoughts!

BMAD Harness Engineer — 全自动研发流水线编排 Skill,兼容 Claude Code、OpenClaw、Codex、Antigravity、Hermes。
从需求到部署的完整研发流水线,编排 9 个专业 Agent 自动完成完整研发周期。
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 采用原生 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: 部署
用户只说了一句话(如"帮我做个记账 APP"),Boss 会自动判断需求完整度:
| 用户输入 | 判断 | 处理 |
|---|---|---|
| "帮我做个记账 APP" | 缺「给谁用」和「核心场景」 | → 自动启动需求澄清 |
| "做一个面向设计师的素材管理工具,能上传、搜索、分类" | 三要素齐全 | → 确认后直接开跑 |
三要素检查:做什么 + 给谁用 + 核心场景。缺任何一个就自动触发 brainstorming,把一句话翻译成一页纸的 design-brief.md。
ui-spec.md + ui-design.json(并行)每个阶段由 Harness Engine 驱动,状态机追踪,门禁不可绕过。
Boss 仍然以文档为正式媒介,但执行过程不再只有“交付文档”这一种协作方式:
ask、challenge、propose、request_change、escalate、huddle、resolveartifact、task、scope 或 decisionresolve 后必须落成至少一个 single-owner todo;只有触及正式 source of truth 时才升级为正式修订循环| 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
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) |
每个阶段遵循状态转换:pending → running → completed/failed → retrying → running
状态变更通过 boss runtime ... 直接追加到 .meta/events.jsonl,再由 CLI runtime 的 projector 物化为只读的 .meta/execution.json。
boss runtime <command> 是唯一的 runtime-first surface。对外能力以 Boss CLI 为准,不再把 shell wrapper 视为兼容契约。
Agent-facing boss commands use these common options where applicable; run --describe on a command for its exact JSON schema:
--json: structured output; non-TTY stdout defaults to JSON--describe: JSON command schema--dry-run: structured action plan for writes or risky operations--json-input=<json|->: JSON input payload--fields=<a,b> and --limit=<n>: bounded output--yes: required only for high-risk non-interactive commands that need an extra confirmation; for project init --force, --force is the overwrite confirmationStructured errors are written to stderr as {"error":{...}} and include code, message, input, retryable, and suggestion.
| 编排动作 | Runtime CLI |
|---|---|
初始化流水线(低阶;project init 未执行时) |
boss runtime init-pipeline |
| 恢复 Workflow 执行图并查看节点级复用决策 | boss runtime resume <feature> --from-run <run-id> |
| 查询 ready artifacts | boss runtime get-ready-artifacts |
| 记录产物完成 | boss runtime record-artifact |
| 更新阶段状态 | boss runtime update-stage |
| 更新 Agent 状态 | boss runtime update-agent |
| 执行门禁 | boss runtime evaluate-gates |
| 注册插件 | boss runtime register-plugins <feature> |
| 执行插件 Hook | boss runtime run-plugin-hook |
| 检查阶段状态 | boss runtime check-stage |
| 回放事件/快照 | boss runtime replay-events |
| 诊断流水线状态 | boss runtime inspect-pipeline |
| 查看最近事件 | boss runtime inspect-events |
| 查看 progress 流 | boss runtime inspect-progress |
| 查看插件生命周期 | boss runtime inspect-plugins |
| 生成流水线报告 | boss runtime generate-summary |
| 生成诊断页 | boss runtime render-diagnostics |
| 开启会话 | boss runtime open-conversation |
| 追加会话消息 | boss runtime append-conversation-message |
| 解决会话 | boss runtime resolve-conversation |
| 查看会话列表 | boss runtime list-conversations |
| 物化待办 | boss runtime materialize-todo |
| 查看待办列表 | boss runtime list-todos |
| 提取记忆 | boss runtime extract-memory |
| 查询记忆 | boss runtime query-memory |
| 构建记忆摘要 | boss runtime build-memory-summary |
| 记录反馈 | boss runtime record-feedback |
| 重试 Agent | boss runtime retry-agent |
| 重试阶段 | boss runtime retry-stage |
Pack 选择和插件生命周期现在都是 runtime 事件,不再只是 shell 侧副作用:
PackApplied 进入状态真相。PluginDiscovered / PluginActivated 进入事件流。PluginHookExecuted / PluginHookFailed 进入事件流。Workflow 定义和运行实例分离:
.boss/<feature>/.meta/workflow-plan.json。workflowPlanPath / workflowHash / packHash / artifactDagHash 描述可审计的 Workflow 定义。runId 描述本次运行实例;boss runtime resume <feature> --from-run <run-id> 会重新加载 workflow plan,按节点输入指纹判断 reuse / run / skip,并把结果物化到 execution.workflow.nodes。execution.workflow.nextNodeIds 是机器可读的下一批可调度节点;DAG loop 应优先读取它,再派发对应 Agent 或 Gate。GateEvaluated / WaveVerified 会更新对应 workflow node 状态,让门禁和 Evidence Wave 不再只是外围检查。四期排障 CLI 已开始补齐:
boss runtime inspect-pipeline 查看当前阶段、ready artifacts、active agents、pack、plugins、metrics。boss runtime inspect-events 查看最近事件并支持按类型过滤。boss runtime inspect-progress 查看 progress flow。boss runtime inspect-plugins 查看 active/discovered/activated/executed/failed 插件状态。boss runtime check-stage / boss runtime replay-events 直接承担状态排障和事件回放。四期报告 runtime 已抽离为独立的 summary model + renderer:
boss runtime generate-summary 是 canonical summary surface,默认输出 Markdown,也支持 --json 和 --stdout。packages/boss-cli/src/runtime/report/summary-model.ts 负责从 execution.json 构建统一 summary model。packages/boss-cli/src/runtime/report/render-markdown.ts 负责渲染 summary-report.md。packages/boss-cli/src/runtime/report/render-json.ts 负责渲染机器可读的 JSON 报告。packages/boss-cli/src/runtime/report/render-html.ts + boss runtime render-diagnostics 负责生成最小 HTML 诊断页。三层门禁,不可绕过:
| 门禁 | 时机 | 检查内容 |
|---|---|---|
| Gate 0 | 开发后、测试前 | TypeScript 编译、Lint |
| Gate 1 | QA 后、部署前 | 测试覆盖率 ≥ 70%、无 P0/P1 Bug、E2E 通过 |
| Gate 2 | 部署前(Web) | Lighthouse ≥ 80、API P99 < 500ms |
支持通过插件扩展自定义门禁。
通过环境变量控制 hook 运行级别:
| 环境变量 | 说明 | 值 |
|---|---|---|
BOSS_HOOK_PROFILE |
Hook 运行级别 | minimal / standard(默认)/ strict |
BOSS_DISABLED_HOOKS |
禁用指定 hook | 逗号分隔的 Hook ID |
11 个 Node.js hooks 覆盖完整 Agent 生命周期:session 启停、文件读写守卫、bash 命令捕获、子 Agent 调度、流水线退出保护、通知。
所有子代理使用标准化状态报告:
| 状态 | 含义 |
|---|---|
DONE |
任务完成 |
DONE_WITH_CONCERNS |
完成但有疑虑 |
NEEDS_CONTEXT |
需要更多上下文 |
BLOCKED |
被阻塞,无法继续 |
REVISION_NEEDED |
会话触及正式真相源,需要进入修订循环 |
状态块在相关时还要携带 conversation_id、resolution_summary、todo_ids 和 revision_target,让执行中会话能够回放到具体待办或正式修订目标。
.boss/.session-state.json通过 .boss/plugins/ 注册自定义 gate、agent 或 pipeline 模板包。内置 5 套 Pipeline Pack(default、core、api-only、web-app、solana-contract)。
Boss 支持项目级模板覆盖:
/boss 用户认证 --template # 初始化 .boss/templates/
模板查找优先级:.boss/templates/ > 包内置 skill/templates/(安装后为 Skill 根目录下的 templates/)。
.boss/<feature>/
├── design-brief.md # 需求澄清产出(可选)
├── prd.md # 阶段 1: 产品需求
├── architecture.md # 阶段 1: 系统架构
├── ui-spec.md # 阶段 1: UI 规范(可选)
├── ui-design.json # 阶段 1: 可渲染 UI 设计(可选)
├── tech-review.md # 阶段 2: 技术评审
├── tasks.md # 阶段 2: 开发任务
├── qa-report.md # 阶段 3: QA 报告
├── deploy-report.md # 阶段 4: 部署报告
├── summary-report.md # 流水线报告(Harness 自动生成)
└── .meta/
└── execution.json # 执行追踪(状态机 + 门禁 + 指标)
可在交互式环境运行 boss design preview <feature> 预览 `.boss/<featur