YU-METHOD

基于 BMAD-METHOD 内核的个人 AI 驱动敏捷开发框架，适用于 Claude Code、Codex 等主流编程智能体。

→ 研发流程 (WORKFLOW) · → 技能详解 (YU-SKILLS) · → 专家 Agent (YU-AGENTS) · → 知识库集成 (YU-BRAIN) · → 自定义指南 (YU-CUSTOMIZE) · → 常见问题 (FAQ) · → 版本日志 (CHANGELOG)

[!NOTE] YU-METHOD 是一个个人开源项目，由个人利用业余时间维护，不隶属于任何公司或组织。 欢迎任何人自由使用、fork 和修改。使用中遇到问题、发现 bug 或有改进想法， 欢迎提交 GitHub Issue 或直接发 Pull Request 一起完善。 项目按「原样」提供，作者不对其可用性或适用性作任何担保。

[!CAUTION] yu-method 持续迭代，建议每周或想起来时更新一次，以体验最新技能和优化。

第一步：更新安装

npm install -g yu-method@latest

若安装后技能文件没更新，通常是当前环境禁用了 npm lifecycle 脚本导致 postinstall 未执行。→ 详见安装说明 §第 1 步

第二步：重载智能体

| 智能体 | 重载命令 | |---|---| | Claude Code | /reload-skills 然后 /reload-plugins |

[!TIP] 两个命令记住即可快速上手：

• /yu 或 /yu-help：技能导航器。描述你在做什么，它帮你匹配最合适的技能或路径，然后你手动激活——适合"我知道要做啥但不记命令名"的场景。
• /yu-agent-me：全能技术搭档（推荐入口）。激活后进入持续对话会话——自然语言描述意图，Agent 自动识别并直接调用对应技能，无需手动激活，同时内置团队规范、知识库检索和知识沉淀提示。覆盖调研 → 规划 → 开发 → 文档 → 汇报全链路，全程不用切换 Agent。

简单说：/yu-help 告诉你该走哪扇门；/yu-agent-me 是始终在线的搭档，帮你把门推开并一路陪跑。

为什么做这个

现代 AI 辅助开发需要一套完整的工作流：从产品洞察、需求设计、技术架构，到 Story 拆解、编码实现、代码审查，每个环节都需要 AI 以正确的角色、正确的上下文介入。BMAD-METHOD 在这套通用敏捷流程上积累了成熟的设计，我们没有必要从头再造。

YU-METHOD 的出发点是：在通用敏捷流程之上，叠加自己的知识与判断。每个开发者或团队都有自己的编码规范、基础设施约束、知识库体系和工具链，这些内容适合放在独立扩展层中维护。

YU-METHOD 以 BMAD-METHOD 作为底层内核，复用完整敏捷生命周期中的通用能力，同时在 yu-* 命名空间下保留干净的扩展层，用于沉淀个人规范、接入自选工具、重写与具体业务绑定的工作流。

工作原理

每个 yu-xxx 命令是对应 bmad-xxx 的扩展入口，包含三个可选的覆盖区：

OVERRIDE_PREPEND   在底层流程前插入团队步骤（如加载内部规范、合规检查）
OVERRIDE_REPLACE   完整替换为团队自有实现（适合业务深度定制的工作流）
OVERRIDE_APPEND    在底层流程后追加团队步骤（如通知系统、自动开 PR）

覆盖区为空时，直接透传给底层 bmad-xxx 执行，行为与原版完全一致。改一个文件，只影响一个命令，不动任何其他结构。

安装

第 1 步：全局安装

yu-method 已发布到 npm 公共仓库，全局安装一次，对所有项目生效：

npm install -g yu-method

更新到最新版同样是这一条：

npm install -g yu-method@latest

postinstall 没执行？ 若安装后技能没写入 ~/.claude/skills/，通常是你的环境全局禁用了 npm lifecycle 脚本（企业受管 npm 常见）。检查 npm config get ignore-scripts，或改用 npm install -g yu-method --foreground-scripts 重装一次。

postinstall 自动完成三件事：

