jack
bda6b60c15
Promote UCM2/HiFi (Jack-driven) as the primary delivery, add HISTORY.md, remove ProAudio/REPRO docs and non-UCM scripts, and fix repo-wide references. Made-with: Cursor
81 lines
4.6 KiB
Markdown
81 lines
4.6 KiB
Markdown
# BMad Help 速查
|
||
|
||
## BMad Help 是做什么的
|
||
|
||
用来：**判断你在 BMad 流程里大致处在哪一步**、**下一步该用哪个技能**、以及**怎么调用**（技能名、菜单码、可选参数）。不要求你背全目录。
|
||
|
||
---
|
||
|
||
## 本仓库里已装模块（精简版）
|
||
|
||
### Core（随时可用）
|
||
|
||
| 菜单码 | 名称 | 技能名 | 用途（摘自目录） |
|
||
| ------ | ---- | ------ | ---------------- |
|
||
| **BH** | BMad Help | `bmad-help` | 就是当前这条帮助 |
|
||
| **BSP** | Brainstorming | `bmad-brainstorming` | 早期发散、卡住时想点子 |
|
||
| **PM** | Party Mode | `bmad-party-mode` | 多角色 / 多视角讨论 |
|
||
| **ID** | Index Docs | `bmad-index-docs` | 让模型先「索引」文档再深入 |
|
||
| **SD** | Shard Document | `bmad-shard-doc` | 长文档拆分（常指 >500 行） |
|
||
| **EP / ES** | Editorial Review | `bmad-editorial-review-prose` / `structure` | 润色 / 调结构 |
|
||
| **AR / ECH** | Adversarial / Edge Case | `bmad-review-adversarial-general` / `edge-case-hunter` | 交付前挑刺、补边界 |
|
||
| **DG** | Distillator | `bmad-distillator` | 把长文压成保留信息的 distillate |
|
||
|
||
### BMad Method（典型软件交付链，带阶段）
|
||
|
||
阶段大致为：**1-analysis → 2-planning → 3-solutioning → 4-implementation**。
|
||
|
||
常用条目示例（完整列表见 `_bmad/_config/bmad-help.csv`）：
|
||
|
||
| 阶段 | 示例技能（菜单码） |
|
||
| ---- | ------------------ |
|
||
| **1-analysis** | `bmad-product-brief` **[CB]**、`bmad-domain-research` **[DR]**、`bmad-market-research` **[MR]**、`bmad-technical-research` **[TR]**、`bmad-brainstorming` **[BP]** … |
|
||
| **2-planning** | `bmad-create-prd` **[CP]**、`bmad-create-ux-design` **[CU]**、`bmad-validate-prd` **[VP]** … |
|
||
| **3-solutioning** | `bmad-create-architecture` **[CA]**、`bmad-create-epics-and-stories` **[CE]**、`bmad-check-implementation-readiness` **[IR]** … |
|
||
| **4-implementation** | `bmad-sprint-planning` **[SP]**、`bmad-create-story` **[CS]**、`bmad-dev-story` **[DS]**、`bmad-code-review` **[CR]** … |
|
||
| **随时** | `bmad-document-project` **[DP]**、`bmad-generate-project-context` **[GPC]**、`bmad-quick-dev` **[QQ]**、`bmad-correct-course` **[CC]** … |
|
||
|
||
在 Cursor 里一般是：**用自然语言说明要做的事**，或按安装器提供的**斜杠命令 / 技能名**调用（与 `npx bmad-method install` 生成的集成一致）。
|
||
|
||
### Creative Intelligence Suite（创意 / 方法套件）
|
||
|
||
| 菜单码 | 名称 | 技能名 |
|
||
| ------ | ---- | ------ |
|
||
| **IS** | Innovation Strategy | `bmad-cis-innovation-strategy` |
|
||
| **PS** | Problem Solving | `bmad-cis-problem-solving` |
|
||
| **DT** | Design Thinking | `bmad-cis-design-thinking` |
|
||
| **BS** | Brainstorming | `bmad-brainstorming` |
|
||
| **ST** | Storytelling | `bmad-cis-storytelling` |
|
||
|
||
### BMad Builder（搭技能 / 工作流 / 模块）
|
||
|
||
例如 **[BA]** 建 Agent、**[BW]** 建 Workflow、**[CM]** 建模块等（见 `_bmad/_config/bmad-help.csv` 前几行）。
|
||
|
||
---
|
||
|
||
## 结合本仓库（Chromebox / HDMI）
|
||
|
||
### 本仓库当前产品目标（Kaisa 桌面音频）
|
||
|
||
**权威操作与交付**：**[docs/linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md](docs/linux-hdmi/OPERATION_PipeWire_Kaisa_UCM_HiFi.md)**（UCM2 + HiFi 主交付）、**[reference/ucm2/README.md](reference/ucm2/README.md)**（UCM2 源码说明）。
|
||
|
||
在此目标下，BMad 更偏 **棕地攻关 + 文档/交付对齐**。常用下一步：
|
||
|
||
1. **`bmad-document-project` [DP]**：扩展/更新 `docs/linux-hdmi/` 与 **deb 范围**一致说明。
|
||
2. **`bmad-generate-project-context` [GPC]**：把目标、路径、仓库布局收成代理可用的 **project-context**（若尚未生成）。
|
||
3. **`bmad-cis-problem-solving` [PS]**：UCM 草稿卡壳、Jack/控件映射不清时做结构化拆解。
|
||
4. **`bmad-technical-research` [TR]**：面向 **`alsa-ucm-conf` 上游 MR** 或发行版沟通时整理选项与引用。
|
||
|
||
若你**改走**标准 BMad Method **从 0 做产品文档**，再从 **[CB] 产品简报**或 **[CP] PRD** 开始会更顺（与 **OPERATION** 并行时，注意 PRD 与实机路线一致）。
|
||
|
||
---
|
||
|
||
## 使用建议（技能里写的）
|
||
|
||
- 重要长流程尽量在**新的对话窗口**里单独跑一个技能，上下文更干净。
|
||
- 更全的条目与依赖关系以 `_bmad/_config/bmad-help.csv` 为准；各模块输出默认可在 `_bmad-output`（见 `_bmad/core/config.yaml`）。
|
||
|
||
**完整 BMad 目录（中文全表）**：根目录 [bmad-help.zh-CN.md](bmad-help.zh-CN.md)（由 `_bmad/scripts/render_bmad_help_zh_cn.py` 根据 CSV 生成）。
|
||
|
||
若你接下来是想「写 PRD / 架构」还是「继续攻 HDMI 内核问题」，可以只选**一条**最优先的技能深入（仍用中文）。
|