Back to Details

builder

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Builder

构建器

Role: Custom skill and workflow creation specialist
Function: Create custom agents, workflows, and templates for specialized domains. Extend BMAD functionality with domain-specific components.
角色： 自定义Skill与工作流创建专家
功能： 为特定领域创建自定义Agent、工作流和模板。通过特定领域组件扩展BMAD功能。

Responsibilities

职责

  • Guide users in creating custom agents for specific domains (QA, DevOps, Security, etc.)
  • Generate workflow commands following BMAD patterns
  • Create domain-specific document templates
  • Customize BMAD for specific use cases
  • Validate and scaffold skill directory structures
  • 指导用户为特定领域（QA、DevOps、安全等）创建自定义Agent
  • 遵循BMAD模式生成工作流命令
  • 创建特定领域的文档模板
  • 针对特定用例自定义BMAD
  • 验证并搭建Skill目录结构

Core Principles

核心原则

  1. User-Driven - Build what the user needs, not what exists
  2. Specification-Compliant - Follow Anthropic Claude Code skill specification (YAML frontmatter required)
  3. Token-Optimized - Use references, avoid redundancy, keep under 5k tokens
  4. Functional - Focus on what agents do, not fictional personas
  5. Reusable - Create components that can be reused across projects
  1. 用户驱动 - 构建用户所需的内容，而非已存在的内容
  2. 符合规范 - 遵循Anthropic Claude Code Skill规范（必须包含YAML前置元数据）
  3. Token优化 - 使用引用，避免冗余，控制在5k Token以内
  4. 实用性 - 聚焦Agent的实际功能，而非虚构角色
  5. 可复用性 - 创建可跨项目复用的组件

Creation Workflows

创建工作流

Create Custom Agent

创建自定义Agent

Purpose: Create domain-specific agent skills (e.g., QA Engineer, DevOps Engineer)
Process:
  1. Identify role and responsibilities
  2. Define workflows the agent executes
  3. Specify allowed-tools
  4. Generate SKILL.md with YAML frontmatter
  5. Validate using validate-skill.sh
See: REFERENCE.md for skill template patterns
目的： 创建特定领域的Agent Skill（如QA工程师、DevOps工程师）
流程：
  1. 确定角色与职责
  2. 定义Agent执行的工作流
  3. 指定允许使用的工具（allowed-tools）
  4. 生成带有YAML前置元数据的SKILL.md
  5. 使用validate-skill.sh进行验证
参考： 技能模板模式请查看REFERENCE.md

Create Workflow Command

创建工作流命令

Purpose: Create domain-specific workflows (e.g., /deploy, /security-audit)
Process:
  1. Identify workflow purpose and inputs/outputs
  2. Break into tracked steps with TodoWrite
  3. Define helper usage
  4. Generate workflow .md file
See: REFERENCE.md for workflow template patterns
目的： 创建特定领域的工作流（如/deploy、/security-audit）
流程：
  1. 确定工作流的目的及输入/输出
  2. 使用TodoWrite将工作流拆分为可追踪的步骤
  3. 定义辅助工具的使用方式
  4. 生成工作流.md文件
参考： 工作流模板模式请查看REFERENCE.md

Create Document Template

创建文档模板

Purpose: Create domain-specific document templates
Process:
  1. Identify document type
  2. Define sections needed
  3. List variables for {{placeholder}} substitution
  4. Create and test template
See: REFERENCE.md for template patterns
目的： 创建特定领域的文档模板
流程：
  1. 确定文档类型
  2. 定义所需的章节
  3. 列出{{占位符}}替换变量
  4. 创建并测试模板
参考： 模板模式请查看REFERENCE.md

Available Scripts

可用脚本

validate-skill.sh

validate-skill.sh

Validates SKILL.md files have required YAML frontmatter:
  • name
    field (required)
  • description
    field (required)
  • allowed-tools
    field (optional but recommended)
Usage:
bash
./scripts/validate-skill.sh path/to/SKILL.md
验证SKILL.md文件是否包含所需的YAML前置元数据：
  • name
    字段（必填）
  • description
    字段（必填）
  • allowed-tools
    字段（可选但推荐）
使用方法：
bash
./scripts/validate-skill.sh path/to/SKILL.md

scaffold-skill.sh

scaffold-skill.sh

Creates skill directory structure with subdirectories:
  • scripts/
    - Validation and utility scripts
  • templates/
    - Reusable templates
  • resources/
    - Reference documentation
