最佳实践

完整研发流程

MCP Probe Kit 的 27 个工具覆盖了从需求分析到代码上线的完整研发流程。以下是推荐的最佳实践。

💡 核心理念：通过工作流编排工具（start_*）串联整个开发流程，让 AI 成为你的研发助手。

阶段 0：产品设计（从需求到原型）

🎯 0.1 完整产品设计流程（推荐）

使用 start_product 工作流编排，一键完成从需求到 HTML 原型的完整产品设计。

最佳实践

你: 我有一个产品需求文档 project.md，帮我生成完整的产品设计

AI: 使用 start_product 工具
requirements_file: "project.md"
product_name: "在线教育平台"
product_type: "Education"

→ 自动执行：
  ✓ 步骤 1: 检查/生成项目上下文
  ✓ 步骤 2: 生成 PRD 文档
  ✓ 步骤 3: 生成原型设计文档
  ✓ 步骤 4: 生成设计系统
  → 步骤 5: 生成 HTML 可交互原型
  ✓ 步骤 6: 更新项目上下文索引

→ 输出文件：
  - docs/prd/product-requirements.md
  - docs/prototype/prototype-index.md
  - docs/prototype/page-*.md
  - docs/design-system.json
  - docs/html-prototype/index.html

📄 0.2 单独生成 PRD 文档

使用 gen_prd 工具单独生成产品需求文档。

最佳实践

你: 生成一个在线教育平台的 PRD

AI: 使用 gen_prd 工具
description: "在线教育平台，支持课程管理、视频播放、作业提交"
product_name: "EduPlatform"

→ AI 根据指导创建 docs/prd/product-requirements.md

PRD 包含：
  - 产品概述（愿景、目标用户、核心价值）
  - 功能需求（核心功能、用户故事）
  - 功能优先级（P0/P1/P2）
  - 非功能性需求（性能、安全、兼容性）
  - 页面清单

🎨 0.3 生成 HTML 可交互原型

使用 start_ui 工具基于原型文档生成 HTML 原型。

最佳实践

AI: 使用 start_ui 工具
description: "基于原型文档生成所有页面的 HTML 原型"

→ 自动执行：
  ✓ 读取 docs/prototype/ 下的所有原型文档
  ✓ 读取 docs/design-system.json 获取设计规范
  ✓ 为每个页面生成 HTML 文件
  ✓ 生成索引页面 index.html

→ 输出：
  - docs/html-prototype/index.html
  - docs/html-prototype/page-*.html

→ 特点：
  - 使用设计系统的颜色和字体
  - 包含页面导航
  - 响应式设计

✅ 0.4 产品设计工作流总结

推荐流程：

准备需求文档（Markdown 格式）
使用 start_product 一键生成完整产品设计
在浏览器中查看 HTML 原型
与团队评审原型，收集反馈
根据反馈调整原型文档
使用 start_ui 重新生成 HTML 原型
确认后进入开发阶段

阶段 1：需求分析与规划

🚀 1.1 新项目启动

使用 init_project 按 Spec-Driven Development 方式生成项目文档。

最佳实践

你: 我要创建一个任务管理系统

AI: 使用 init_project 工具
input: "任务管理系统，支持任务创建、分配、跟踪、提醒"
project_name: "TaskManager"

→ 生成：需求文档、设计文档、任务清单

💬 1.2 需求澄清（避免理解偏差）

使用 interview 工具进行结构化需求访谈。

最佳实践

你: 添加用户登录功能

AI: 使用 interview 工具
description: "实现用户登录功能"

→ AI 会提问：
  - 支持哪些登录方式？（邮箱/手机/第三方）
  - 是否需要记住登录状态？
  - 密码规则是什么？
  - 是否需要验证码？

→ 生成：访谈记录文档

📊 1.3 工作量估算

使用 estimate 工具估算开发时间和资源。

最佳实践

AI: 使用 estimate 工具
task_description: "实现用户认证功能"
experience_level: "mid"
team_size: 2

→ 输出：
  - 故事点：8 SP
  - 时间范围：乐观 3天 / 正常 5天 / 悲观 8天
  - 风险点：第三方登录集成可能延期

🕸️ 1.4 现有代码图谱洞察

使用 code_insight 快速分析调用链、上下文和影响范围，并为后续 start_feature/start_bugfix 提供图谱上下文。

最佳实践

你: 请分析登录与 token 刷新相关的调用链，看看改动会影响哪些模块

AI: 使用 code_insight 工具
mode: "query"
query: "login token refresh auth flow"
goal: "找出现有登录与 token 刷新流程"
task_context: "准备修改认证模块"

→ 输出：
  - 相关执行流 / 调用链
  - 关键符号与文件位置
  - _meta.graph.snapshotUri / markdownFilePath
  - 供后续编排复用的 docs/graph-insights/latest.* 与 project-context 索引入口

阶段 2：功能开发

🛠️ 2.1 完整功能开发流程（推荐）

使用 start_feature 工作流编排，一键完成从规格到估算。

最佳实践

你: 开发用户认证功能

AI: 使用 start_feature 工具
description: "用户认证功能，支持邮箱登录和 Google 登录"
feature_name: "user-auth"

→ 自动执行：
  ✓ 检查项目上下文与可用图谱快照
  ✓ 生成功能规格文档
  ✓ 估算开发工作量
  ✓ 输出完整开发计划

🎨 2.2 UI 开发流程

使用 start_ui 工作流，从设计系统到代码一气呵成。

最佳实践

你: 创建登录页面

AI: 使用 start_ui 工具
description: "登录页面，包含邮箱密码输入和 Google 登录按钮"
framework: "react"

