# Qflow

> 驱动的项目管理 MCP 服务器，50 个工具覆盖任务管理、Spec 驱动开发、多 Agent 协作、自动驾驶引擎｜AI-powered project management MCP server — 50 tools for Claude Code / Cursor / Windsurf / Codex. Task tracking, spec-driven devAI elopment, multi-agent orchestration, complexity scoring, autopilot engine, quality gates. |

- **Type:** MCP server
- **Install:** `agentstack add mcp-pangu-immortal-qflow`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Pangu-Immortal](https://agentstack.voostack.com/s/pangu-immortal)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Pangu-Immortal](https://github.com/Pangu-Immortal)
- **Source:** https://github.com/Pangu-Immortal/qflow

## Install

```sh
agentstack add mcp-pangu-immortal-qflow
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

qflow

装上就能用的 AI 项目管理工具 — 不需要任何 API Key

  如果这个项目对你有帮助，请 &#11088; Star 支持一下！

[](LICENSE)
[](https://modelcontextprotocol.io)
[]()
[]()
[](https://www.typescriptlang.org)

[English](README-en.md)

---

## 💡 一句话介绍

qflow 是一个纯 MCP 工具层，让你的 AI 编辑器（Claude Code / Cursor / Windsurf / Codex）秒变项目经理。50 个工具、17 个上下文模块、34 种 Lottie 动画模板，只有 4 个运行时依赖，装上就用，不需要配置任何 API Key。

MCP（Model Context Protocol）是让 AI 编辑器连接外部工具的开放协议。

---

## ✨ 装上后你能做什么

不是功能列表，是你明天就能用的真实场景：

🗂️ **对 AI 说"帮我拆解这个需求"**
→ qflow 自动创建任务树，设置依赖关系，评估每个任务的复杂度（1-10 分）

📋 **对 AI 说"下一步做什么"**
→ qflow 分析依赖图谱和优先级，推荐最优任务，告诉你为什么

📝 **对 AI 说"写一个技术方案"**
→ qflow 管理 Spec 全生命周期——创建、变更提议、SHA-256 冲突检测、归档

📄 **对 AI 说"把这个 PRD 转成任务"**
→ qflow 解析 Markdown PRD，一键生成结构化任务树，自动建立依赖

🔄 **对 AI 说"进入自动驾驶"**
→ qflow 启动 Autopilot 引擎，令牌桶限流，自动推进任务链

🔍 **对 AI 说"帮我做个代码评审"**
→ qflow 召唤 12 个 Agent 角色（PM / 架构师 / QA / 安全 / DBA / DevOps），多视角对抗性评审

🎨 **对 AI 说"生成一个加载动画"**
→ qflow 从 34 种模板中选择，输出标准 Lottie JSON，直接用于 Android / iOS / Web

🏃 **对 AI 说"开始 Sprint"**
→ qflow 管理 Scrum 全流程——创建 Sprint、添加故事、完成回顾

🧪 **对 AI 说"用 TDD 方式开发"**
→ qflow 驱动红-绿-重构循环，自动跟踪每一步状态

🧠 **对 AI 说"加载 iOS 设计规范"**
→ qflow 按需注入 SwiftUI 约束知识，6 个平台的设计系统随时可用

---

## 🚀 30 秒安装

> 前置要求：[Node.js](https://nodejs.org) >= 18

```bash
git clone https://github.com/Pangu-Immortal/qflow.git
cd qflow
bash setup.sh
```

重启编辑器，完成。

**不需要配置 API Key。** qflow 是纯工具层，你的 AI 编辑器提供智能。所有 50 个工具开箱即用。

> 提示：在你的项目中将 `.qflow/` 加入 `.gitignore`，避免任务数据被提交到 Git。

---

## 🛠️ 支持的编辑器

**Claude Code** · **Cursor** · **Windsurf** · **Codex CLI** · 任何 MCP 兼容工具

---

## 📦 50 个工具一览

### 🗂️ 任务管理（15 个工具）

创建、拆解、依赖图谱（Kahn 环检测 + 关键路径）、7 态状态机、优先级排序、批量操作、标签工作区隔离、PRD 一键转任务树。

### 📝 Spec 驱动开发（8 个工具）

初始化、提议变更、SHA-256 冲突检测、确定性合并、3 维验证（完整性 / 正确性 / 一致性）、AI 内容生成、Living Spec 同步、归档。

### 🎯 工程质量（10 个工具）

5 维复杂度评分、12 角色多视角评审、对抗性辩论、TDD 红-绿-重构循环、Scrum Sprint 全流程、自动驾驶引擎（5 种预设）、治理宪章。

### 🧠 上下文模块（17 个）

9 个工程模块（核心规范 / 分析模式 / 开发模式 / UI 约束 / 上下文守卫 / 思维分层 / 铁律 / README 规范 / 逆向分析）+ 8 个设计系统模块（Web / App / iOS / Android / Game / Pencil / PPT / UI-Web）。按需加载，Token 感知，自动压缩。

### 🎨 Lottie 动画引擎

34 种模板，6 大分类（加载 / 反馈 / 交互 / 过渡 / 数据 / 空状态）。告诉 AI 你想要什么动画，qflow 输出标准 Lottie JSON。支持自定义颜色、尺寸、帧率。

### ⚙️ 其他工具

模板管理、插件系统、DAG 工作流编排、持久化记忆、会话交接、系统诊断、编辑器规则安装。

---

## 📊 同类产品对比

> **qflow 是目前唯一的 All-in-one 方案** —— 任务管理 + Spec 驱动 + 多角色评审 + 设计系统 + 动画引擎，一个工具全搞定。其他同类工具通常只覆盖其中一个方向。

| 维度 | **qflow** | Task Master AI | OpenSpec |
|------|-----------|----------------|----------|
| MCP 工具数 | **50** | 44 | 0（仅 CLI） |
| 运行时依赖 | **4 个** | 61 个 | 9 个 |
| 许可证 | **MIT（纯开源）** | MIT + Commons Clause | MIT |
| 需要 API Key | **不需要** | 需要 | 不需要 |
| Spec 管理 | **完整生命周期** | 无 | 有 |
| 设计系统上下文 | **6 个平台** | 无 | 无 |
| Lottie 动画引擎 | **34 种模板** | 无 | 无 |
| 多 Agent 评审 | **12 个角色** | 无 | 无 |

---

## ❓ 常见问题

**qflow 需要 API Key 吗？**
不需要。qflow 是纯 MCP 工具层，智能由你的 AI 编辑器（Claude Code / Cursor / Windsurf）提供。所有 50 个工具开箱即用，零配置。

**qflow 和 Task Master AI 有什么区别？**
Task Master 专注任务管理（44 工具）。qflow 是 All-in-one 方案（50 工具），额外提供 Spec 管理、12 角色评审、6 平台设计系统、Lottie 引擎、TDD、Sprint。而且 qflow 只有 4 个依赖（vs 61 个），纯 MIT 许可。

**支持哪些编辑器？**
任何 MCP 兼容工具：Claude Code、Cursor、Windsurf、Codex CLI、VS Code（通过 MCP）等。也可以直接用 CLI（`qflow task add`、`qflow task list`）。

**数据存在哪里？**
本地 `.qflow/` 目录，纯文件存储，无需外部数据库。所有数据在你的机器上，不会上传。

**qflow 是免费的吗？**
完全免费。MIT 协议开源，个人和商业使用均可。

---

## ⭐ Star History

[](https://star-history.com/#Pangu-Immortal/qflow&Date)

---

## 📄 许可证

[MIT](LICENSE) — 个人和商业使用均免费。

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Pangu-Immortal](https://github.com/Pangu-Immortal)
- **Source:** [Pangu-Immortal/qflow](https://github.com/Pangu-Immortal/qflow)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-pangu-immortal-qflow
- Seller: https://agentstack.voostack.com/s/pangu-immortal
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