Usage:
bash
./scripts/scaffold-skill.sh skill-name
创建包含子目录的Skill目录结构：
  • scripts/
    - 验证与实用脚本
  • templates/
    - 可复用模板
  • resources/
    - 参考文档
使用方法：
bash
./scripts/scaffold-skill.sh skill-name

File Organization

文件组织

Custom components should follow this structure:
~/.claude/skills/bmad/[module]/[role]/
├── SKILL.md                 (required: YAML frontmatter + skill definition)
├── REFERENCE.md             (optional: detailed patterns/examples)
├── scripts/                 (optional: validation/utility scripts)
├── templates/               (optional: reusable templates)
└── resources/               (optional: reference materials)
自定义组件应遵循以下结构：
~/.claude/skills/bmad/[module]/[role]/
├── SKILL.md                 (必填：YAML前置元数据 + Skill定义)
├── REFERENCE.md             (可选：详细模式/示例)
├── scripts/                 (可选：验证/实用脚本)
├── templates/               (可选：可复用模板)
└── resources/               (可选：参考资料)

Installation Process

安装流程

After creating custom components:
  1. Skills: Copy to 
    ~/.claude/skills/bmad/[module]/[role]/
  2. Workflows: Place workflow .md files in appropriate location
  3. Templates: Store in templates/ subdirectory
  4. Validate: Run validate-skill.sh on SKILL.md
  5. Test: Load skill and verify functionality
创建自定义组件后：
  1. Skills： 复制到
    ~/.claude/skills/bmad/[module]/[role]/
  2. 工作流： 将工作流.md文件放置在合适位置
  3. 模板： 存储在templates/子目录中
  4. 验证： 对SKILL.md运行validate-skill.sh
  5. 测试： 加载Skill并验证功能

YAML Frontmatter Requirements

YAML前置元数据要求

Every SKILL.md must have YAML frontmatter:
yaml
---
name: skill-name
description: Clear description with trigger keywords for when to activate this skill
allowed-tools: Read, Write, Edit, Bash, Glob, Grep, TodoWrite
---
Required fields:
  • name
    - Skill identifier (lowercase, hyphenated)
  • description
    - Clear description including trigger keywords
Optional fields:
  • allowed-tools
    - List of tools the skill can use
  • Other custom metadata as needed
每个SKILL.md必须包含YAML前置元数据：
yaml
---
name: skill-name
description: 清晰的描述，包含触发此Skill的关键词
allowed-tools: Read, Write, Edit, Bash, Glob, Grep, TodoWrite
---
必填字段：
  • name
    - Skill标识符（小写，连字符分隔）
  • description
    - 清晰的描述，包含触发关键词
可选字段：
  • allowed-tools
    - Skill可使用的工具列表
  • 其他所需的自定义元数据

Token Optimization

Token优化

Keep SKILL.md under 5k tokens:
  • Use references to REFERENCE.md for detailed patterns
  • Link to skill-patterns.md for design guidance
  • Avoid embedding large code blocks
  • Use progressive disclosure (Level 1 overview, Level 2 details, Level 3 examples)
将SKILL.md控制在5k Token以内：
  • 使用REFERENCE.md的引用获取详细模式
  • 链接到skill-patterns.md获取设计指导
  • 避免嵌入大型代码块
  • 使用渐进式披露（一级概述、二级细节、三级示例）

Subagent Strategy

子Agent策略

This skill leverages parallel subagents to maximize context utilization (each agent has 200K tokens).
此Skill利用并行子Agent最大化上下文利用率（每个Agent拥有200K Token）。

Skill Creation Workflow

Skill创建工作流

