BMAD + Odoo 環境設定
將完整的 BMAD-METHOD + Odoo 工作流程引導至現有的 Odoo 專案，只需一個指令。 安裝時會從上游拉取最新/最佳版本的元件（BMAD 核心、Odoo 知識技能）； 而整合的黏合層（BA 技能、子代理、代理覆寫、視覺化 QC）則包含在此儲存庫中。
安裝項目
- BMAD METHOD（
bmm模組、claude-code工具、越南語）— 透過npx bmad-method@latest即時拉取。 - Odoo 代理技能 —
odoo-17/odoo-18/odoo-19、payment-integration、dtg-base、mcp-builder、ai-vibe-slides— 透過npx skills add unclecatvn/agent-skills即時拉取。 - odoo-ba-smartcore BA 技能（
/srs、/use-case、/gap-analysis、/user-story、/bpmn、/mockup、/to-bmad）— 內建。 - 子代理
planner、odoo-code-review、odoo-code-tracer→.claude/agents/— 內建。 - BMAD 覆寫（
_bmad/custom/*.toml）將 Odoo 知識庫 + BA 工件接入 分析師 (Mary)、架構師 (Winston)、開發者 (Amelia)、專案經理 (John)、UX 設計師 (Sally)，以及create-story/dev-story/quick-dev工作流程 — 內建。 - 視覺化 QC 引擎（
_bmad/scripts/visualqc/）+bmad-qa-visual-review技能 — 內建。 docs/project-context.md+.odoo-version版本鎖定 +docs/analysis與docs/mockups目錄結構。
執行方式
在目標 Odoo 專案的根目錄下，執行其中一個指令：
# A) curl 一行指令（自行複製內建資源）
curl -fsSL https://raw.githubusercontent.com/baolinhtb/BMAD-Odoo-Skills/main/install.sh | bash
# B) 先複製再執行（可離線執行，讓您先檢查內容）
git clone --depth 1 https://github.com/baolinhtb/BMAD-Odoo-Skills.git /tmp/bmad-odoo-kit
bash /tmp/bmad-odoo-kit/install.sh /path/to/odoo-project
以技能方式呼叫時，預設使用 A 並將 $PWD 作為專案目錄，除非使用者指定其他目錄。
如果目標目錄明顯不是 Odoo 專案（附近沒有 addons/ 或 __manifest__.py），請先與使用者確認。
選項（環境變數，附加在指令前）
| 變數 | 預設值 | 用途 |
|---|---|---|
ODOO_VERSION | 19 | 鎖定的 Odoo 主版本（17/18/19）；會相應改寫覆寫設定 |
BMAD_LANG | Vietnamese | BMAD 溝通語言 |
SKIP_BMAD=1 | — | 跳過 BMAD 安裝程式（重新執行安全；若 _bmad/ 已存在則自動跳過） |
SKIP_SKILLS=1 | — | 跳過代理技能拉取 |
SKIP_VISUALQC=1 | — | 跳過視覺化 QC 引擎 + npm install |
範例：ODOO_VERSION=18 BMAD_LANG=English curl -fsSL .../install.sh | bash
安裝完成後
告知使用者環境已就緒，並建議以下流程：
- 分析 — 「與 Mary 對話」（分析師）→
/srs、/gap-analysis、/mockup→/to-bmad（產生docs/epics.md、docs/architecture.md、docs/ux.md，更新docs/project-context.md）。 - 規劃 — BMAD
sprint-planning→create-story。 - 建置 —
dev-story（Amelia）以odoo-19指南為真理來源實作； 或使用OR選單執行odoo-code-review代理。 - 視覺化 QC — 「visual qc <功能>」對執行中的應用程式進行截圖，與 HTML 模擬稿比對。
此設定具有冪等性：重新執行時會重新整理綁定的黏合層並重新拉取上游技能，
但不會覆蓋 _bmad/ 或既有的 docs/project-context.md。