→ 自动执行：
  ✓ 检查/生成设计系统
  ✓ 初始化组件目录
  ✓ 搜索/生成 UI 模板
  ✓ 渲染最终 React 代码

⚡ 2.3 代码生成

根据需要使用各种生成工具：

genapi - 生成 API 文档（OpenAPI/Swagger）
gensql - 自然语言生成 SQL 查询
gen_mock - 生成测试数据
gentest - 生成单元测试

阶段 3：代码质量保障

🔍 3.1 全面代码审查（推荐）

使用 start_review 工作流，一次性完成代码审查、安全扫描、性能分析。

最佳实践

你: 审查这段代码

AI: 使用 start_review 工具
code: "function login(user, pass) { ... }"

→ 自动执行：
  ✓ 代码审查（质量、风格、最佳实践）
  ✓ 安全扫描（SQL注入、XSS、CSRF）
  ✓ 性能分析（算法、内存、数据库）
  ✓ 输出综合报告

🎯 3.2 单项检查

针对特定问题使用单项工具：

code_review - 代码审查
security_scan - 安全扫描
perf - 性能分析
refactor - 重构建议

阶段 4：Bug 修复

🐛 4.1 系统化 Bug 修复（推荐）

使用 start_bugfix 工作流，从分析到测试一站式解决。

最佳实践

你: 登录功能报错了

AI: 使用 start_bugfix 工具
error_message: "TypeError: Cannot read property 'token' of undefined"
stack_trace: "at login.js:45:12"

→ 自动执行：
  ✓ 检查项目上下文与可用图谱快照
  ✓ 分析错误原因
  ✓ 定位问题代码
  ✓ 提供修复方案
  ✓ 生成测试用例

⚠️ 4.2 快速 Bug 分析

使用 fix_bug 工具快速分析问题并提供修复方案。

阶段 5：版本发布

🚀 5.1 自动化发布流程（推荐）

使用 start_release 工作流，自动生成 Changelog 和 PR 描述。

最佳实践

你: 准备发布 v2.0.0

AI: 使用 start_release 工具
version: "v2.0.0"
from_tag: "v1.9.0"

→ 自动执行：
  ✓ 生成 CHANGELOG（按 feat/fix/breaking 分类）
  ✓ 生成 PR 描述（变更摘要、影响范围）
  ✓ 输出发布检查清单

🔀 5.2 Git 工作流

使用 Git 工具提升协作效率：

gencommit - 生成规范的 commit 消息
genchangelog - 生成 CHANGELOG
genpr - 生成 PR 描述
resolve_conflict - 解决合并冲突

阶段 6：项目维护

👋 6.1 新成员上手

使用 start_onboard 工作流，快速了解项目。

最佳实践

新成员: 我刚加入项目，需要了解项目结构

AI: 使用 start_onboard 工具

→ 自动执行：
  ✓ 生成上下文文档
  ✓ 输出开发规范

📚 6.2 文档维护

使用 start_doc 工作流，一键补全项目文档。

最佳实践

AI: 使用 start_doc 工具
code: "整个项目代码"

→ 自动执行：
  ✓ 生成代码注释（JSDoc/TSDoc）
  ✓ 生成 README 文档
  ✓ 生成 API 文档
  ✓ 输出完整文档集

高级实践：Ralph Wiggum Loop

🔄 自动化循环开发

使用 start_ralph 启动自动化开发循环，AI 持续迭代直到完成目标。

高级实践

你: 实现用户认证功能

AI: 使用 start_ralph 工具
goal: "实现用户认证功能，包含登录、注册、密码重置"
mode: "safe"  // 启用安全保护
max_iterations: 8
max_minutes: 25

→ AI 自动循环：
  第1轮：分析需求 → 生成代码
  第2轮：运行测试 → 修复错误
  第3轮：代码审查 → 优化代码
  ...
  直到：测试通过 + 需求满足

⚠️ 安全提示：Ralph Loop 默认启用多重安全保护（最大迭代次数、运行时间、代码变更量限制），防止失控。

最佳实践总结

核心原则：

优先使用工作流编排工具（start_*）- 自动化完整流程
需求阶段使用 interview - 避免理解偏差
开发前使用 estimate - 合理规划时间
提交前使用 start_review - 保证代码质量
发布前使用 start_release - 规范发布流程

完整研发流程

阶段 0：产品设计（从需求到原型）

🎯 0.1 完整产品设计流程（推荐）

📄 0.2 单独生成 PRD 文档

🎨 0.3 生成 HTML 可交互原型

✅ 0.4 产品设计工作流总结

阶段 1：需求分析与规划

🚀 1.1 新项目启动

💬 1.2 需求澄清（避免理解偏差）

📊 1.3 工作量估算

🕸️ 1.4 现有代码图谱洞察

阶段 2：功能开发

🛠️ 2.1 完整功能开发流程（推荐）

🎨 2.2 UI 开发流程

⚡ 2.3 代码生成

阶段 3：代码质量保障

🔍 3.1 全面代码审查（推荐）

🎯 3.2 单项检查

阶段 4：Bug 修复

🐛 4.1 系统化 Bug 修复（推荐）

⚠️ 4.2 快速 Bug 分析

阶段 5：版本发布

🚀 5.1 自动化发布流程（推荐）

🔀 5.2 Git 工作流

阶段 6：项目维护

👋 6.1 新成员上手

📚 6.2 文档维护

高级实践：Ralph Wiggum Loop

🔄 自动化循环开发

最佳实践总结

更多资源

🚀 开始实践