bmad-agent-builder
Builds, edits or analyzes Agent Skills through conversational discovery. Use when the user requests to "Create an Agent", "Analyze an Agent" or "Edit an Agent".
- License 许可
- AGPL-3.0
- 最近更新
- 2026-11-05
- Stars
- ★ 7
- Forks
- 4
01 前言 Front Matter
- name
- bmad-agent-builder
- description
- Builds, edits or analyzes Agent Skills through conversational discovery. Use when the user requests to "Create an Agent", "Analyze an Agent" or "Edit an Agent".
- originos-system
- true
02 资源文件 51
- 资产文件assets/BOND-template.md344 B
- 资产文件assets/CAPABILITIES-template.md907 B
- 资产文件assets/capability-authoring-template.md3.7 KB
- 资产文件assets/CREED-template.md1.3 KB
- 资产文件assets/customize-template.toml2.3 KB
- 资产文件assets/first-breath-config-template.md3.2 KB
- 资产文件assets/first-breath-template.md8.2 KB
- 资产文件assets/INDEX-template.md634 B
- 脚本assets/init-sanctum-template.py9.3 KB
- 资产文件assets/memory-guidance-template.md4.1 KB
- 资产文件assets/MEMORY-template.md523 B
- 资产文件assets/PERSONA-template.md714 B
- 资产文件assets/PULSE-template.md1.9 KB
- 资产文件assets/sample-customize-analyst.toml3.5 KB
- 资产文件assets/SKILL-template-bootloader.md3.5 KB
- 资产文件assets/SKILL-template.md3.8 KB
- 参考文档references/agent-type-guidance.md5.9 KB
- 参考文档references/build-process.md23.5 KB
- 参考文档references/edit-guidance.md5.8 KB
- 参考文档references/first-breath-adaptation-guidance.md6.5 KB
- 参考文档references/mission-writing-guidance.md3.8 KB
- 参考文档references/quality-analysis.md7.4 KB
- 参考文档references/quality-dimensions.md5.9 KB
- 参考文档references/quality-scan-agent-cohesion.md8.8 KB
- 参考文档references/quality-scan-customization-surface.md11.1 KB
- 参考文档references/quality-scan-enhancement-opportunities.md15.4 KB
- 参考文档references/quality-scan-execution-efficiency.md8.9 KB
- 参考文档references/quality-scan-prompt-craft.md19.4 KB
- 参考文档references/quality-scan-sanctum-architecture.md9.1 KB
- 参考文档references/quality-scan-script-opportunities.md11.4 KB
- 参考文档references/quality-scan-structure.md12.9 KB
- 参考文档references/report-quality-scan-creator.md12.7 KB
- 参考文档references/sample-capability-authoring.md3.7 KB
- 参考文档references/sample-capability-prompt.md4.0 KB
- 参考文档references/sample-first-breath.md9.0 KB
- 脚本references/sample-init-sanctum.py9.2 KB
- 参考文档references/sample-memory-guidance.md4.2 KB
- 参考文档references/script-opportunities-reference.md13.0 KB
- 参考文档references/script-standards.md4.4 KB
- 参考文档references/skill-best-practices.md9.8 KB
- 参考文档references/standard-fields.md10.7 KB
- 参考文档references/standing-order-guidance.md5.5 KB
- 参考文档references/template-substitution-rules.md4.8 KB
- 脚本scripts/generate-html-report.py25.5 KB
- 脚本scripts/prepass-execution-deps.py11.4 KB
- 脚本scripts/prepass-prompt-metrics.py15.0 KB
- 脚本scripts/prepass-sanctum-architecture.py12.7 KB
- 脚本scripts/prepass-structure-capabilities.py16.6 KB
- 脚本scripts/process-template.py5.7 KB
- 脚本scripts/scan-path-standards.py11.7 KB
- 脚本scripts/scan-scripts.py26.3 KB
03 SKILL.md 正文
Agent Builder
Overview
This skill helps you build AI agents that are outcome-driven — describing what each capability achieves, not micromanaging how. Agents are skills with named personas, capabilities, and optional memory. Great agents have a clear identity, focused capabilities that describe outcomes, and personality that comes through naturally. Poor agents drown the LLM in mechanical procedures it would figure out from the persona context alone.
Act as an architect guide — walk users through conversational discovery to understand who their agent is, what it should achieve, and how it should make users feel. Then craft the leanest possible agent where every instruction carries its weight. The agent's identity and persona context should inform HOW capabilities are executed — capability prompts just need the WHAT.
Args: Accepts --headless / -H for non-interactive execution, an initial description for create, or a path to an existing agent with keywords like analyze, edit, or rebuild.
Your output: A complete agent skill structure — persona, capabilities, optional memory and headless modes — ready to integrate into a module or use standalone.
On Activation
-
Detect user's intent. If
--headlessor-His passed, or intent is clearly non-interactive, set{headless_mode}=truefor all sub-prompts. -
Load available config from
{project-root}/_bmad/config.yamland{project-root}/_bmad/config.user.yaml(root and bmb section). If neither exists, fall back to{project-root}/_bmad/bmb/config.yaml(legacy per-module format). If still missing, and thebmad-builder-setupskill is available, let the user know they can run it at any time to configure. Resolve and apply throughout the session (defaults in parens):{user_name}(default: null) — address the user by name{communication_language}(default: user or system intent) — use for all communications{document_output_language}(default: user or system intent) — use for generated document content{bmad_builder_output_folder}(default:{project-root}/skills) — save built agents here{bmad_builder_reports}(default:{project-root}/skills/reports) — save reports (quality, eval, planning) here
-
Route by intent — see Quick Reference below.
Build Process
The core creative path — where agent ideas become reality. Through conversational discovery, you guide users from a rough vision to a complete, outcome-driven agent skill.
The builder produces three agent types along a spectrum:
- Stateless agent — everything in SKILL.md, no memory, no First Breath. For focused experts handling isolated sessions.
- Memory agent — lean bootloader SKILL.md + sanctum (6 standard files + First Breath). For agents that build understanding over time.
- Autonomous agent — memory agent + PULSE. For agents that operate on their own between sessions.
Agent type is determined during Phase 1 discovery, not upfront. The builder covers building new agents, converting existing ones, editing, and rebuilding from intent.
Load ./references/build-process.md to begin.
Quality Analysis
Comprehensive quality analysis toward outcome-driven design. Analyzes existing agents for over-specification, structural issues, persona-capability alignment, execution efficiency, and enhancement opportunities. Produces a synthesized report with agent portrait, capability dashboard, themes, and actionable opportunities.
Load ./references/quality-analysis.md to begin.
Quick Reference
| Intent | Trigger Phrases | Route |
|---|---|---|
| Build new | "build/create/design a new agent" | Load ./references/build-process.md |
| Existing agent provided | Path to existing agent, or "convert/edit/fix/analyze" | Ask the 3-way question below, then route |
| Quality analyze | "quality check", "validate", "review agent" | Load ./references/quality-analysis.md |
| Unclear | — | Present options and ask |
When given an existing agent, ask:
- Analyze — Run quality analysis: identify opportunities, prune over-specification, get an actionable report with agent portrait and capability dashboard
- Edit — Modify specific behavior while keeping the current approach
- Rebuild — Rethink from core outcomes and persona, using this as reference material, full discovery process
Analyze routes to ./references/quality-analysis.md. Edit routes to ./references/edit-guidance.md. Rebuild routes to ./references/build-process.md with the chosen intent.
Regardless of path, respect headless mode if requested.
04 同仓库更多 Skills
错题梳理与强化练习
根据学生上传的试卷照片,自动识别错题、按题型分类分析薄弱环节,并生成包含原错题和同类型变式题的 Word 练习卷。适用于考试后错题梳理、薄弱知识点巩固、针对性复习、家长帮孩子整理错题、老师为学生生成针对性练习等场景。当用户上传试卷图片、提到错题整理、考试复习、薄弱环节分析、错题卷、练习卷、试卷批改、错题本等关键词时,都应使用此技能。
task-manager
任务管理技能,帮助用户通过对话式界面管理项目中的任务
solution-design
AI Native 解决方案架构师。通过对话式引导将业务本体转化为 Agent 协作架构,推荐建模维度(事/人),规划 Agent 职责与协作关系。Use when user says "设计方案", "规划 Agent 架构", "开始解决方案设计", "生成事的维度方案", or "基于vX.X调整".
skill-creator-app
创建、迭代和优化 OriginOS 技能。当用户想要从零创建技能、改进现有技能、运行评测验证技能效果、或优化技能描述以提升触发准确率时触发。
搜索并安装市场技能
自动根据用户输入的技能关键词或分类,从技能市场搜索匹配项,分析来源平台,下载并安装。
印章盖章
根据用户上传的公司印章图片和 Word 文档,自动去除印章背景生成透明底图,并将印章图片以"浮于文字上方"的布局嵌入到 Word 文档的指定盖章位置。当用户提到盖章、印章、公司章、公章、签章、印章透明、去印章背景、Word盖章、合同盖章等场景时,请使用此技能。