1. 将全部 yu-* 技能写入 ~/.claude/skills/
2. 若检测到 bmad-method 尚未安装，自动静默安装（全局一次性）
3. 若检测到 CodeGraph 尚未安装，自动安装并注册 MCP 服务到 ~/.claude.json（代码语义索引，加速 AI 代码理解）

重载 Claude Code 即可使用。

第 2.5 步（可选）：接入团队知识库

yu-method 可选接入一个与系统 gbrain 完全隔离的专属知识库（yu-gbrain），可将团队的技术决策记录、事故复盘、编码规范等 Markdown 文档同步进来，让 AI 在调研、规划、架构等环节自动检索团队上下文。

[!IMPORTANT] 知识库运行时 gbrain 是一个独立工具，不随 yu-method 提供，也不在公共 npm 仓库上。如果你的组织分发了 gbrain，安装好并确保 gbrain 命令在 PATH 中即可；否则跳过本步——所有 /yu-* 技能在没有知识库时照常工作。yu-brain-setup 检测不到 gbrain 会直接优雅退出，不做任何更改。

一次性初始化（每人只需运行一次）：

yu-brain-setup

脚本会自动完成：

1. 初始化 ~/.yu/gbrain（与系统 ~/.gbrain 完全隔离）
2. 初始化本地共享知识库骨架并导入
3. 配置共享知识库目录：默认联合库 ~/Documents/yu/brain，个人库 ~/Documents/yu/brain/personal，团队库镜像 ~/Documents/yu/brain/team
4. 将 yu-gbrain MCP 写入以下位置（仅写入已存在的配置文件，不强制创建）：
   • 项目级 .mcp.json（当前工作目录）
   • 全局 ~/.mcp.json（所有 Claude Code 项目共享）
   • Codex：~/.codex/config.toml 的 [mcp_servers.yu-gbrain] 段

macOS 26 用户：脚本自动检测 macOS 26（Darwin 25.x）并安装 PostgreSQL@17 作为数据库后端。macOS 26 的 PGLite WASM 有已知 bug，postgres 后端完全绕过此问题，无需手动操作。

初始化完成后重启 Claude Code / Codex，yu-gbrain MCP 即自动连接。之后通过 /yu-brain-sync 定期拉取团队知识库更新。

没有运行也没关系：所有 yu-* 技能都会优雅降级，知识库不可用时照常工作。/yu-goal 和 /yu-help 会在启动时检测知识库状态，若未连接会提示是否立即运行 /yu-brain-setup。

→ yu-gbrain 完整架构与使用指南

第 3 步：在每个项目中初始化

进入每个 repo 后执行一次，生成项目级工作流配置（_bmad/ 目录）：

npx yu-method init

建议将生成的目录加入 .gitignore：

_bmad/
_bmad-output/

只使用问答、代码审查、问题排查等技能时可跳过此步；使用 /yu-prd、/yu-dev-story 等产出文档的技能时必须先执行。

卸载

[!IMPORTANT] npm uninstall 的 preuninstall 钩子在 npm v7+ 下静默不执行，必须先手动运行 CLI 清除技能。

# 仅卸载 yu-* 技能（保留 bmad-*）
npx yu-method@latest uninstall
npm uninstall -g yu-method

# 连带卸载 bmad-* 技能（全量清除）
npx yu-method@latest uninstall --with-bmad
npm uninstall -g yu-method

第 4 步：验证

在 Claude Code 会话中输入 /yu-help，看到 YU 工作流菜单即为成功。

第 5 步：了解研发流程

安装成功后，建议阅读 研发流程指南，了解面对不同规模需求时应选用哪些技能、按什么顺序推进：

| 规模 | 入口技能 | 详细流程 | |---|---|---| | 🟢 小需求（单一目标） | /yu-quick-dev | → 小需求流程 | | 🟡 中需求（单个 feature） | /yu-spec | → 中需求流程 | | 🔴 大需求（新产品/大能力） | /yu-prd | → 大需求流程 | | 🟣 分布式系统（多 repo） | /yu-prd + /yu-spec | → 分布式流程 |

技能列表

共 56 个技能（47 个工作流技能 + 8 个专家 Agent + 1 个团队编排器），覆盖完整敏捷生命周期。

团队编排器（全自动流水线）

一条命令启动整个团队，无需手动切换 Agent：

