Blueprint Skill 负责将一句话目标自动拆解为 3~12 步、带有依赖关系和并行标识的可执行工程蓝图；Ralphinho RFC Pipeline 则基于 RFC（Request for Comments）驱动，将大型需求编排为多 Agent DAG 工作流，通过工作单元（Work Unit）和合并队列机制实现系统级交付。两者结合，构成了 Everything Claude Code 体系中从目标定义到多会话协作落地的核心自动化管线。

Blueprint Skill 与 RFC Pipeline：从一行目标到多会话工程蓝图的自动生成

在采用 Claude Code 等 AI 编程助手进行复杂项目开发时，最大挑战往往不是单次代码生成，而是如何将一个宏大的业务目标（如“重构支付系统”、“将数据库迁移到 PostgreSQL”）转化为一系列清晰、可执行、可追踪的工程任务。传统的任务拆解依赖人工经验，容易遗漏依赖、混淆并行关系，并在多次会话中丢失上下文，导致 Agent 协作混乱和返工。

Everything Claude Code 体系为此提供了两大核心 Skill：Blueprint Skill 和 Ralphinho RFC Pipeline。它们共同构建了一条从“一行目标”到“多会话、多 Agent 协同交付”的自动化管线，是实践工程化 AI 辅助编程的关键。

一、Blueprint Skill：将一行目标扩展为结构化工程蓝图

Blueprint Skill 是一个工程计划自动生成器，其核心价值在于将模糊的目标声明自动拆解为一份可被子 Agent 冷启动执行的 Markdown 计划。

1. 核心价值与适用场景

解决的问题：

目标模糊，拆解困难：开发者输入一句自然语言目标，系统自动进行结构化分析。
上下文丢失：每个生成的步骤都包含自包含的上下文说明、任务清单和验证命令，即使没有前置会话历史，子 Agent 也能立即开始工作。
并行混乱：自动识别步骤间的依赖关系，明确标识可并行执行的任务。
计划质量无保障：内置对抗式审查，由最强模型子 Agent 检查计划完整性与反模式。

典型场景：

需要拆分为多个 PR 的大型功能开发。
计划跨多次会话的数据库迁移、架构重构。
涉及多 Agent 并行协作的复杂系统集成。

2. 五阶段自动化生成流程

触发后（例如在 Claude Code 中输入 /blueprint "your goal"），Blueprint Skill 会依次执行以下五个阶段：

Research（调研）：自动检测 git、gh CLI、项目结构等环境，读取可能存在的历史计划或记忆文件，收集完整上下文。
Design（设计）：将目标拆解为 3~12 个“一 PR 一步”的子任务。此阶段会自动分配依赖关系、串行/并行顺序，并为不同步骤建议模型分级（例如，接口设计使用最强模型，具体实现使用默认模型）。
Draft（起草）：生成结构化的 Markdown 蓝图文件（通常保存在 plans/ 目录下）。每个步骤包含：
- Context（上下文）：该步骤的背景和必要性。
- Tasks（任务清单）：具体的实施动作。
- Verification（验证命令）：用于检查步骤是否成功的命令（如 npm run test）。
- Exit Criteria（退出标准）：明确的完成定义。
Review（审查）：由最强模型子 Agent（如 Opus）对整个蓝图进行对抗式审查。重点检查：步骤完整性、依赖关系正确性、是否遗漏测试或回滚策略等常见反模式。审查发现的关键问题会在此阶段自动修正。
Register（注册）：将最终确认的蓝图文件保存，并更新相关记忆索引，最后向用户汇报生成的步骤数、关键依赖和并行化摘要。

3. 输出示例

执行命令后，你会在项目中看到类似如下的蓝图文件：

/blueprint myapp "extract authentication into a separate service"

生成的 plans/myapp-extract-authentication-service.md 内容片段：

# Step 1: Define Authentication Service API Contract
- **Context**: 当前认证逻辑散落在主应用各处，需抽离为独立服务。首先需定义清晰的 API 接口。
- **Tasks**:
  - 编写 OpenAPI 规范文件 `auth-service/openapi.yaml`。
  - 定义请求/响应的数据模型（DTOs）。
