BMAD + Odoo 设置
将完整的 BMAD-METHOD + Odoo 工作流引导至现有的 Odoo 项目中,仅需一条命令。 安装时会从上游拉取最新的组件(BMAD 核心、Odoo 知识技能),确保始终获得最新/最优版本;集成胶水(BA 技能、子代理、代理覆盖、Visual-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工作流 — 已捆绑。 - Visual-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 | — | 跳过 Visual-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代理。 - 视觉质量检查 — "visual qc <功能>" 对运行中的应用截图并与 HTML 原型对比。
该设置是幂等的:重新运行会刷新集成的胶水代码并重新拉取上游技能,但不会覆盖 _bmad/ 或已有的 docs/project-context.md。