blueprint-development

/blueprint:development

Blueprint Development 方法论的指南和参考，该方法论可根据 PRD（产品需求文档）生成项目专属的行为规则和工作流命令。

何时使用此技能

在以下情况下使用此技能……	在以下情况下使用替代方案……
在项目中开始使用 Blueprint Development	项目已在使用 Blueprint（请使用 /blueprint:status）
需要根据 PRD 生成规则	准备启动一个尚无 PRD 的全新项目
希望获得项目专属的行为准则	使用通用开发实践
为项目创建工作流自动化	在没有项目上下文的情况下处理独立任务

有关规则模板、命令模板和生成指南的详细信息，请参阅 REFERENCE.md。

上下文

• Blueprint 已初始化： !find . -path '*/docs/blueprint/*' -maxdepth 3 -name 'manifest.json' -type f
• PRD 文件： !find . -path '*/docs/prds/*' -name "*.md" -type f
• 规则目录： !find . -path '*/.claude/rules' -maxdepth 2 -type d
• 现有规则： !find . -path '*/.claude/rules/*' -maxdepth 3 -name "*.md"
• 项目类型： !find . -maxdepth 1 \( -name 'package.json' -o -name 'pyproject.toml' -o -name 'Cargo.toml' -o -name 'go.mod' \) -type f -print -quit

执行

执行完整的 Blueprint Development 设置和规则生成工作流：

步骤 1：确认项目已准备就绪

检查上述上下文值：

1. 如果 Blueprint 已初始化 = "NO" → 错误："Blueprint 尚未初始化。请先运行 /blueprint:init"
2. 如果 PRD 文件 = "0" → 错误："未找到 PRD。请先在 docs/prds/ 中创建至少一个 PRD，然后再生成规则"
3. 如果规则目录 = "NO" → 创建：mkdir -p .claude/rules

步骤 2：分析 PRD 并提取模式

读取 docs/prds/ 中的所有 PRD 文件，并提取：

1. 架构模式：项目结构、依赖注入、错误处理、模块边界、分层、代码组织
2. 测试策略：TDD 工作流、测试类型（单元、集成、端到端）、模拟模式、覆盖率要求
3. 实现指南：实现各类功能（API、UI、数据库、外部服务）的模式
4. 质量标准：代码审查清单、性能基线、安全要求、风格标准

有关各类别的具体提取模式，请参阅 REFERENCE.md。

步骤 3：在 .claude/rules/ 中生成四条行为规则

创建项目专属规则，以指导 Claude 在开发期间的行为：

三个必需的核心规则：

1. architecture-patterns.md - 项目结构、设计模式、依赖管理、错误处理、集成模式
2. testing-strategies.md - TDD 工作流、测试结构、测试类型、模拟模式、覆盖率要求
3. quality-standards.md - 代码审查清单、性能基线、安全标准、风格、文档

一条可选的高级规则（如适用）：

4. implementation-guides.md - 根据 PRD 实现特定功能类型的分步模式

对于每个规则文件：

• 使用 REFERENCE.md 中的模板
• 直接从 PRD 中提取内容
• 包含代码示例和具体引用
• 记录架构选择的理由
• 使用祈使语气（“使用……”“遵循……”“确保……”）

有关创建有效规则的详细指南，请参阅 REFERENCE.md。

第 4 步：生成工作流命令

在 .claude/skills/ 或 docs/blueprint/ 中创建项目专属的工作流命令：

六个核心命令：

1. /blueprint:init - 初始化 Blueprint Development 结构
2. /blueprint:generate-rules - 根据 PRD 生成项目规则（主要入口）
3. /blueprint:generate-commands - 根据项目类型生成工作流命令
4. /blueprint:work-order - 创建隔离的工单，供子 Agent 执行
5. /project:continue - 分析状态并恢复开发
6. /project:test-loop - 运行自动化 TDD 循环

对于每个命令：

• 确定项目类型和语言
• 提取测试运行器、构建命令和开发工作流
• 使用 REFERENCE.md 自定义命令实现
• 根据预期的 allowed-tools 权限进行验证

第 5 步：在清单中创建映射

更新 docs/blueprint/manifest.json，包含：

{
  "generated": {
    "rules": [
      "architecture-patterns.md",
      "testing-strategies.md",
      "quality-standards.md",
      "implementation-guides.md"
    ],
    "commands": [
      "blueprint-init.md",
      "blueprint-generate-rules.md",
      "blueprint-generate-commands.md",
      "blueprint-work-order.md",
      "project-continue.md",
      "project-test-loop.md"
    ]
  },
  "source_prds": ["project-overview.md"],
  "last_generated": "ISO-8601-timestamp"
}

这样即可在重新生成时保留自动生成内容与手动创建内容的记录。

第 6 步：测试和验证

验证规则和命令是否正常运行：

1. 测试规则是否生效：检查 Claude 在开发过程中是否遵循 architecture-patterns、testing-strategies 和 quality-standards
2. 测试命令是否执行：运行每个命令，验证其是否按预期工作
3. 验证输出质量：检查生成的规则是否符合 PRD 要求并包含具体示例
4. 按需改进：根据反馈和实际项目开发情况更新规则和命令

第 7 步：报告结果和后续步骤

创建总结报告：

• 已生成规则：.claude/rules/ 中共 {count} 条
• 已创建命令：{count} 条（使用 /project:continue 开始开发）
• 已更新清单中的跟踪元数据
• 后续步骤：
  1. 检查生成的规则是否准确
  2. 添加项目专属补充内容或说明
  3. 运行 /project:continue，开始 Blueprint Development 工作流
  4. 使用 /blueprint:work-order 为团队成员创建隔离任务

与 Blueprint Development 集成

此技能支持 Blueprint Development 的核心工作流：

PRD（需求）- 规则（行为准则）- 命令（工作流自动化）- 工单（隔离任务）

通过根据 PRD 生成项目专属规则和命令，Blueprint Development 能够创建自我文档化、面向 AI 的开发环境，让行为准则、模式和质量标准成为一等公民。

GitHub 工单集成

工单可以关联到 GitHub issue，以支持透明协作开发。有关工作流模式（--no-publish、--from-issue N）、标签设置、完成流程和工单文件格式，请参阅 REFERENCE.md。

Agentic 优化

上下文	操作
检查规则是否存在	find .claude/rules -maxdepth 1 -name "*.md" | wc -l
列出现有规则	ls -1 .claude/rules/*.md 2>/dev/null
统计 PRD 数量	ls docs/prds/*.md 2>/dev/null | wc -l
提取 PRD 章节	使用 Grep 根据标题模式查找特定章节
快速生成	跳过人工审查步骤，直接使用标准模板

示例

完整的工作流文档和示例，请参阅 .claude/docs/blueprint-development/。

---

有关详细的规则模板、命令示例、提取模式和项目专属定制，请参阅 REFERENCE.md。