| 命令 | 码 | 用途 | |---|---|---| | yu-team | TM | 团队编排器：选择任意阶段组合（分析/规划/UX/架构/Stories/Sprint/实现/文档化），按序派发对应 Agent，每阶段产出后暂停等待人工确认，全程一个会话窗口 |

6 个阶段一一对应 6 位专家，完全自由勾选。例：只选「实现 + 文档化」跳过前期规划；或只选「架构 + 实现」。支持中断恢复：/yu-team resume {slug}。

专家 Agent（对话式入口）

与单个 Agent 对话，描述意图，Agent 自动调用合适的 yu-* 技能——适合需要深度交互的阶段。

通过 _bmad/custom/yu-agent-xxx.user.toml 可为 Agent 改名、调整人设、注入团队规范，无需修改源文件。

| 命令 | 默认角色名 | 阶段 | 能调用的技能 | |---|---|---|---| | yu-agent-analyst | 冲虚道长 📊 | 分析 | 头脑风暴、高级追问、市场/领域/技术调研、产品 Brief、PRFAQ、项目文档化 | | yu-agent-pm | 任盈盈 📋 | 规划 | PRD、Spec、Epics & Stories、实现就绪检查、方向纠偏 | | yu-agent-architect | 风清扬 🏗️ | 方案设计 | 创建架构、技术调研、生成项目上下文、实现就绪检查、领域模型提取（DE） | | yu-agent-ux-designer | 仪琳 🎨 | 规划 | UX 设计、头脑风暴、对抗式评审 | | yu-agent-dev | 令狐冲 💻 | 实现 | Dev Story、Quick Dev、自主目标循环、代码审查、Sprint 计划、Story 准备、调查、回顾 | | yu-agent-tech-writer | 方证大师 📚 | 随时 | 项目文档化、生成项目上下文、索引文档、拆分文档、散文润色、结构评审、大厂职场表达润色（BC） | | yu-agent-memory-curator | 曲洋 📜 | 随时 | yu-gbrain 唯一写入者：决策/事故/规范格式化存入个人库；引导 yu-promote 完成团队晋升 | | yu-agent-me | AI-ME 🤖 | 随时 | 技术自驱全链路搭档：调研→规划→需求→开发→自测→文档→汇报，内置 14 个技能菜单，无需切换 Agent |

随时可用

| 命令 | 码 | 用途 | |---|---|---| | yu-help | VH | 工作流导航；只展示 yu-* 命令 | | yu-brainstorming | BR | 多技法头脑风暴 | | yu-advanced-elicitation | AE | 深度追问，萃取隐性知识 | | yu-project-context | DP | 项目上下文：AGENTS.md 指令块（setup/refresh/audit）· project-context.md · --tour 依赖序阅读导览。旧名 yu-document-project / yu-generate-project-context 仍作别名可用 | | yu-shard-doc | SD | 大文档按二级标题拆分为小知识单元 | | yu-index-docs | ID | 生成/更新目录下所有文档的 index.md | | yu-spec | SP | 把任意输入提炼为 SPEC.md 合约 | | yu-quick-dev | QQ | 轻量端到端：意图→计划→实现→审查 | | yu-goal | GO | 高层目标自主迭代推进，直到可验证的完成标准达成（支持断点续跑） | | yu-skillopt | SO | 对任意 SKILL.md 做 9 维度评分 + 单次单维度改进迭代，支持 yu-* 和全局安装的第三方技能 | | yu-correct-course | CC | 重大方向变更导航 | | yu-party-mode | PM | 多 Agent 协作讨论，汇聚多视角 | | yu-review | AR | 多镜头评审：adversarial / edge-case-hunter / verification-gap / structure / prose，可单跑可全跑。旧名 yu-review-adversarial-general / yu-review-edge-case-hunter / yu-editorial-review-prose / yu-editorial-review-structure 仍作别名可用 | | yu-bigtech-comms | BC | 大厂职场表达润色：IM / 日报 / 周报 / 季报 / 年度总结 / 向上汇报 / 口头发言 / 故障通报 | | yu-diagram | DG | 生成生产级 SVG+PNG 技术图：架构图、数据流、流程图、序列图、UML、ER 等 14+ 种图表，8 种视觉风格 | | yu-remember | RM | 主动捕获记忆候选（决策/教训/偏好）→ 写入个人 inbox 待审 | | yu-memory | MM | 被动捕获开关（on\|off）与队列管理（review\|status） | | yu-paw | PAW | PAW 模糊函数工坊：需求→Spec→编译→测试→集成代码（Python / JS / Java-HTTP / Java-gRPC） |