- **Verification**:
  - `npx @redocly/cli lint auth-service/openapi.yaml`
- **Exit Criteria**:
  - API 规范文件无 lint 错误，团队评审通过。
- **Dependencies**: None. (此步骤可立即并行开始)
- **Suggested Model**: Claude 3.5 Sonnet (用于 API 设计)

# Step 2: Implement Core Authentication Logic
- **Context**: 基于已定义的 API 合约，实现用户认证的核心逻辑。
- **Tasks**:
  - 创建 `auth-service/src/auth.controller.ts`。
  - 实现 JWT 生成、验证、密码哈希等工具函数。
- **Verification**:
  - `npm run test --prefix auth-service`
- **Exit Criteria**:
  - 所有单元测试通过。
- **Dependencies**: [Step 1]
- **Suggested Model**: Default (用于具体实现)

这份蓝图可以直接交给子 Agent 分步执行，每个子 Agent 都能凭借该步骤的说明独立完成工作。

二、Ralphinho RFC Pipeline：RFC 驱动的多 Agent DAG 执行引擎

当需求的复杂度更高、跨越多个系统模块、涉及高风险变更（如数据库 Schema 修改、安全认证体系重构）时，单份蓝图可能不足以管理其中的并行、依赖、回滚和集成风险。此时，Ralphinho RFC Pipeline 便发挥作用。

1. 核心概念与价值

RFC Pipeline 将整个开发过程建模为一个 DAG（有向无环图）。它以结构化的 RFC 文档为输入，自动将其分解为多个工作单元（Work Unit），每个单元是一个独立、可验证、可回滚的任务包。多个 Agent 按照 DAG 的依赖关系并行或串行执行这些单元，最终通过一个合并队列（Merge Queue） 机制进行系统集成，确保变更的原子性和一致性。

2. 完整工作流程

整个流程严格遵循七个步骤，形成一个闭环：

RFC Intake（需求接收）：接收一份描述目标、背景、约束和验收标准的 RFC 文档。

DAG Decomposition（DAG 拆解）：这是核心步骤。Skill 将 RFC 拆分为多个工作单元，并显式定义它们之间的依赖关系。每个工作单元被定义为一个 JSON 结构（WorkUnit），包含关键字段：

id: 唯一标识符。
depends_on: 依赖的其它工作单元 ID 列表。
scope: 单元具体工作范围。
acceptance_tests: 验收测试条件。
risk_level: 风险等级（如 Tier 1, Tier 3），用于分配最合适的 Agent。
rollback_plan: 回滚方案。

[
  {
    "id": "unit-rbac-schema",
    "depends_on": [],
    "scope": "设计并执行 RBAC 权限表的数据库迁移",
    "acceptance_tests": ["迁移脚本可重复执行", "旧数据成功迁移至新表"],
    "risk_level": "Tier 3",
    "rollback_plan": "提供逆向迁移脚本，并保留旧表一周"
  },
  {
    "id": "unit-auth-middleware",
    "depends_on": ["unit-rbac-schema"],
    "scope": "重写权限校验中间件，基于新表结构",
    "acceptance_tests": ["所有关键接口的权限测试用例通过"],
    "risk_level": "Tier 2",
    "rollback_plan": "在 feature flag 后保留旧中间件接口"
  }
]

Unit Assignment（单元分配）：根据风险等级和工作范围，将每个单元自动分配给最合适的专业 Agent（例如，数据库单元分配给 Database Reviewer Agent，安全相关单元分配给 Security Reviewer Agent）。
Unit Implementation（单元实现）：被分配的 Agent 执行“研究 -> 制定实现计划 -> 编码 -> 编写测试 -> 自审”的闭环流水线。
Unit Validation（单元验证）：对每个单元执行其定义的验收测试和质量门控（可能包括代码审查、安全扫描）。未通过的单元会被阻断，并反馈信息等待修复。
Merge Queue & Integration（合并队列与集成）：这是保障系统一致性的关键。Skill 维护一个合并队列：
- 依赖解析：只有某个单元的所有 depends_on 单元都已验证通过，它才有资格进入队列头部。
- 自动 Rebase：合并前，自动将单元的变更 rebase 到最新的集成分支（如 main）上。
- 集成测试：合并后，立即触发系统级集成测试。
- 自动回滚：如果集成测试失败，该单元的合并会被自动回滚，并生成风险报告。
Final System Verification（系统验收）：所有单元成功集成后，生成最终的系统验收报告，包含完整的依赖图快照、风险摘要和 scorecard，作为 RFC 执行的完整记录。

