项目规划工具

一个用于结构化Laravel项目规划的工具,可扫描项目、创建任务票并导出为JSON格式。

  • by brnbio
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 brnbio/project-planner-mcp

使用说明

项目规划师MCP

用于结构化Laravel项目规划的MCP服务器。扫描您的项目,创建门票,导出为JSON。

inspect → plan → export → GitLab/Todoist

安装

通过Claude Code(推荐)

claude mcp add project-planner -- npx @brnbio/project-planner-mcp

曼努埃尔 ~/.claude.json

{
  "mcpServers": {
    "project-planner": {
      "command": "npx",
      "args": ["@brnbio/project-planner-mcp"]
    }
  }
}

然后重新启动Claude Code。


用法

步骤1:分析项目

导航到您的 Laravel 项目并启动 Claude Code:

cd /pfad/zu/deinem/laravel-projekt
claude

然后:

> Analysiere das Projekt.
> Aktueller Stand: Auth funktioniert, Dashboard ist leer
> Ziel: User können Zeiten erfassen und sehen eine Wochen-Übersicht

Claude 使用 inspect 自动扫描:

  • 模型+关系
  • 迁移(数据库架构)
  • 控制器+方法
  • 路线
  • Vue页面和组件

输出: project_context.json

步骤2:安排门票

> Plane die Umsetzung

克劳德分析了IST和SOLL之间的差距,提出了问题:

  • 需要哪些实体?
  • 他们是怎么联系在一起的?
  • 他是MVP吗?

然后,它生成4小时/8小时估计的门票。

输出: tickets_draft.json

步骤3:导出门票

> Exportiere die Tickets

查看门票列表,然后确认。

输出: tickets_final.json

[
  {
    "title": "TimeEntry Model + Migration",
    "description": "Erstelle TimeEntry Model mit user_id, started_at, ended_at, description.\n\n## Checkliste\n- [ ] Migration erstellen\n- [ ] Model mit Fillables\n- [ ] Factory erstellen\n- [ ] Relation zu User",
    "estimate": "4h",
    "labels": ["Backend", "Database"]
  }
]

步骤 4:创建问题(可选)

使用现有的MCP:

> Erstelle GitLab Issues aus tickets_final.json
> Erstelle Todoist Tasks aus tickets_final.json

工具

工具 输入 输出
inspect 当前状态、目标状态 project_context.json
plan (澄清) tickets_draft.json
export 确认:true tickets_final.json

输出文件

所有文件最终都在项目目录中,并且可以修改版本:

dein-laravel-projekt/
├── project_context.json   # IST + SOLL + Analyse
├── tickets_draft.json     # Entwürfe
├── tickets_final.json     # Finale Tickets
└── ...

提示: 将 JSON 文件添加到 Git 作为规划文档。


票证架构

interface Ticket {
  title: string;
  description: string;      // Mit Markdown-Checkliste
  estimate: "4h" | "8h";
  labels: ("Backend" | "Frontend" | "Testing" | "Database")[];
}

技术栈

针对:

  • Laravel 12+惯性js v2
  • 视图3组成API
  • PestPHP
  • Tailwind CSS

发布(维护者)

npm login
npm publish --access public

许可证

麻省理工学院