基于 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 执行，行为与原版完全一致。改一个文件，只影响一个命令，不动任何其他结构。
yu-method 已发布到 npm 公共仓库，全局安装一次，对所有项目生效：
npm install -g yu-method更新到最新版同样是这一条：
npm install -g yu-method@latestpostinstall 没执行？ 若安装后技能没写入
~/.claude/skills/，通常是你的环境全局禁用了 npm lifecycle 脚本（企业受管 npm 常见）。检查npm config get ignore-scripts，或改用npm install -g yu-method --foreground-scripts重装一次。
postinstall 自动完成三件事：
- 将全部
yu-*技能写入~/.claude/skills/ - 若检测到 bmad-method 尚未安装，自动静默安装（全局一次性）
- 若检测到 CodeGraph 尚未安装，自动安装并注册 MCP 服务到
~/.claude.json（代码语义索引，加速 AI 代码理解）
重载 Claude Code 即可使用。
yu-method 可选接入一个与系统 gbrain 完全隔离的专属知识库（yu-gbrain），可将团队的技术决策记录、事故复盘、编码规范等 Markdown 文档同步进来，让 AI 在调研、规划、架构等环节自动检索团队上下文。
Important
知识库运行时 gbrain 是一个独立工具，不随 yu-method 提供，也不在公共 npm 仓库上。如果你的组织分发了 gbrain，安装好并确保 gbrain 命令在 PATH 中即可；否则跳过本步——所有 /yu-* 技能在没有知识库时照常工作。yu-brain-setup 检测不到 gbrain 会直接优雅退出，不做任何更改。
一次性初始化（每人只需运行一次）：
yu-brain-setup脚本会自动完成：
- 初始化
~/.yu/gbrain（与系统~/.gbrain完全隔离） - 初始化本地共享知识库骨架并导入
- 配置共享知识库目录：默认联合库
~/Documents/yu/brain，个人库~/Documents/yu/brain/personal，团队库镜像~/Documents/yu/brain/team - 将
yu-gbrainMCP 写入以下位置（仅写入已存在的配置文件，不强制创建）：- 项目级
.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。
进入每个 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在 Claude Code 会话中输入 /yu-help，看到 YU 工作流菜单即为成功。
安装成功后，建议阅读 研发流程指南，了解面对不同规模需求时应选用哪些技能、按什么顺序推进：
| 规模 | 入口技能 | 详细流程 |
|---|---|---|
| 🟢 小需求（单一目标） | /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 自动调用合适的 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 |
轻量端到端：意图→计划→实现→审查 | |
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） |
| 命令 | 码 | 用途 |
|---|---|---|
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 仍作别名可用 |
| 命令 | 码 | 用途 |
|---|---|---|
yu-prd |
PRD | PRD 创建 / 编辑 / 验证三合一 |
yu-ux |
CU | UX 设计引导 |
| 命令 | 码 | 用途 |
|---|---|---|
yu-create-architecture |
CA | 技术决策文档化 |
yu-create-epics-and-stories |
CE | 分解为 Epics 和 Stories |
yu-check-implementation-readiness |
IR | PRD / 架构 / Stories 对齐验证 |
| 命令 | 码 | 用途 |
|---|---|---|
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 审核流程） |
- 新建
skills/yu-your-skill/SKILL.md（从任意现有文件复制委派模板） - 在
.claude-plugin/marketplace.json的skills数组追加"./skills/yu-your-skill" - 在
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@latestYU-METHOD 在运行时依赖 BMAD-METHOD 提供的通用敏捷工作流能力。两者相互独立：BMAD 负责通用流程的持续演进，YU-METHOD 负责团队专属内容的沉淀与扩展。BMAD-METHOD 以 MIT 协议开源，YU-METHOD 与其项目方无从属关系。