AI导哈

实施计划管理工具

PlanFlow是一个全面的实施计划管理工具，允许用户在VS Code中创建、验证和审查实施计划，并通过GitHub Copilot生成结构化计划，同时提供可视化审查界面。

  • by DabiK
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 DabiK/mcp-plan-generation

使用说明

🎯 MCP平面流

使用GitHub副驾驶管理您的实施计划

PlanFlow是一个全面的工具，允许您直接从VS代码创建、验证和审查实施计划。感谢 模型上下文协议（MCP），与GitHub副驾驶聊天以生成结构化计划，然后使用web界面直观地查看它们。

✨ 为什么是Planflow？

  • 🤖 Copilot集成 ：通过MCP创建自然语言计划
  • 📊 查看视频 ：具有阶段导航的现代web界面
  • 💾 坚持 ：MongoDB用于存储和版本控制您的计划
  • ⚡ 键盘快捷键 ：使用A（批准）、R（拒绝）、S（跳过）进行快速审查

🚀 快速启动

选项1:Docker（推荐）

# Cloner le projet
git clone <votre-repo>
cd MCP-Plan

# Démarrer l'environnement complet
  docker compose up --build

访问：

  • 接口审查 : http://localhost:4173
  • API REST : http://localhost:3000
  • MongoDB : mongodb://localhost:27017

备选方案2：地方发展

先决条件： Node.js≥18，pnpm≥8，MongoDB本地

# Installation
pnpm install

# Build
pnpm build

# Lancer les deux apps
pnpm dev

API正在运行 http://localhost:3000 et l'interview sur http://localhost:5174.

🔧 使用MCP配置vs代码

要直接在GitHub副驾驶聊天中使用PlanFlow，您需要 双选项 :

选项A:stdio模式（启动专用实例）

文件 .vscode/mcp.json 配置为启动MCP服务器的新实例：

{
  "mcpServers": {
    "planflow": {
      "command": "node",
      "args": ["${workspaceFolder}/packages/mcp-planflow/dist/index.js"],
      "env": {
        "MONGODB_URI": "mongodb://localhost:27017",
        "MONGODB_DB_NAME": "planflow",
        "NODE_ENV": "production",
        "HTTP_ENABLED": "false",
        "MCP_ENABLED": "true"
      }
    }
  }
}

优势 ：简单，无需单独的服务器
先决条件 ：项目构建（pnpm --filter mcp-planflow build)

选项B:HTTP模式（连接到当前服务器）

如果您已经通过启动服务器 pnpm dev 或Docker，登录：

{
  "mcpServers": {
    "planflow-http": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

优势 ：重用现有服务器，热重新加载可用，会话管理
先决条件 ：服务器启动（pnpm dev 或 docker compose up)
运输 ：流式HTTP（现代协议MCP 2025-11-25）

示例文件 ：见 .vscode/mcp-sse.json.example pour la config HTTP完成

💡 使用示例

创建实施计划

提示：

Crée-moi un plan d'implémentation pour ajouter un système d'authentification 
à mon app React avec JWT. Je veux :
- Login/register pages
- Protected routes
- Token refresh automatique
- Logout

MCP将生成一个包含步骤、依赖关系和验证的结构化计划。

验证现有计划

提示：

Valide le plan "auth-system-v2" et dis-moi s'il y a des problèmes 
(dépendances circulaires, IDs dupliqués, etc.)

检索和分析计划

提示：

Récupère le plan "auth-system-v2" et montre-moi les étapes critiques 
sur le chemin de la feature principale

审查联合国计划

提示：

Liste tous les plans en status 'draft' et montre-moi celui 
qui a le plus d'étapes bloquées

然后，您可以打开web界面进行可视化查看：

http://localhost:4173/plans/{planId}/review

创建具有复杂架构的计划

提示：

Génère un plan pour migrer notre backend Express vers NestJS :
- Phase 1 : Setup NestJS à côté de l'existant
- Phase 2 : Migration progressive des routes
- Phase 3 : Migration de la base de données
- Phase 4 : Décommissionnement de l'ancien code

Chaque phase doit avoir des étapes validables et des points de rollback.

✅ GitHub副驾驶的最佳实践

创建前计划的强制性验证

确保您的计划 有效且训练有素，我们建议在文件中添加语句 Agent.md （ou .agent.md 根据您的设置）：

## 📋 Validation des Plans d'Implémentation

Avant de créer un plan d'implémentation, **vous DEVEZ toujours :**

1. **Valider le plan en premier** : Utilisez l'outil `plans-validate` avec le contenu du plan
2. **Attendre la validation** : Assurez-vous que la réponse indique `"isValid": true`
3. **Corriger les erreurs** : Si des erreurs sont rapportées (path: `/steps/X/kind`, etc.), appliquez les corrections
4. **Créer uniquement après succès** : Une fois validé, utilisez `plans-create` avec le plan corrigé

### Exemple de flux correct :

[计划JSON初始值] ↓ 计划验证→检测到错误？ ↓ ↓ 否✓是→纠正 ↓ ↓ 计划创建Revalider


### Bénéfices :
- ✅ Évite les allers-retours de correction
- ✅ Plans conformes au schéma PlanFlow v1.1.0
- ✅ Feedback immédiat sur les erreurs de structure
- ✅ Économise token budget et temps

🎯 功能

  • MCP 服务器 ：GitHub副驾驶可用的10个工具

    • 创建、验证、恢复和更新计划
    • 步骤导航（下一步、上一步、上下文）
    • 计划和步骤的反馈管理

  • 界面Web :

    • 一步一步地对计划进行可视化审查
    • 带相位检测的导航迷你地图
    • 关于步骤的评论
    • 将评论导出为JSON格式
    • Raccourgis-clavier（A：批准，R：拒绝，S：跳过）

  • 持久性MongoDB ：您的所有计划都已保存并版本化

MCP工具可用

输出 描述
plans-format 获取完整的PlanFlow方案v1.1.0
plans-create 创建新计划
plans-get 按ID获取计划
plans-update 更新现有计划
plans-list 列出带有过滤器的计划
plans-validate 验证计划（方案、周期等）
steps-get 检索特定步骤
steps-navigate 导航（当前/下一步）
steps-context 步骤的上下文（依赖关系）
comments-manage 管理评论

屏幕画廊

🏠 出生表

附录页：

  • 统计快速（总计划、待定、进行中、已完成）
  • 快速访问以查看所有计划
  • 最近计划清单

🔍 计划的详细视图

L详细界面：

  • 概述 ：元数据、目标、范围、约束、成功标准
  • 计划信息（ID、标签、版本）
  • 导航条目（回顾、图表、步骤）

⭐ 接口审查

审查要点：

  • 小地图 ：导航可视化部分阶段（设置、实施、测试……）
  • 活动步骤 ：详细显示shell命令、说明、预计持续时间
  • 行动迅速 ：键盘快捷键（A=批准，R=拒绝，S=通过）
  • 评论 ：直接在步骤上添加注释

🧩 MCP用户界面（副驾驶聊天）

捕获GitHub副驾驶聊天（MCP应用程序）中的内置评论界面。

🤖 GitHub副驾驶集成

工作流程完成：

  • 笨拙 ：实时审查界面
  • 右边 ：GitHub副驾驶聊天与集成MCP工具
  • 底部 ：修改的文件和终端
  • 直接通过聊天创建和验证计划

🛠️ 有用的命令

# Arrêter Docker
docker compose down

# Nettoyer la base de données
docker compose down -v

# Rebuild après modifications
docker compose up --build

# Logs en temps réel
docker compose logs -f

📝 许可证

麻省理工学院

相关 MCP