阶段 1 — 分析

| 命令 | 码 | 用途 | |---|---|---| | yu-product-brief | CB | 产品概念文档引导 | | yu-prfaq | WB | Working Backwards PRFAQ 挑战 | | yu-deep-recon | TR | 决策级调研：technical / market / domain / competitive / user-voice / academic-lit，起草 prompt / 处理报告 / 直跑三模式。旧名 yu-technical-research / yu-market-research / yu-domain-research 仍作别名可用 |

阶段 2 — 规划

| 命令 | 码 | 用途 | |---|---|---| | yu-prd | PRD | PRD 创建 / 编辑 / 验证三合一 | | yu-ux | CU | UX 设计引导 |

阶段 3 — 方案设计

| 命令 | 码 | 用途 | |---|---|---| | yu-create-architecture | CA | 技术决策文档化 | | yu-create-epics-and-stories | CE | 分解为 Epics 和 Stories | | yu-check-implementation-readiness | IR | PRD / 架构 / Stories 对齐验证 |

阶段 4 — 实现

| 命令 | 码 | 用途 | |---|---|---| | yu-sprint-planning | SPL | Sprint 启动与计划 | | yu-sprint-status | SS | 进度汇总与路由 | | yu-create-story | CS/VS | Story 准备（create）与验收（validate） | | yu-dev-story | DS | 按 Story 文件执行实现 | | yu-code-review | CR | 代码审查 | | yu-qa-generate-e2e-tests | QA | 生成自动化 API / E2E 测试套件 | | yu-checkpoint-preview | CK | commit / 分支 / PR 引导式走查 | | yu-retrospective | ER | Epic 结束回顾 | | yu-investigate | IN | 取证式调查，证据分级 + 假设追踪 |

知识库管理

| 命令 | 码 | 用途 | |---|---|---| | yu-brain-setup | BS | 一次性初始化 yu-gbrain 知识库（与系统 ~/.gbrain 完全隔离） | | yu-brain-sync | BN | 同步团队库和个人库到 yu-gbrain | | yu-gbrain-format | GF | 为 Markdown 文件添加 timeline 分隔符，让 gbrain 正确抽取时间线 | | yu-remember | RM | 主动捕获决策/教训/偏好 → 写入个人 inbox 待审 | | yu-memory | MM | 被动捕获开关与队列管理：on\|off 开关 / review 消费队列 / status 查状态 | | yu-promote | PRO | 将个人知识晋升为共享知识（可选 Git 审核流程） |

新增一个 yu-* 技能

1. 新建 skills/yu-your-skill/SKILL.md（从任意现有文件复制委派模板）
2. 在 .claude-plugin/marketplace.json 的 skills 数组追加 "./skills/yu-your-skill"
3. 在 module-help.csv 追加一行路由记录

改 3 处，其余文件不动。

将某个技能升级为团队自有实现

编辑 skills/yu-xxx/SKILL.md，按需填写覆盖区：

| 覆盖区 | 效果 | |---|---| | OVERRIDE_PREPEND | 在底层流程前插入团队步骤 | | OVERRIDE_REPLACE | 完整替换为团队自有实现 | | OVERRIDE_APPEND | 在底层流程后追加团队步骤 |

空块自动忽略，不影响其他命令。

本地开发与打包

# 升版本
npm version patch   # 或 minor / major

# 检查包内容
npm pack --dry-run

# 推代码和 tag
git push && git push --tags

安装已发布版本：

npm install -g yu-method@latest

关于底层内核

YU-METHOD 在运行时依赖 BMAD-METHOD 提供的通用敏捷工作流能力。两者相互独立：BMAD 负责通用流程的持续演进，YU-METHOD 负责团队专属内容的沉淀与扩展。BMAD-METHOD 以 MIT 协议开源，YU-METHOD 与其项目方无从属关系。