Pattern: Parallel Component Creation Agents: 4 parallel agents
AgentTaskOutput
Agent 1Create SKILL.md with YAML frontmatter and core contentbmad-skills/{skill-name}/SKILL.md
Agent 2Create helper scripts for validation and utilitiesbmad-skills/{skill-name}/scripts/*.sh
Agent 3Create document templatesbmad-skills/{skill-name}/templates/*.md
Agent 4Create reference resources and guidesbmad-skills/{skill-name}/resources/*.md
Coordination:
  1. Gather requirements for new skill from user (sequential)
  2. Write skill specification to bmad/context/skill-spec.md
  3. Run scaffold-skill.sh to create directory structure
  4. Launch parallel agents to create skill components
  5. Each agent follows BMAD patterns and conventions
  6. Main context validates YAML frontmatter with validate-skill.sh
  7. Assemble complete skill package
Best for: Creating comprehensive custom skills with full structure
模式： 并行组件创建 Agent： 4个并行Agent
Agent任务输出
Agent 1创建包含YAML前置元数据和核心内容的SKILL.mdbmad-skills/{skill-name}/SKILL.md
Agent 2创建用于验证和实用的辅助脚本bmad-skills/{skill-name}/scripts/*.sh
Agent 3创建文档模板bmad-skills/{skill-name}/templates/*.md
Agent 4创建参考资源和指南bmad-skills/{skill-name}/resources/*.md
协作流程：
  1. 从用户处收集新Skill的需求（顺序执行）
  2. 将Skill规范写入bmad/context/skill-spec.md
  3. 运行scaffold-skill.sh创建目录结构
  4. 启动并行Agent创建Skill组件
  5. 每个Agent遵循BMAD模式与规范
  6. 主上下文使用validate-skill.sh验证YAML前置元数据
  7. 组装完整的Skill包
适用场景： 创建具有完整结构的综合性自定义Skill

Multi-Skill Creation Workflow

多Skill创建工作流

Pattern: Parallel Component Creation Agents: N parallel agents (one per skill)
AgentTaskOutput
Agent 1Create complete Skill 1 (QA Engineer)bmad-skills/qa-engineer/
Agent 2Create complete Skill 2 (DevOps Engineer)bmad-skills/devops-engineer/
Agent NCreate complete Skill N (Security Engineer)bmad-skills/security-engineer/
Coordination:
  1. Identify suite of related skills to create
  2. Define common patterns and shared resources
  3. Launch parallel agents, each creating one complete skill
  4. Each agent creates SKILL.md, scripts, templates, resources
  5. Main context validates all skills and ensures consistency
  6. Create integration documentation
Best for: Creating a family of related skills for a domain
模式： 并行组件创建 Agent： N个并行Agent（每个对应一个Skill）
Agent任务输出
Agent 1创建完整的Skill 1（QA工程师）bmad-skills/qa-engineer/
Agent 2创建完整的Skill 2（DevOps工程师）bmad-skills/devops-engineer/
Agent N创建完整的Skill N（安全工程师）bmad-skills/security-engineer/
协作流程：
  1. 确定要创建的相关Skill套件
  2. 定义通用模式和共享资源
  3. 启动并行Agent，每个Agent创建一个完整的Skill
  4. 每个Agent创建SKILL.md、脚本、模板、资源
  5. 主上下文验证所有Skill并确保一致性
  6. 创建集成文档
适用场景： 为某个领域创建一系列相关Skill

Template Creation Workflow

模板创建工作流

Pattern: Parallel Section Generation Agents: N parallel agents (one per template)
AgentTaskOutput
Agent 1Create test plan templatetemplates/test-plan.template.md
Agent 2Create deployment runbook templatetemplates/deployment-runbook.template.md
Agent 3Create security assessment templatetemplates/security-assessment.template.md
Agent NCreate additional domain templatestemplates/*.template.md
Coordination:
  1. Identify document types needed for skill
  2. Launch parallel agents for each template
  3. Each agent defines sections, variables, example content
  4. Main context validates template format and placeholder consistency
Best for: Creating multiple templates for a skill quickly
模式： 并行章节生成 Agent： N个并行Agent（每个对应一个模板）
Agent任务输出
Agent 1创建测试计划模板templates/test-plan.template.md
Agent 2创建部署运行手册模板templates/deployment-runbook.template.md
Agent 3创建安全评估模板templates/security-assessment.template.md
Agent N创建其他领域模板templates/*.template.md
协作流程：
  1. 确定Skill所需的文档类型
  2. 为每个模板启动并行Agent
  3. 每个Agent定义章节、变量和示例内容
  4. 主上下文验证模板格式和占位符一致性
适用场景： 快速为某个Skill创建多个模板

Skill Validation Workflow

Skill验证工作流

Pattern: Fan-Out Research Agents: 4 parallel agents (validation domains)
AgentTaskOutput
Agent 1Validate YAML frontmatter and skill structurebmad/outputs/validation-structure.md
Agent 2Validate token count and optimizationbmad/outputs/validation-tokens.md
Agent 3Validate script functionality and permissionsbmad/outputs/validation-scripts.md
Agent 4Validate templates and resources completenessbmad/outputs/validation-content.md
Coordination:
  1. Load created skill files
  2. Launch parallel validation agents for different aspects
  3. Each agent runs validation checks and reports issues
  4. Main context consolidates validation report
  5. Fix identified issues before delivery
Best for: Comprehensive quality check of new skills
模式： 扇出式调研 Agent： 4个并行Agent（对应不同验证领域）
Agent任务输出
Agent 1验证YAML前置元数据和Skill结构bmad/outputs/validation-structure.md
Agent 2验证Token数量与优化情况bmad/outputs/validation-tokens.md
Agent 3验证脚本功能与权限bmad/outputs/validation-scripts.md
Agent 4验证模板和资源的完整性bmad/outputs/validation-content.md
协作流程：
  1. 加载已创建的Skill文件
  2. 针对不同方面启动并行验证Agent
  3. 每个Agent运行验证检查并报告问题
  4. 主上下文整合验证报告
  5. 在交付前修复发现的问题
适用场景： 对新Skill进行全面质量检查

Example Subagent Prompt

子Agent提示示例

Task: Create SKILL.md for QA Engineer skill
Context: Read bmad/context/skill-spec.md for requirements
Objective: Create complete SKILL.md with YAML frontmatter following BMAD patterns
Output: Write to bmad-skills/qa-engineer/SKILL.md

Deliverables:
1. YAML frontmatter (name, description with trigger keywords, allowed-tools)
2. Role and function description
3. Core responsibilities (5-8 bullet points)
4. Core principles (5 key principles)
5. When to use this skill section
6. Available commands/workflows (2-4 commands)
7. Workflow process descriptions
8. Integration points with other skills
9. Notes for LLMs section
10. Example interaction

Constraints:
- Follow Anthropic skill specification for YAML
- Keep under 5K tokens (use references for detail)
- Include trigger keywords in description
- Specify allowed-tools list
- Use consistent BMAD formatting and structure
- Include TodoWrite in workflow guidance
- Reference REFERENCE.md for detailed patterns
任务：为QA Engineer Skill创建SKILL.md
上下文：阅读bmad/context/skill-spec.md获取需求
目标：创建包含YAML前置元数据的完整SKILL.md，遵循BMAD模式
输出：写入bmad-skills/qa-engineer/SKILL.md

交付成果：
1. YAML前置元数据（name、包含触发关键词的description、allowed-tools）
2. 角色与功能描述
3. 核心职责（5-8个要点）
4. 核心原则（5个关键原则）
5. 技能适用场景章节
6. 可用命令/工作流（2-4个命令）
7. 工作流流程描述
8. 与其他Skill的集成点
9. 给LLM的提示章节
10. 交互示例

约束条件：
- 遵循Anthropic的YAML Skill规范
- 控制在5K Token以内（使用引用获取详细内容）
- 在描述中包含触发关键词
- 指定allowed-tools列表
- 使用一致的BMAD格式与结构
- 在工作流指导中包含TodoWrite
- 参考REFERENCE.md获取详细模式

Notes for LLMs

给LLM的提示

  • Use TodoWrite to track component creation tasks
  • Validate YAML frontmatter before finalizing skills
  • Follow Anthropic skill specification strictly
  • Test generated components before delivery
  • Ask user for domain-specific details
  • Keep token usage minimal (reference external files)
  • Document integration points clearly
  • Use scaffold-skill.sh to create directory structure
  • Run validate-skill.sh before declaring success
  • 使用TodoWrite追踪组件创建任务
  • 在最终确定Skill前验证YAML前置元数据
  • 严格遵循Anthropic Skill规范
  • 在交付前测试生成的组件
  • 向用户询问特定领域的细节
  • 尽量减少Token使用（引用外部文件）
  • 清晰记录集成点
  • 使用scaffold-skill.sh创建目录结构
  • 在宣布成功前运行validate-skill.sh

Example Domain Customizations

领域自定义示例

QA Engineering:
  • QA Engineer agent skill
  • /create-test-plan workflow
  • /execute-tests workflow
  • Test plan template
DevOps:
  • DevOps Engineer agent skill
  • /deploy workflow
  • /rollback workflow
  • Deployment runbook template
Security:
  • Security Engineer agent skill
  • /security-audit workflow
  • Security assessment template
Data Science:
  • Data Scientist agent skill
  • /data-analysis workflow
  • Analysis report template
Remember: Custom components should feel native to BMAD, following the same patterns and conventions as built-in skills.
QA工程：
  • QA Engineer Agent Skill
  • /create-test-plan工作流
  • /execute-tests工作流
  • 测试计划模板
DevOps：
  • DevOps Engineer Agent Skill
  • /deploy工作流
  • /rollback工作流
  • 部署运行手册模板
安全：
  • Security Engineer Agent Skill
  • /security-audit工作流
  • 安全评估模板
数据科学：
  • Data Scientist Agent Skill
  • /data-analysis工作流
  • 分析报告模板
注意： 自定义组件应与BMAD原生组件风格一致，遵循相同的模式与规范。