Skip to content

Commit 090bfea

Browse files
lrliangleon
andauthored
docs(zh-cn): close explanation gap relinks (#2102)
我补齐 explanation 目录在本轮审校中确认的中文缺口,统一关键命令名为当前 `bmad-*` 形式,并修正 Party Mode 示例里的半翻角色标签。此前这些页面缺少回连到中文目标的入口且术语混用旧名,导致查阅路径容易断层;现在每页都补了中文回链并对齐命名,降低理解和跳转成本。 Feishu: https://feishu.cn/wiki/TODO Made-with: Cursor Co-authored-by: leon <leon.liang@hairobotics.com>
1 parent fce9d6c commit 090bfea

9 files changed

Lines changed: 24 additions & 6 deletions

docs/zh-cn/explanation/advanced-elicitation.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,8 @@ sidebar:
3636
做规格、方案或计划时,先跑一次“事前复盘”通常收益最高,容易提前暴露隐藏风险。
3737
:::
3838

39+
如果你还处在方向发散阶段,可先用 [头脑风暴](./brainstorming.md);如果你需要多角色权衡讨论,可用 [派对模式](./party-mode.md)。在进入实现前做问题发现时,可结合 [对抗性评审](./adversarial-review.md)
40+
3941
## 与相近模式的区别
4042

4143
| 模式 | 核心目标 | 典型输入 | 典型输出 |

docs/zh-cn/explanation/adversarial-review.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,9 +43,11 @@ sidebar:
4343
所以它本质上是**高召回、需人工分诊**的策略,而不是“自动真理机”。
4444

4545
:::caution[关键心法]
46-
把发现分成三类:必须修、可延后、可忽略。评审质量的关键不在发现数量”,而在分诊质量。
46+
把发现分成三类:必须修、可延后、可忽略。评审质量的关键不在发现数量”,而在分诊质量。
4747
:::
4848

49+
如果你想把该策略放进快速实现节奏中,可参见 [快速开发](./quick-dev.md);若要做多轮推理补强,可参见 [高级启发](./advanced-elicitation.md)。整体流程位置请见 [工作流地图](../reference/workflow-map.md)
50+
4951
## 与 Quick Dev 的关系
5052

5153
`bmad-quick-dev` 关注执行效率与边界控制;对抗性评审关注问题发现质量。

docs/zh-cn/explanation/brainstorming.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ sidebar:
99

1010
## 它是什么
1111

12-
头脑风暴(brainstorming)适合我有方向,但还不够清晰”的阶段。你会和 AI 进行来回探索:
12+
头脑风暴(brainstorming)适合我有方向,但还不够清晰”的阶段。你会和 AI 进行来回探索:
1313
- 明确问题和约束
1414
- 生成备选想法
1515
- 对想法分组和优先级排序
@@ -46,6 +46,8 @@ sidebar:
4646
想法来源于你,workflow 负责构建“更容易产生好想法”的过程。
4747
:::
4848

49+
想继续深化现有输出,可参考 [高级启发](./advanced-elicitation.md);需要多角色协同讨论,可参考 [派对模式](./party-mode.md)。若要查看它在整体流程中的位置,请参见 [工作流地图](../reference/workflow-map.md)
50+
4951
## 与相近模式的区别
5052

5153
| 模式 | 核心目标 | 输入状态 | 典型输出 |

docs/zh-cn/explanation/established-projects-faq.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ sidebar:
2525

2626
### 如果我忘了运行文档梳理怎么办?
2727

28-
可以随时补跑,不影响你继续推进当前任务。很多团队会在迭代中期或里程碑后再运行一次,用来把代码现状”回写到文档里。
28+
可以随时补跑,不影响你继续推进当前任务。很多团队会在迭代中期或里程碑后再运行一次,用来把代码现状”回写到文档里。
2929

3030
### 既有项目可以直接用 Quick Flow 吗?
3131

@@ -55,6 +55,8 @@ BMad Method 不会强制“立即现代化”,而是把决策权交给你。
5555

5656
**还有问题?** 欢迎在 [GitHub Issues](https://github.com/bmad-code-org/BMAD-METHOD/issues)[Discord](https://discord.gg/gk8jAdXWmj) 提问。
5757

58+
如果你想了解这套接入方式的操作步骤,可继续阅读 [How-to:既有项目](../how-to/established-projects.md)[How-to:项目上下文](../how-to/project-context.md)。想理解快速流程在方法论中的定位,可参见 [快速开发](./quick-dev.md)
59+
5860
## 继续阅读
5961

6062
- [既有项目(How-to)](../how-to/established-projects.md)

docs/zh-cn/explanation/party-mode.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ sidebar:
99

1010
## 它是什么
1111

12-
Party Mode 不是单角色问答,也不是单文档改写。它更像一次有主持人的多方评审会”:
12+
Party Mode 不是单角色问答,也不是单文档改写。它更像一次有主持人的多方评审会”:
1313
- BMad Master 根据你的问题调度相关角色
1414
- 各角色以自身关注点回应
1515
- 角色间会互相补充、质疑、修正
@@ -35,14 +35,16 @@ Party Mode 不是单角色问答,也不是单文档改写。它更像一次“
3535

3636
## 价值与边界
3737

38-
Party Mode 的价值在于更快看见盲区”:
38+
Party Mode 的价值在于更快看见盲区”:
3939
- 优势:视角多、分歧显性、对齐速度快
4040
- 代价:讨论信息量大,需要你主动控节奏和收敛
4141

4242
:::caution[使用建议]
4343
先给清晰议题,再给决策约束(时间、风险、成本、成功标准),讨论质量会明显更高。
4444
:::
4545

46+
若你的目标是结构化发散创意,可先参考 [头脑风暴](./brainstorming.md);若你已经有初稿并想做二次推理补强,可参考 [高级启发](./advanced-elicitation.md)。完整阶段位置见 [工作流地图](../reference/workflow-map.md)
47+
4648
## 与相近模式的区别
4749

4850
| 模式 | 核心目标 | 最佳场景 | 输出形态 |

docs/zh-cn/explanation/preventing-agent-conflicts.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -104,11 +104,13 @@ architecture: "如何做"
104104

105105
:::tip[更稳妥的做法]
106106
- 先记录跨 `epic`、高冲突概率的决策
107-
- 把精力放在会影响多个 story 的规则”
107+
- 把精力放在会影响多个 story 的规则”
108108
- 随着项目演进持续更新架构文档
109109
- 出现重大偏移时使用 `bmad-correct-course`
110110
:::
111111

112+
如需先理解为什么要在实施前做 solutioning,可阅读 [为什么解决方案设计很重要](./why-solutioning-matters.md);如果你想把这些约束落地到项目执行,可继续看 [项目上下文](./project-context.md)。流程全景见 [工作流地图](../reference/workflow-map.md)
113+
112114
## 继续阅读
113115

114116
- [为什么解决方案阶段很重要](./why-solutioning-matters.md)

docs/zh-cn/explanation/project-context.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -89,6 +89,8 @@ sidebar:
8989

9090
## 继续阅读
9191

92+
如需可执行步骤说明,请阅读 [How-to:项目上下文](../how-to/project-context.md);如果你在既有项目落地这套机制,可参考 [既有项目常见问题](./established-projects-faq.md)。整体流程定位见 [工作流地图](../reference/workflow-map.md)
93+
9294
- [管理项目上下文(How-to)](../how-to/project-context.md)
9395
- [既有项目常见问题](./established-projects-faq.md)
9496
- [工作流地图](../reference/workflow-map.md)

docs/zh-cn/explanation/quick-dev.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -81,6 +81,8 @@ Quick Dev 是执行节奏设计;`adversarial review` 是审查策略。二者
8181

8282
## 继续阅读
8383

84+
想进一步理解审查策略,可继续阅读 [对抗性评审](./adversarial-review.md);需要对已有输出进行第二轮推理时,可参考 [高级启发](./advanced-elicitation.md)。若要查看它在完整流程中的位置,请参见 [工作流地图](../reference/workflow-map.md)
85+
8486
- [对抗性评审](./adversarial-review.md)
8587
- [高级启发](./advanced-elicitation.md)
8688
- [工作流地图](../reference/workflow-map.md)

docs/zh-cn/explanation/why-solutioning-matters.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -75,6 +75,8 @@ solutioning 的本质不是“多写一份文档”,而是把高冲突风险
7575
在 solutioning 阶段发现对齐问题,通常比在实施中后期才发现更快、更便宜。
7676
:::
7777

78+
想进一步理解冲突是如何发生并被架构约束消除的,可继续阅读 [防止智能体冲突](./preventing-agent-conflicts.md)。如果你要把这些约束落到执行层,请结合 [项目上下文](./project-context.md)[工作流地图](../reference/workflow-map.md) 一起阅读。
79+
7880
## 继续阅读
7981

8082
- [防止智能体冲突](./preventing-agent-conflicts.md)

0 commit comments

Comments
 (0)