Skip to content

Commit 7e97b7e

Browse files
alexeyvclaude
andauthored
fix(docs): correct skill names in getting-started tutorials (#2103)
Agent skills referenced with shortened names (bmad-pm, bmad-architect, etc.) that don't match installed skill names. Fixed to use actual names (bmad-agent-pm, bmad-agent-architect, etc.) across EN, ZH-CN, and FR. Also fixed bmad-research to three specific research skills (EN, FR) and bmad-product-brief to bmad-create-product-brief (ZH-CN). Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent ba2a5cc commit 7e97b7e

3 files changed

Lines changed: 22 additions & 22 deletions

File tree

docs/fr/tutorials/getting-started.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -135,7 +135,7 @@ Créez-le manuellement dans `_bmad-output/project-context.md` ou générez-le ap
135135

136136
Tous les workflows de cette phase sont optionnels :
137137
- **brainstorming** (`bmad-brainstorming`) — Idéation guidée
138-
- **research** (`bmad-research`) — Recherche marché et technique
138+
- **research** (`bmad-market-research` / `bmad-domain-research` / `bmad-technical-research`) — Recherche marché, domaine et technique
139139
- **create-product-brief** (`bmad-create-product-brief`) — Document de base recommandé
140140

141141
### Phase 2 : Planification (Requis)
@@ -239,7 +239,7 @@ Uniquement pour les voies méthode BMad et Enterprise. Quick Dev passe directeme
239239
Oui. Utilisez `bmad-correct-course` pour gérer les changements de périmètre.
240240

241241
**Et si je veux d'abord faire du brainstorming ?**
242-
Invoquez l'agent Analyst (`bmad-analyst`) et exécutez `bmad-brainstorming` (`bmad-brainstorming`) avant de commencer votre PRD.
242+
Invoquez l'agent Analyst (`bmad-agent-analyst`) et exécutez `bmad-brainstorming` (`bmad-brainstorming`) avant de commencer votre PRD.
243243

244244
**Dois-je suivre un ordre strict ?**
245245
Pas strictement. Une fois que vous maîtrisez le flux, vous pouvez exécuter les workflows directement en utilisant la référence rapide ci-dessus.

docs/tutorials/getting-started.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -114,7 +114,7 @@ BMad-Help will detect what you've completed and recommend exactly what to do nex
114114
:::
115115

116116
:::note[How to Load Agents and Run Workflows]
117-
Each workflow has a **skill** you invoke by name in your IDE (e.g., `bmad-create-prd`). Your AI tool will recognize the `bmad-*` name and run it — you don't need to load agents separately. You can also invoke an agent skill directly for general conversation (e.g., `bmad-pm` for the PM agent).
117+
Each workflow has a **skill** you invoke by name in your IDE (e.g., `bmad-create-prd`). Your AI tool will recognize the `bmad-*` name and run it — you don't need to load agents separately. You can also invoke an agent skill directly for general conversation (e.g., `bmad-agent-pm` for the PM agent).
118118
:::
119119

120120
:::caution[Fresh Chats]
@@ -135,27 +135,27 @@ Create it manually at `_bmad-output/project-context.md` or generate it after arc
135135

136136
All workflows in this phase are optional:
137137
- **brainstorming** (`bmad-brainstorming`) — Guided ideation
138-
- **research** (`bmad-research`) — Market and technical research
138+
- **research** (`bmad-market-research` / `bmad-domain-research` / `bmad-technical-research`) — Market, domain, and technical research
139139
- **create-product-brief** (`bmad-create-product-brief`) — Recommended foundation document
140140

141141
### Phase 2: Planning (Required)
142142

143143
**For BMad Method and Enterprise tracks:**
144-
1. Invoke the **PM agent** (`bmad-pm`) in a new chat
144+
1. Invoke the **PM agent** (`bmad-agent-pm`) in a new chat
145145
2. Run the `bmad-create-prd` workflow (`bmad-create-prd`)
146146
3. Output: `PRD.md`
147147

148148
**For Quick Flow track:**
149149
- Run `bmad-quick-dev` — it handles planning and implementation in a single workflow, skip to implementation
150150

151151
:::note[UX Design (Optional)]
152-
If your project has a user interface, invoke the **UX-Designer agent** (`bmad-ux-designer`) and run the UX design workflow (`bmad-create-ux-design`) after creating your PRD.
152+
If your project has a user interface, invoke the **UX-Designer agent** (`bmad-agent-ux-designer`) and run the UX design workflow (`bmad-create-ux-design`) after creating your PRD.
153153
:::
154154

155155
### Phase 3: Solutioning (BMad Method/Enterprise)
156156

157157
**Create Architecture**
158-
1. Invoke the **Architect agent** (`bmad-architect`) in a new chat
158+
1. Invoke the **Architect agent** (`bmad-agent-architect`) in a new chat
159159
2. Run `bmad-create-architecture` (`bmad-create-architecture`)
160160
3. Output: Architecture document with technical decisions
161161

@@ -165,12 +165,12 @@ If your project has a user interface, invoke the **UX-Designer agent** (`bmad-ux
165165
Epics and stories are now created *after* architecture. This produces better quality stories because architecture decisions (database, API patterns, tech stack) directly affect how work should be broken down.
166166
:::
167167

168-
1. Invoke the **PM agent** (`bmad-pm`) in a new chat
168+
1. Invoke the **PM agent** (`bmad-agent-pm`) in a new chat
169169
2. Run `bmad-create-epics-and-stories` (`bmad-create-epics-and-stories`)
170170
3. The workflow uses both PRD and Architecture to create technically-informed stories
171171

172172
**Implementation Readiness Check** *(Highly Recommended)*
173-
1. Invoke the **Architect agent** (`bmad-architect`) in a new chat
173+
1. Invoke the **Architect agent** (`bmad-agent-architect`) in a new chat
174174
2. Run `bmad-check-implementation-readiness` (`bmad-check-implementation-readiness`)
175175
3. Validates cohesion across all planning documents
176176

@@ -180,7 +180,7 @@ Once planning is complete, move to implementation. **Each workflow should run in
180180

181181
### Initialize Sprint Planning
182182

183-
Invoke the **SM agent** (`bmad-sm`) and run `bmad-sprint-planning` (`bmad-sprint-planning`). This creates `sprint-status.yaml` to track all epics and stories.
183+
Invoke the **SM agent** (`bmad-agent-sm`) and run `bmad-sprint-planning` (`bmad-sprint-planning`). This creates `sprint-status.yaml` to track all epics and stories.
184184

185185
### The Build Cycle
186186

@@ -192,7 +192,7 @@ For each story, repeat this cycle with fresh chats:
192192
| 2 | DEV | `bmad-dev-story` | `bmad-dev-story` | Implement the story |
193193
| 3 | DEV | `bmad-code-review` | `bmad-code-review` | Quality validation *(recommended)* |
194194

195-
After completing all stories in an epic, invoke the **SM agent** (`bmad-sm`) and run `bmad-retrospective` (`bmad-retrospective`).
195+
After completing all stories in an epic, invoke the **SM agent** (`bmad-agent-sm`) and run `bmad-retrospective` (`bmad-retrospective`).
196196

197197
## What You've Accomplished
198198

@@ -243,7 +243,7 @@ Only for BMad Method and Enterprise tracks. Quick Flow skips from tech-spec to i
243243
Yes. The SM agent has a `bmad-correct-course` workflow (`bmad-correct-course`) for handling scope changes.
244244

245245
**What if I want to brainstorm first?**
246-
Invoke the Analyst agent (`bmad-analyst`) and run `bmad-brainstorming` (`bmad-brainstorming`) before starting your PRD.
246+
Invoke the Analyst agent (`bmad-agent-analyst`) and run `bmad-brainstorming` (`bmad-brainstorming`) before starting your PRD.
247247

248248
**Do I need to follow a strict order?**
249249
Not strictly. Once you learn the flow, you can run workflows directly using the Quick Reference above.

docs/zh-cn/tutorials/getting-started.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -114,7 +114,7 @@ BMad-Help 将检测你已完成的内容,并准确推荐下一步该做什么
114114
:::
115115

116116
:::note[如何加载智能体和运行工作流]
117-
每个工作流都可以通过技能名直接调用(例如 `bmad-create-prd`)。你的 AI IDE 会识别 `bmad-*` 技能并执行,无需额外单独加载智能体。你也可以直接调用智能体技能进行通用对话(例如 PM 智能体用 `bmad-pm`)。
117+
每个工作流都可以通过技能名直接调用(例如 `bmad-create-prd`)。你的 AI IDE 会识别 `bmad-*` 技能并执行,无需额外单独加载智能体。你也可以直接调用智能体技能进行通用对话(例如 PM 智能体用 `bmad-agent-pm`)。
118118
:::
119119

120120
:::caution[新对话]
@@ -136,26 +136,26 @@ BMad-Help 将检测你已完成的内容,并准确推荐下一步该做什么
136136
此阶段中的所有工作流都是可选的:
137137
- **头脑风暴**`bmad-brainstorming`) — 引导式构思
138138
- **研究**`bmad-market-research` / `bmad-domain-research` / `bmad-technical-research`) — 市场、领域和技术研究
139-
- **创建产品简报**`bmad-product-brief`) — 推荐的基础文档
139+
- **创建产品简报**`bmad-create-product-brief`) — 推荐的基础文档
140140

141141
### 阶段 2:规划(必需)
142142

143143
**对于 BMad Method 和 Enterprise 路径:**
144-
1. 在新对话中调用 **PM 智能体**`bmad-pm`
144+
1. 在新对话中调用 **PM 智能体**`bmad-agent-pm`
145145
2. 运行 `bmad-create-prd` 工作流(`bmad-create-prd`
146146
3. 输出:`PRD.md`
147147

148148
**对于 Quick Flow 路径:**
149149
- 运行 `bmad-quick-dev` —— 它会在一个工作流里同时处理规划与实现,可直接进入实现阶段
150150

151151
:::note[UX 设计(可选)]
152-
如果你的项目有用户界面,在创建 PRD 后调用 **UX-Designer 智能体**`bmad-ux-designer`),然后运行 UX 设计工作流(`bmad-create-ux-design`)。
152+
如果你的项目有用户界面,在创建 PRD 后调用 **UX-Designer 智能体**`bmad-agent-ux-designer`),然后运行 UX 设计工作流(`bmad-create-ux-design`)。
153153
:::
154154

155155
### 阶段 3:解决方案设计(BMad Method/Enterprise)
156156

157157
**创建架构**
158-
1. 在新对话中调用 **Architect 智能体**`bmad-architect`
158+
1. 在新对话中调用 **Architect 智能体**`bmad-agent-architect`
159159
2. 运行 `bmad-create-architecture``bmad-create-architecture`
160160
3. 输出:包含技术决策的架构文档
161161

@@ -165,12 +165,12 @@ BMad-Help 将检测你已完成的内容,并准确推荐下一步该做什么
165165
史诗和故事现在在架构*之后*创建。这会产生更高质量的故事,因为架构决策(数据库、API 模式、技术栈)直接影响工作应该如何分解。
166166
:::
167167

168-
1. 在新对话中调用 **PM 智能体**`bmad-pm`
168+
1. 在新对话中调用 **PM 智能体**`bmad-agent-pm`
169169
2. 运行 `bmad-create-epics-and-stories``bmad-create-epics-and-stories`
170170
3. 工作流使用 PRD 和架构来创建技术信息丰富的故事
171171

172172
**实现就绪检查** *(强烈推荐)*
173-
1. 在新对话中调用 **Architect 智能体**`bmad-architect`
173+
1. 在新对话中调用 **Architect 智能体**`bmad-agent-architect`
174174
2. 运行 `bmad-check-implementation-readiness``bmad-check-implementation-readiness`
175175
3. 验证所有规划文档之间的一致性
176176

@@ -180,7 +180,7 @@ BMad-Help 将检测你已完成的内容,并准确推荐下一步该做什么
180180

181181
### 初始化冲刺规划
182182

183-
调用 **SM 智能体**`bmad-sm`)并运行 `bmad-sprint-planning``bmad-sprint-planning`)。这会创建 `sprint-status.yaml` 来跟踪所有史诗和故事。
183+
调用 **SM 智能体**`bmad-agent-sm`)并运行 `bmad-sprint-planning``bmad-sprint-planning`)。这会创建 `sprint-status.yaml` 来跟踪所有史诗和故事。
184184

185185
### 构建周期
186186

@@ -192,7 +192,7 @@ BMad-Help 将检测你已完成的内容,并准确推荐下一步该做什么
192192
| 2 | DEV | `bmad-dev-story` | `bmad-dev-story` | 实现故事 |
193193
| 3 | DEV | `bmad-code-review` | `bmad-code-review` | 质量验证 *(推荐)* |
194194

195-
完成史诗中的所有故事后,调用 **SM 智能体**`bmad-sm`)并运行 `bmad-retrospective``bmad-retrospective`)。
195+
完成史诗中的所有故事后,调用 **SM 智能体**`bmad-agent-sm`)并运行 `bmad-retrospective``bmad-retrospective`)。
196196

197197
## 你已完成的工作
198198

@@ -243,7 +243,7 @@ your-project/
243243
可以。SM 智能体提供 `bmad-correct-course` 工作流(`bmad-correct-course`)来处理范围变化。
244244

245245
**如果我想先进行头脑风暴怎么办?**
246-
在开始 PRD 之前,调用 Analyst 智能体(`bmad-analyst`)并运行 `bmad-brainstorming``bmad-brainstorming`)。
246+
在开始 PRD 之前,调用 Analyst 智能体(`bmad-agent-analyst`)并运行 `bmad-brainstorming``bmad-brainstorming`)。
247247

248248
**我需要遵循严格的顺序吗?**
249249
不一定。一旦你了解了流程,你可以使用上面的快速参考直接运行工作流。

0 commit comments

Comments
 (0)