Initial commit

help.md

@@ -0,0 +1,80 @@
+# 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 桌面音频）
+
+**权威操作与交付**（PipeWire / pro-audio / deb / UCM）：**[docs/linux-hdmi/OPERATION_PipeWire_Kaisa_HDMI.md](docs/linux-hdmi/OPERATION_PipeWire_Kaisa_HDMI.md)**、**[reference/ucm2/README.md](reference/ucm2/README.md)**。
+
+在此目标下，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 内核问题」，可以只选**一条**最优先的技能深入（仍用中文）。