三、Blueprint Skill 与 RFC Pipeline 的协作模式

两者并非互斥，而是可以构成一个更强大的工作流：

Blueprint 作为 RFC 的细化阶段：对于一个大型 RFC，可以先使用 Blueprint Skill 生成一个高层次的执行蓝图（例如，步骤1：设计 API；步骤2：实现 Service A；步骤3：实现 Service B…）。
RFC Pipeline 执行具体步骤：然后，将蓝图中的某个复杂步骤（如“实现 Service A”）作为一个新的子 RFC，交给 Ralphinho RFC Pipeline 进行更细粒度的 DAG 拆解和多 Agent 并行执行。
统一验证与编排：两个流程都可以与 Verification Loop Skill 无缝集成，为每个蓝图步骤或 RFC 工作单元注入质量门控。Blueprint 生成的计划为 RFC Pipeline 提供了清晰的输入边界。

四、验证与最佳实践

验证 Blueprint 输出：生成蓝图后，首先人工审查其步骤划分是否合理、依赖关系是否正确。可以通过运行 Verification Loop Skill 对蓝图文件本身进行一次“计划审查”。
管理 RFC 执行状态：RFC Pipeline 会输出结构化的日志和 scorecard。利用这些信息可以实时监控各工作单元的状态，在出现卡死单元时，Skill 会自动将其移出队列并缩小范围重试。
环境降级：Blueprint Skill 在无 git/gh 环境下仍能工作，但会降级为“直接编辑模式”，省略分支、PR 相关的自动化步骤。
从简单开始：对于中等复杂度任务，先尝试使用 Blueprint Skill 生成蓝图。只有当任务确实跨越多个高风险模块时，再引入 RFC Pipeline 进行编排。

通过 Blueprint Skill 和 RFC Pipeline，开发者将复杂的工程目标转化为机器可理解、可编排、可验证的任务图，真正实现了从“一句话需求”到“系统性交付”的跨越，是构建生产级 AI 辅助编程工作流不可或缺的组件。

FAQ

Q: Blueprint Skill 和普通的任务列表（Task List）有什么根本区别？ A: 普通任务列表是静态的，缺乏上下文和依赖管理。Blueprint Skill 生成的蓝图每一步都包含自足的执行上下文、验证命令和明确的退出标准，并能自动识别步骤间的依赖与并行关系，专为多 Agent 冷启动协作设计。

Q: 如果某个 RFC 工作单元长时间未完成，Pipeline 会卡住吗？ A: 不会。Ralphinho RFC Pipeline 具有恢复机制。如果检测到某个单元执行超时或卡死，它会自动将该单元移出当前活跃的合并队列，快照其当前进展，然后可能缩小该单元的范围并重试，从而避免阻塞整个流水线。

Q: 没有安装 git 或 GitHub CLI (gh)，还能使用这些工具吗？ A: 可以。Blueprint Skill 会自动检测环境。如果没有版本控制工具，它会降级到“直接编辑模式”，仍然可以生成完整的工程蓝图，只是蓝图中不会包含自动创建分支、Pull Request 或触发 CI 的指令。RFC Pipeline 也主要关注于任务编排逻辑，其核心功能不强依赖于特定的 VCS 工具。

Blueprint Skill 与 RFC Pipeline：从一行目标到多会话工程蓝图的自动生成 #

一、Blueprint Skill：将一行目标扩展为结构化工程蓝图 #

1. 核心价值与适用场景 #

2. 五阶段自动化生成流程 #

3. 输出示例 #

二、Ralphinho RFC Pipeline：RFC 驱动的多 Agent DAG 执行引擎 #

1. 核心概念与价值 #

2. 完整工作流程 #

三、Blueprint Skill 与 RFC Pipeline 的协作模式 #

四、验证与最佳实践 #

FAQ #