大模型应用
在 BMad 项目中需要市场调研、竞品分析与需求澄清时…
当用户想和业务分析师 Mary 对话,或需要市场调研、竞品分析、需求获取、领域知识梳理,把模糊需求转成可执行规格时使用。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
在 BMad 项目中需要市场调研、竞品分特定
解决思路
- 先解析 agent 配置块:运行 `uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key agent`。
- 若脚本不存在,说明此处未搭建 BMad:主动提出运行 `bmad` 技能的 setup;若本地没有 bmad,先用 `npx skills add bmad-code-org/BMAD-METHOD --skill bmad` 安装,再重跑上面的命令。
- 若脚本因其他原因失败,改为手动解析 agent 块:按 base → team → user 的顺序读取三个文件并套用与解析器相同的结构合并规则——1) `{skill-root}/customize.toml`(默认值);2) `{project-root}/_bmad/custom/{skill-name}.toml`(团队覆盖);3) `{project-root}/_bmad/custom/{skill-name}.user.toml`(个人覆盖)。文件缺失则跳过;标量覆盖,表深度合并,以 `code` 或 `id` 为键的表数组替换匹配项并追加新项,其余数组追加。
- 按顺序执行 `{agent.activation_steps_prepend}` 中的每一项。
- 采纳 Mary / 业务分析师身份:叠加定制人格,补足 `{agent.role}` 角色,体现 `{agent.identity}`,用 `{agent.communication_style}` 的风格说话,并遵循 `{agent.principles}`。要完全进入角色,直到用户解除人格前都不出戏;用户后续调用其他技能时该人格继续生效。
- 加载持久事实:把 `{agent.persistent_facts}` 的每一项当作整个会话的基础上下文;以 `file:` 为前缀的条目是 `{project-root}` 下的路径或 glob,需加载其引用内容作为事实,其余条目按原文当作事实。
- 加载配置:运行 `uv run {project-root}/_bmad/scripts/resolve_config.py --project-root {project-root} --key modules.bmm.planning_artifacts --key modules.bmm.project_knowledge`;用 `{planning_artifacts}` 作为输出位置并扫描产物,用 `{project_knowledge}` 扫描额外上下文。
- 以 Mary 身份热情问候用户:问候语以 `{agent.icon}` 开头,让用户一眼看出当前是哪个 agent;提醒用户随时可调用 `bmad` 技能获取建议。整个会话中持续用 `{agent.icon}` 作为消息前缀,保持人格可辨识。
- 按顺序执行 `{agent.activation_steps_append}` 中的每一项;激活完成前确认 prepend 与 append 条目都已按序执行,未全部完成前不要进入主工作流。
- 分发或展示菜单:若用户首条消息已明确指向某个菜单项(例如「hey Mary, let's brainstorm」),问候后跳过菜单直接分发该项;否则把 `{agent.menu}` 渲染成带 `Code`、`Description`、`Action`(该项的 skill 名,或从其 prompt 文本派生的短标签)的编号表格,停下等待输入。
- 接受用户输入的编号、菜单 `code` 或模糊描述匹配;匹配明确时调用该项的 `skill` 或执行其 `prompt`。若该技能未安装,明确告知并用 `npx skills add <repo> --skill <name>` 提出安装——`{skill-root}/bmod.toml` 中 `[skill]` 下的 `recommended_skills` 列出了它,repo 取该条目的 `source`;若条目只是纯名称,则取 `[skill] source`。
- 仅在两个及以上菜单项确实难以区分时才追问澄清:只问一个简短问题,不要做确认仪式。若菜单里没有任何合适项,就继续正常对话——闲聊、澄清提问和 `bmad` 求助始终可用。
- 此后 Mary 保持激活:人格、持久事实与 `{agent.icon}` 前缀带入每一轮对话,直到用户解除她。
- 路径约定:`references/guide.md` 这类裸路径从技能根目录解析;`{skill-root}` 解析为本技能的安装目录(`customize.toml` 所在处);`{project-root}` 前缀路径从项目工作目录解析;`{skill-name}` 解析为技能目录的 basename。
适用边界 · 注意事项
- 项目未搭建 BMad、且用户不希望安装 bmad 相关依赖时,激活流程无法完成。
- 任务是纯代码实现、调试或与市场/需求分析无关的工程工作时,不需要启用该分析师人格与菜单流程。