docs(zh-cn): add Chinese translation for core-tools reference
翻译 docs/reference/core-tools.md，覆盖全部 11 个核心工具的说明。 保留技能命令名和参数名不译，描述性内容使用自然中文表达。 Made-with: Cursor
This commit is contained in:
leon
parent
02cfaf64a4
commit
f5813f26f2
|
|
@ -0,0 +1,293 @@
|
||||||
|
---
|
||||||
|
title: "核心工具"
|
||||||
|
description: 每个 BMad 安装都自带的内置任务和工作流参考。
|
||||||
|
sidebar:
|
||||||
|
order: 2
|
||||||
|
---
|
||||||
|
|
||||||
|
每个 BMad 安装都包含一组核心技能，可以配合你正在做的任何事情使用——跨项目、跨模块、跨阶段的独立任务和工作流。无论安装了哪些可选模块，这些工具始终可用。
|
||||||
|
|
||||||
|
:::tip[快速上手]
|
||||||
|
在 IDE 中输入技能名称（如 `bmad-help`）即可运行任意核心工具，无需启动智能体会话。
|
||||||
|
:::
|
||||||
|
|
||||||
|
## 概览
|
||||||
|
|
||||||
|
| 工具 | 类型 | 用途 |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| [`bmad-help`](#bmad-help) | 任务 | 根据上下文给出下一步建议 |
|
||||||
|
| [`bmad-brainstorming`](#bmad-brainstorming) | 工作流 | 引导交互式头脑风暴 |
|
||||||
|
| [`bmad-party-mode`](#bmad-party-mode) | 工作流 | 编排多智能体群组讨论 |
|
||||||
|
| [`bmad-distillator`](#bmad-distillator) | 任务 | 无损的 LLM 优化文档压缩 |
|
||||||
|
| [`bmad-advanced-elicitation`](#bmad-advanced-elicitation) | 任务 | 通过迭代精炼方法提升 LLM 输出质量 |
|
||||||
|
| [`bmad-review-adversarial-general`](#bmad-review-adversarial-general) | 任务 | 挑刺式审查——找出遗漏和问题 |
|
||||||
|
| [`bmad-review-edge-case-hunter`](#bmad-review-edge-case-hunter) | 任务 | 穷举分支路径分析，找出未处理的边界情况 |
|
||||||
|
| [`bmad-editorial-review-prose`](#bmad-editorial-review-prose) | 任务 | 临床式文案编辑，聚焦表达清晰度 |
|
||||||
|
| [`bmad-editorial-review-structure`](#bmad-editorial-review-structure) | 任务 | 结构编辑——裁剪、合并与重组 |
|
||||||
|
| [`bmad-shard-doc`](#bmad-shard-doc) | 任务 | 将大型 Markdown 文件拆分为有序章节 |
|
||||||
|
| [`bmad-index-docs`](#bmad-index-docs) | 任务 | 生成或更新文件夹的文档索引 |
|
||||||
|
|
||||||
|
## bmad-help
|
||||||
|
|
||||||
|
**你的智能向导，告诉你下一步该做什么。** — 检查项目状态，识别已完成的内容，推荐下一个必需或可选步骤。
|
||||||
|
|
||||||
|
**适用场景：**
|
||||||
|
|
||||||
|
- 完成了一个工作流，想知道接下来做什么
|
||||||
|
- 刚接触 BMad，需要快速了解全貌
|
||||||
|
- 卡住了，想要根据当前上下文获取建议
|
||||||
|
- 安装了新模块，想看看有哪些可用功能
|
||||||
|
|
||||||
|
**工作原理：**
|
||||||
|
|
||||||
|
1. 扫描项目中已有的产出物（PRD、架构文档、用户故事等）
|
||||||
|
2. 检测已安装的模块及其可用工作流
|
||||||
|
3. 按优先级推荐下一步——必需步骤优先，可选步骤其次
|
||||||
|
4. 每条推荐都附带技能命令和简要说明
|
||||||
|
|
||||||
|
**输入：** 可选的自然语言查询（如 `bmad-help I have a SaaS idea, where do I start?`）
|
||||||
|
|
||||||
|
**输出：** 按优先级排列的下一步推荐列表，附带技能命令
|
||||||
|
|
||||||
|
## bmad-brainstorming
|
||||||
|
|
||||||
|
**通过交互式创意技法激发多样想法。** — 引导式头脑风暴会话，从技法库中加载经过验证的创意方法，引导你在整理之前先产出 100+ 个想法。
|
||||||
|
|
||||||
|
**适用场景：**
|
||||||
|
|
||||||
|
- 启动新项目，需要探索问题空间
|
||||||
|
- 想法枯竭，需要结构化的创意引导
|
||||||
|
- 想使用成熟的创意框架（SCAMPER、反向头脑风暴等）
|
||||||
|
|
||||||
|
**工作原理：**
|
||||||
|
|
||||||
|
1. 围绕你的主题建立头脑风暴会话
|
||||||
|
2. 从方法库中加载创意技法
|
||||||
|
3. 逐个技法引导你产出想法
|
||||||
|
4. 应用反偏差协议——每产出 10 个想法切换一次创意领域，防止想法扎堆
|
||||||
|
5. 生成一份只追加的会话文档，所有想法按技法分类整理
|
||||||
|
|
||||||
|
**输入：** 头脑风暴主题或问题陈述，可选上下文文件
|
||||||
|
|
||||||
|
**输出：** `brainstorming-session-{date}.md`，包含所有产出的想法
|
||||||
|
|
||||||
|
:::note[数量目标]
|
||||||
|
真正的好点子往往出现在第 50-100 个想法之间。工作流鼓励在整理之前先产出 100+ 个想法。
|
||||||
|
:::
|
||||||
|
|
||||||
|
## bmad-party-mode
|
||||||
|
|
||||||
|
**编排多智能体群组讨论。** — 加载所有已安装的 BMad 智能体，引导一场自然对话，每个智能体从各自的专业领域和角色特征出发发言。
|
||||||
|
|
||||||
|
**适用场景：**
|
||||||
|
|
||||||
|
- 需要多个专家视角来评估一个决策
|
||||||
|
- 希望智能体互相质疑彼此的假设
|
||||||
|
- 正在探索一个横跨多个领域的复杂话题
|
||||||
|
|
||||||
|
**工作原理：**
|
||||||
|
|
||||||
|
1. 加载智能体清单及所有已安装的智能体角色
|
||||||
|
2. 分析你的话题，选出 2-3 个最相关的智能体
|
||||||
|
3. 智能体轮流发言，自然地交叉讨论甚至争论
|
||||||
|
4. 轮换参与的智能体，确保随时间推移覆盖多样视角
|
||||||
|
5. 输入 `goodbye`、`end party` 或 `quit` 退出
|
||||||
|
|
||||||
|
**输入：** 讨论话题或问题，以及你希望参与的角色（可选）
|
||||||
|
|
||||||
|
**输出：** 实时多智能体对话，各智能体保持各自角色特征
|
||||||
|
|
||||||
|
## bmad-distillator
|
||||||
|
|
||||||
|
**无损的 LLM 优化文档压缩。** — 生成信息密度高、token 高效的精馏文档，保留全部信息供下游 LLM 消费。可通过往返重构验证无损性。
|
||||||
|
|
||||||
|
**适用场景：**
|
||||||
|
|
||||||
|
- 文档太大，超出 LLM 的上下文窗口
|
||||||
|
- 需要研究资料、规格或规划产出物的 token 高效版本
|
||||||
|
- 想验证压缩过程中没有丢失信息
|
||||||
|
- 智能体需要频繁引用和检索其中的信息
|
||||||
|
|
||||||
|
**工作原理：**
|
||||||
|
|
||||||
|
1. **分析** — 读取源文档，识别信息密度和结构
|
||||||
|
2. **压缩** — 将散文转为密集的要点格式，剥离装饰性排版
|
||||||
|
3. **校验** — 检查完整性，确保原始信息全部保留
|
||||||
|
4. **验证**（可选）— 往返重构测试，证明压缩无损
|
||||||
|
|
||||||
|
**输入：**
|
||||||
|
|
||||||
|
- `source_documents`（必填）— 文件路径、文件夹路径或 glob 模式
|
||||||
|
- `downstream_consumer`（可选）— 消费方是什么（如 "PRD creation"）
|
||||||
|
- `token_budget`（可选）— 大致目标大小
|
||||||
|
- `--validate`（标志）— 运行往返重构测试
|
||||||
|
|
||||||
|
**输出：** 精馏 Markdown 文件，附带压缩比报告（如 "3.2:1"）
|
||||||
|
|
||||||
|
## bmad-advanced-elicitation
|
||||||
|
|
||||||
|
**通过迭代精炼方法提升 LLM 输出质量。** — 从启发技法库中选取合适的方法，通过多轮迭代系统性地改进内容。
|
||||||
|
|
||||||
|
**适用场景：**
|
||||||
|
|
||||||
|
- LLM 输出感觉浅薄或千篇一律
|
||||||
|
- 想从多个分析角度深挖一个话题
|
||||||
|
- 正在打磨关键文档，需要更深层的思考
|
||||||
|
|
||||||
|
**工作原理：**
|
||||||
|
|
||||||
|
1. 加载包含 5+ 种启发技法的方法注册表
|
||||||
|
2. 根据内容类型和复杂度选出 5 个最匹配的方法
|
||||||
|
3. 呈现交互菜单——选一个方法、重新洗牌或列出全部
|
||||||
|
4. 将选中的方法应用到内容上进行增强
|
||||||
|
5. 重新呈现选项，反复迭代改进，直到你选择"继续"
|
||||||
|
|
||||||
|
**输入：** 待增强的内容段落
|
||||||
|
|
||||||
|
**输出：** 应用改进后的增强版内容
|
||||||
|
|
||||||
|
## bmad-review-adversarial-general
|
||||||
|
|
||||||
|
**预设问题存在，然后去找出来的挑刺式审查。** — 以怀疑、挑剔的审查者视角，对粗糙工作零容忍。重点找遗漏，而不只是找错误。
|
||||||
|
|
||||||
|
**适用场景：**
|
||||||
|
|
||||||
|
- 在交付物定稿前需要质量保证
|
||||||
|
- 想对规格、用户故事或文档进行压力测试
|
||||||
|
- 想找到乐观审查容易忽略的覆盖盲区
|
||||||
|
|
||||||
|
**工作原理：**
|
||||||
|
|
||||||
|
1. 以挑剔、批判的视角阅读内容
|
||||||
|
2. 从完整性、正确性和质量三个维度识别问题
|
||||||
|
3. 专门寻找遗漏的内容——不只是已有内容中的错误
|
||||||
|
4. 至少找出 10 个问题，否则进行更深层分析
|
||||||
|
|
||||||
|
**输入：**
|
||||||
|
|
||||||
|
- `content`（必填）— diff、规格、用户故事、文档或任意产出物
|
||||||
|
- `also_consider`（可选）— 需要额外关注的领域
|
||||||
|
|
||||||
|
**输出：** 包含 10+ 条发现及描述的 Markdown 列表
|
||||||
|
|
||||||
|
## bmad-review-edge-case-hunter
|
||||||
|
|
||||||
|
**遍历每条分支路径和边界条件，只报告未处理的情况。** — 纯路径追踪方法论，机械地推导边界类别。与对抗式审查正交——靠方法驱动，而非靠态度驱动。
|
||||||
|
|
||||||
|
**适用场景：**
|
||||||
|
|
||||||
|
- 想对代码或逻辑做穷举式边界覆盖
|
||||||
|
- 需要与对抗式审查互补（不同方法论，不同发现）
|
||||||
|
- 正在审查 diff 或函数的边界条件
|
||||||
|
|
||||||
|
**工作原理：**
|
||||||
|
|
||||||
|
1. 枚举内容中所有分支路径
|
||||||
|
2. 机械推导边界类别：缺失的 else/default、未防护的输入、差一错误、算术溢出、隐式类型转换、竞态条件、超时间隙
|
||||||
|
3. 逐条路径检查现有防护
|
||||||
|
4. 只报告未处理的路径——已处理的静默丢弃
|
||||||
|
|
||||||
|
**输入：**
|
||||||
|
|
||||||
|
- `content`（必填）— diff、完整文件或函数
|
||||||
|
- `also_consider`（可选）— 需要额外关注的领域
|
||||||
|
|
||||||
|
**输出：** JSON 数组，每条发现包含 `location`、`trigger_condition`、`guard_snippet` 和 `potential_consequence`
|
||||||
|
|
||||||
|
:::note[互补审查]
|
||||||
|
同时运行 `bmad-review-adversarial-general` 和 `bmad-review-edge-case-hunter` 可获得正交覆盖。对抗式审查捕捉质量和完整性问题；边界猎手捕捉未处理的路径。
|
||||||
|
:::
|
||||||
|
|
||||||
|
## bmad-editorial-review-prose
|
||||||
|
|
||||||
|
**聚焦表达清晰度的临床式文案编辑。** — 审查文本中阻碍理解的问题，以 Microsoft 写作风格指南为基准，保留作者个人风格。
|
||||||
|
|
||||||
|
**适用场景：**
|
||||||
|
|
||||||
|
- 写完初稿想打磨文字
|
||||||
|
- 需要确保内容对特定受众足够清晰
|
||||||
|
- 只想修表达问题，不想改写风格偏好
|
||||||
|
|
||||||
|
**工作原理：**
|
||||||
|
|
||||||
|
1. 阅读内容，跳过代码块和 frontmatter
|
||||||
|
2. 识别表达问题（不是风格偏好）
|
||||||
|
3. 对多处出现的相同问题去重
|
||||||
|
4. 生成三列修改表
|
||||||
|
|
||||||
|
**输入：**
|
||||||
|
|
||||||
|
- `content`（必填）— Markdown、纯文本或 XML
|
||||||
|
- `style_guide`（可选）— 项目特定的写作风格指南
|
||||||
|
- `reader_type`（可选）— `humans`（默认）注重清晰流畅，`llm` 注重精确一致
|
||||||
|
|
||||||
|
**输出：** 三列 Markdown 表格：原文 | 修改后 | 变更说明
|
||||||
|
|
||||||
|
## bmad-editorial-review-structure
|
||||||
|
|
||||||
|
**结构编辑——提出裁剪、合并、移动和精简建议。** — 审查文档组织结构，在文案编辑之前提出实质性调整建议，以改善清晰度和阅读流畅性。
|
||||||
|
|
||||||
|
**适用场景：**
|
||||||
|
|
||||||
|
- 文档由多个子流程产出，需要结构上的连贯性
|
||||||
|
- 想在保持可读性的前提下缩减文档篇幅
|
||||||
|
- 需要识别范围越界或关键信息被埋没的情况
|
||||||
|
|
||||||
|
**工作原理：**
|
||||||
|
|
||||||
|
1. 将文档与 5 种结构模型对照分析（教程、参考、解释、提示词、战略）
|
||||||
|
2. 识别冗余、范围越界和被埋没的信息
|
||||||
|
3. 生成优先级排序的建议：裁剪、合并、移动、精简、质疑、保留
|
||||||
|
4. 估算总缩减字数和百分比
|
||||||
|
|
||||||
|
**输入：**
|
||||||
|
|
||||||
|
- `content`（必填）— 待审查的文档
|
||||||
|
- `purpose`（可选）— 预期用途（如 "quickstart tutorial"）
|
||||||
|
- `target_audience`（可选）— 目标读者
|
||||||
|
- `reader_type`（可选）— `humans` 或 `llm`
|
||||||
|
- `length_target`（可选）— 目标缩减量（如 "30% shorter"）
|
||||||
|
|
||||||
|
**输出：** 文档摘要、优先级排序的建议列表，以及预估缩减量
|
||||||
|
|
||||||
|
## bmad-shard-doc
|
||||||
|
|
||||||
|
**将大型 Markdown 文件拆分为有序的章节文件。** — 以二级标题为分割点，创建一个包含独立章节文件和索引的文件夹。
|
||||||
|
|
||||||
|
**适用场景：**
|
||||||
|
|
||||||
|
- Markdown 文档过大，难以有效管理（500+ 行）
|
||||||
|
- 想把单体文档拆分成可导航的章节
|
||||||
|
- 需要独立文件以支持并行编辑或 LLM 上下文管理
|
||||||
|
|
||||||
|
**工作原理：**
|
||||||
|
|
||||||
|
1. 验证源文件存在且是 Markdown 格式
|
||||||
|
2. 按二级（`##`）标题分割为编号章节文件
|
||||||
|
3. 创建 `index.md`，包含章节清单和链接
|
||||||
|
4. 提示你选择删除、归档还是保留原文件
|
||||||
|
|
||||||
|
**输入：** 源 Markdown 文件路径，可选目标文件夹
|
||||||
|
|
||||||
|
**输出：** 包含 `index.md` 和 `01-{section}.md`、`02-{section}.md` 等文件的文件夹
|
||||||
|
|
||||||
|
## bmad-index-docs
|
||||||
|
|
||||||
|
**生成或更新文件夹中所有文档的索引。** — 扫描目录，读取每个文件以理解其用途，生成一份带链接和描述的有序 `index.md`。
|
||||||
|
|
||||||
|
**适用场景：**
|
||||||
|
|
||||||
|
- 需要一个轻量索引供 LLM 快速扫描可用文档
|
||||||
|
- 文档文件夹不断增长，需要一个有序的目录
|
||||||
|
- 想要一份自动生成、能持续保持最新的概览
|
||||||
|
|
||||||
|
**工作原理：**
|
||||||
|
|
||||||
|
1. 扫描目标目录中所有非隐藏文件
|
||||||
|
2. 读取每个文件以理解其实际用途
|
||||||
|
3. 按类型、用途或子目录分组
|
||||||
|
4. 生成简洁描述（每条 3-10 个词）
|
||||||
|
|
||||||
|
**输入：** 目标文件夹路径
|
||||||
|
|
||||||
|
**输出：** `index.md`，包含有序的文件列表、相对链接和简要描述
|
||||||
Loading…
Reference in New Issue