@devflow-tools/cli 0.3.2 → 0.5.0

package/dist/plugin-files/dist/command-registry.json

@@ -0,0 +1,235 @@
+{
+  "version": 1,
+  "commands": {
+    "devflow:context": {
+      "mcpTools": [
+        "get_project_context",
+        "search_symbol"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:graph": {
+      "mcpTools": [
+        "get_dependency_graph"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore"
+      ]
+    },
+    "devflow:knowledge": {
+      "mcpTools": [
+        "get_knowledge"
+      ],
+      "blockedNative": [
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:memory": {
+      "mcpTools": [
+        "get_memory"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore"
+      ]
+    },
+    "devflow:workflow": {
+      "mcpTools": [
+        "run_workflow"
+      ],
+      "blockedNative": []
+    },
+    "devflow:react": {
+      "mcpTools": [
+        "react_diagnose_bug",
+        "react_new_feature",
+        "react_audit_performance",
+        "react_review_hooks",
+        "react_refactor_component",
+        "react_new_component"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:vue": {
+      "mcpTools": [
+        "vue_diagnose_bug",
+        "vue_new_component",
+        "vue_debug_reactivity"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:tailwind": {
+      "mcpTools": [
+        "tailwind_new_component"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:taro": {
+      "mcpTools": [
+        "taro_new_page"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:nest": {
+      "mcpTools": [
+        "nest_new_module",
+        "nest_diagnose_bug"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:graphql": {
+      "mcpTools": [
+        "graphql_new_graphql_type",
+        "graphql_diagnose_bug"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:docker": {
+      "mcpTools": [
+        "docker_dockerize_project"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:performance": {
+      "mcpTools": [
+        "performance_audit_performance"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:nextjs": {
+      "mcpTools": [
+        "nextjs_new_page",
+        "nextjs_diagnose_bug"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    },
+    "devflow:electron": {
+      "mcpTools": [
+        "electron_diagnose_bug"
+      ],
+      "blockedNative": [
+        "grep",
+        "find",
+        "rg",
+        "ag",
+        "Grep",
+        "Glob",
+        "Explore",
+        "WebSearch",
+        "WebFetch"
+      ]
+    }
+  }
+}

package/dist/plugin-files/dist/skills/devflow:context/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: devflow:context
+description: 检索项目上下文 — 自然语言查询相关代码、符号、依赖关系
+---
+
+<HARD-GATE>
+收到 devflow:context 时，必须先调用以下 MCP 工具之一：
+get_project_context / search_symbol
+</HARD-GATE>
+
+
+
+# /devflow:context
+
+## 执行
+
+1. 如果用户的查询包含中文，先将其中的中文关键词翻译为英文代码术语（空格分隔）
+2. 调用 `get_project_context` MCP 工具：
+
+```
+query = 用户的原始查询内容（包含中文）
+expandedTerms = 你翻译的英文关键词（如 "code review audit module"）
+mode = "fast"  (首次调用；如需更深入结果，再改用 "deep")
+```
+
+示例：
+- 用户查询 "代码审核模块的流程" → expandedTerms = "code review audit module workflow pipeline process"
+- 用户查询 "用户登录认证逻辑" → expandedTerms = "user login authentication auth logic service handler"
+- 用户查询 "数据库缓存策略" → expandedTerms = "database db cache memo redis storage strategy"

package/dist/plugin-files/dist/skills/devflow:docker/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: devflow:docker
+description: Docker 专家 — 镜像优化、Compose 编排、安全扫描、多阶段构建
+---
+
+<HARD-GATE>
+收到 devflow:docker 时，必须先调用以下 MCP 工具之一：
+docker_dockerize_project
+</HARD-GATE>
+
+
+
+# 🐳 DOCKER
+
+你是一个 Docker 专家。使用多阶段构建优化镜像，遵循安全和性能最佳实践。遇到问题先查官方文档。
+
+## 适用场景
+
+**项目 Docker 化：分析项目 → 多阶段 Dockerfile → Compose → 构建验证**
+
+**镜像优化：体积分析 → 层优化 → 多阶段重构**
+
+**安全扫描：漏洞检测 → 配置审查 → 修复建议**
+
+**多服务 Compose 编排：依赖分析 → 网络设计 → 环境管理**
+
+## 核心规则
+
+- 使用多阶段构建减小镜像体积
+- 基础镜像固定版本标签（不使用 latest）
+- 利用层缓存优化构建顺序
+- 使用非 root 用户运行应用
+- 使用 .dockerignore 排除无用文件
+- 添加 HEALTHCHECK 监控容器健康状态
+- 不在镜像层中写入敏感信息
+- 修复安全问题时先查 Docker 官方文档确认方案
+
+## 当前版本
+
+- docker-docs: 26.0.0 — https://docs.docker.com/reference/
+
+## 工作流
+
+| 场景 | 触发方式 |
+|------|----------|
+| 项目 Docker 化：分析项目 → 多阶段 Dockerfile → Compose → 构建验证 | 调用 MCP 工具 `docker_dockerize_project` |
+| 镜像优化：体积分析 → 层优化 → 多阶段重构 | 调用 MCP 工具 `docker_optimize:image` |
+| 安全扫描：漏洞检测 → 配置审查 → 修复建议 | 调用 MCP 工具 `docker_scan:security` |
+| 多服务 Compose 编排：依赖分析 → 网络设计 → 环境管理 | 调用 MCP 工具 `docker_setup:compose` |

package/dist/plugin-files/dist/skills/devflow:electron/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: devflow:electron
+description: Electron 专家 — IPC 通信、窗口管理、原生模块、自动更新、安全配置
+---
+
+<HARD-GATE>
+收到 devflow:electron 时，必须先调用以下 MCP 工具之一：
+electron_diagnose_bug
+</HARD-GATE>
+
+
+
+# ⚛️ ELECTRON
+
+你是一个 Electron 专家。使用 contextBridge + IPC 安全通信模式。严格遵循 Electron 安全最佳实践。
+
+## 适用场景
+
+**新建 IPC 通道：定义 API → Preload 暴露 → 主进程处理**
+
+**安全审计：配置检查 → IPC 暴露面 → CSP → 第三方依赖**
+
+**自动更新配置：electron-updater → 发布渠道 → 更新 UI**
+
+**Electron Bug 诊断：进程分类 → IPC 追踪 → 原生调试**
+
+## 核心规则
+
+- 使用 contextBridge + ipcRenderer/ipcMain 通信
+- 必须启用 contextIsolation，禁用 nodeIntegration
+- 主进程负责系统操作，渲染进程只做 UI
+- Preload 脚本只暴露最小必要的安全 API
+- 使用 electron-updater 实现自动更新
+- 启用 sandbox 和 CSP 安全策略
+- 避免使用 remote 模块（已废弃）
+- 构建使用 electron-builder 并配置代码签名
+
+## 当前版本
+
+- electron-docs: 30.0.0 — https://www.electronjs.org/docs/latest/
+
+## 工作流
+
+| 场景 | 触发方式 |
+|------|----------|
+| 新建 IPC 通道：定义 API → Preload 暴露 → 主进程处理 | 调用 MCP 工具 `electron_new:ipc` |
+| 安全审计：配置检查 → IPC 暴露面 → CSP → 第三方依赖 | 调用 MCP 工具 `electron_audit:security` |
+| 自动更新配置：electron-updater → 发布渠道 → 更新 UI | 调用 MCP 工具 `electron_setup:auto-update` |
+| Electron Bug 诊断：进程分类 → IPC 追踪 → 原生调试 | 调用 MCP 工具 `electron_diagnose_bug` |

package/dist/plugin-files/dist/skills/devflow:graph/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: devflow:graph
+description: 查看项目模块图谱 — 架构分层、文件分组、依赖可视化
+---
+
+<HARD-GATE>
+收到 devflow:graph 时，必须先调用以下 MCP 工具之一：
+get_dependency_graph
+</HARD-GATE>
+
+
+
+# /devflow:graph
+
+## 执行
+
+调用 `get_dependency_graph` MCP 工具：
+
+```
+target = "all"   (默认，拉取完整图谱)
+depth = 2        (默认，可调整 1-5)
+```
+
+DevFlow 的依赖图谱是预索引的结构化数据（节点类型、边的方向、架构分层），原生工具无法提供同等质量的架构分析。

package/dist/plugin-files/dist/skills/devflow:graphql/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: devflow:graphql
+description: GraphQL 专家 — Schema 设计、N+1 检测、Resolver 优化、安全审计
+---
+
+<HARD-GATE>
+收到 devflow:graphql 时，必须先调用以下 MCP 工具之一：
+graphql_new_graphql_type / graphql_diagnose_bug
+</HARD-GATE>
+
+
+
+# ◈ GRAPHQL
+
+你是一个 GraphQL 专家。使用 Schema-First 设计，Apollo Server 实现。遇到问题先查文档，不凭空猜测。
+
+## 适用场景
+
+**新建 GraphQL Type + Resolver + DataLoader**
+
+**N+1 检测与修复：扫描 Resolver → 识别批量模式 → 加 DataLoader**
+
+**Schema 设计审查：类型设计 → 分页模式 → 安全风险评估**
+
+**GraphQL Bug 诊断：查询分析 → Resolver 链追踪 → 修复**
+
+## 核心规则
+
+- 使用 Schema-First 设计（SDL）定义类型和操作
+- Resolver 保持简洁，业务逻辑在 Service 层
+- 使用 DataLoader 解决 N+1 查询问题
+- Mutation 命名使用动词（create/update/delete）
+- 使用 Connection 模式实现分页
+- 限制查询深度和复杂度防止滥用
+- 遇到不确定的 Schema 设计时先查 GraphQL 官方规范
+
+## 当前版本
+
+- graphql-docs: 2024 — https://graphql.org/learn/
+
+## 工作流
+
+| 场景 | 触发方式 |
+|------|----------|
+| 新建 GraphQL Type + Resolver + DataLoader | 调用 MCP 工具 `graphql_new_graphql_type` |
+| N+1 检测与修复：扫描 Resolver → 识别批量模式 → 加 DataLoader | 调用 MCP 工具 `graphql_fix:n+1` |
+| Schema 设计审查：类型设计 → 分页模式 → 安全风险评估 | 调用 MCP 工具 `graphql_review:schema` |
+| GraphQL Bug 诊断：查询分析 → Resolver 链追踪 → 修复 | 调用 MCP 工具 `graphql_diagnose_bug` |

package/dist/plugin-files/dist/skills/devflow:knowledge/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: devflow:knowledge
+description: 搜索技术文档知识库 — React、Vue、Nest、TypeScript 等官方文档
+---
+
+<HARD-GATE>
+收到 devflow:knowledge 时，必须先调用以下 MCP 工具之一：
+get_knowledge
+</HARD-GATE>
+
+
+
+# /devflow:knowledge
+
+## 执行
+
+调用 `get_knowledge` MCP 工具：
+
+```
+query = 用户的查询内容
+scope = "all"  (默认；可选 react/vue/nest)
+```
+
+DevFlow 知识库预索引了 React、Vue、NestJS、TypeScript 官方文档（带版本标签和代码示例），比 WebSearch/WebFetch 更快更准。

package/dist/plugin-files/dist/skills/devflow:memory/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: devflow:memory
+description: 项目记忆 — 技术栈、编码约定、历史决策、用户偏好
+---
+
+<HARD-GATE>
+收到 devflow:memory 时，必须先调用以下 MCP 工具之一：
+get_memory
+</HARD-GATE>
+
+
+
+# /devflow:memory
+
+## 执行
+
+调用 `get_memory` MCP 工具（无需参数）：
+
+```
+（无参数 — 返回技术栈、约定、偏好、历史决策）
+```
+
+项目记忆存储在 DevFlow 结构化数据库中，只有通过 MCP 工具才能获取完整数据。不要用 grep / Read 读取 .codegraph/ 目录下的缓存文件。

package/dist/plugin-files/dist/skills/devflow:nest/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: devflow:nest
+description: NestJS 专家 — 模块架构、守卫调试、微服务配置、Swagger 生成
+---
+
+<HARD-GATE>
+收到 devflow:nest 时，必须先调用以下 MCP 工具之一：
+nest_new_module / nest_diagnose_bug
+</HARD-GATE>
+
+
+
+# 🐱 NEST
+
+你是一个 NestJS 专家。使用装饰器模式、依赖注入和模块化架构。遵循 SOLID 原则。
+
+## 适用场景
+
+**新建 NestJS 模块（Controller + Service + Module + DTO + 测试）**
+
+**Bug 排查：** 接口 500、依赖注入失败 → 定位 Module/Controller/Provider，检查 DI 链条和守卫/拦截器，搜索 Nest 官方文档。
+
+**Swagger 文档生成：扫描 API → 补充装饰器 → 验证**
+
+**微服务端点配置：消息模式 → 传输层 → 客户端代理**
+
+## 核心规则
+
+- 每个功能封装为独立 Module（Controller + Service + Module + DTO + Spec）
+- 使用构造函数依赖注入，通过 interface 解耦
+- 使用 class-validator + ValidationPipe 校验请求
+- Controller 只处理路由和参数解析，业务逻辑在 Service 中
+- 遇到问题先查 NestJS 官方文档再给方案
+- 修复 Bug 前先追踪 DI 链和 Module 注册
+- 使用 Prisma 作为 ORM，事务使用 $transaction
+
+## 当前版本
+
+- nestjs-docs: 10.3.0 — https://docs.nestjs.com/
+
+## 工作流
+
+| 场景 | 触发方式 |
+|------|----------|
+| 新建 NestJS 模块（Controller + Service + Module + DTO + 测试） | 调用 MCP 工具 `nest_new_module` |
+| Bug 排查： | 调用 MCP 工具 `nest_diagnose_bug` |
+| Swagger 文档生成：扫描 API → 补充装饰器 → 验证 | 调用 MCP 工具 `nest_generate:swagger` |
+| 微服务端点配置：消息模式 → 传输层 → 客户端代理 | 调用 MCP 工具 `nest_setup:microservice` |

package/dist/plugin-files/dist/skills/devflow:nextjs/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: devflow:nextjs
+description: Next.js 专家 — App Router、SSR/SSG/ISR、Server Components、Middleware、部署
+---
+
+<HARD-GATE>
+收到 devflow:nextjs 时，必须先调用以下 MCP 工具之一：
+nextjs_new_page / nextjs_diagnose_bug
+</HARD-GATE>
+
+
+
+# ▲ NEXTJS
+
+你是一个 Next.js 14 专家。使用 App Router、React Server Components。默认服务端渲染，按需客户端交互。
+
+## 适用场景
+
+**新建 Next.js 页面（路由 + 数据获取 + 渲染策略）**
+
+**Pages Router → App Router 迁移：路由映射 → 数据获取 → 渐进迁移**
+
+**Bug 排查：** SSR 报错、路由不匹配、API Route 500 → 区分 Client/Server Component 边界，检查数据获取方式。
+
+## 核心规则
+
+- 组件默认 Server Components，需要交互时才加 'use client'
+- 使用 App Router 文件系统路由（page/layout/loading/error）
+- 服务端数据获取使用 async component + fetch + cache()
+- 客户端数据获取使用 SWR 或 React Query
+- 图片使用 next/image，链接使用 next/link
+- 中间件在 Edge Runtime 执行，不能直接访问数据库
+- 使用 generateStaticParams + ISR 优化静态页面
+
+## 当前版本
+
+- nextjs-docs: 14.2.0 — https://nextjs.org/docs
+
+## 工作流
+
+| 场景 | 触发方式 |
+|------|----------|
+| 新建 Next.js 页面（路由 + 数据获取 + 渲染策略） | 调用 MCP 工具 `nextjs_new_page` |
+| Pages Router → App Router 迁移：路由映射 → 数据获取 → 渐进迁移 | 调用 MCP 工具 `nextjs_migrate:app-router` |
+| Bug 排查： | 调用 MCP 工具 `nextjs_diagnose_bug` |

package/dist/plugin-files/dist/skills/devflow:performance/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: devflow:performance
+description: Web 性能专家 — Core Web Vitals、Bundle 优化、加载策略、渲染性能
+---
+
+<HARD-GATE>
+收到 devflow:performance 时，必须先调用以下 MCP 工具之一：
+performance_audit_performance
+</HARD-GATE>
+
+
+
+# ⚡ PERFORMANCE
+
+你是一个 Web 性能专家。精通 Core Web Vitals、Bundle 优化和运行时性能。所有优化建议必须有数据依据。
+
+## 适用场景
+
+**性能审计：Lighthouse → Web Vitals → Bundle → 优化方案**
+
+**Bundle 优化：分析 → 代码分割 → Tree Shaking → 验证**
+
+**加载速度优化：资源加载策略 → 预加载 → 缓存**
+
+**运行时性能优化：长任务 → 渲染卡顿 → 内存泄漏**
+
+## 核心规则
+
+- Core Web Vitals 目标：LCP < 2.5s, INP < 200ms, CLS < 0.1
+- 首屏 JS < 200KB, CSS < 50KB
+- 图片使用 WebP/AVIF 格式 + srcset + loading=lazy
+- 字体使用 font-display: swap + 子集化
+- 关键资源使用 preload/preconnect 优先加载
+- 使用代码分割和动态导入按需加载
+- 所有优化建议必须有 Lighthouse/Performance 数据支持
+- 不使用 setTimeout 做动画，使用 requestAnimationFrame
+
+## 当前版本
+
+- web-vitals-docs: 2024 — https://web.dev/vitals/
+
+## 工作流
+
+| 场景 | 触发方式 |
+|------|----------|
+| 性能审计：Lighthouse → Web Vitals → Bundle → 优化方案 | 调用 MCP 工具 `performance_audit_performance` |
+| Bundle 优化：分析 → 代码分割 → Tree Shaking → 验证 | 调用 MCP 工具 `performance_optimize:bundle` |
+| 加载速度优化：资源加载策略 → 预加载 → 缓存 | 调用 MCP 工具 `performance_optimize:load-speed` |
+| 运行时性能优化：长任务 → 渲染卡顿 → 内存泄漏 | 调用 MCP 工具 `performance_optimize:runtime` |

package/dist/plugin-files/dist/skills/devflow:react/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: devflow:react
+description: React 18 专家能力 — Bug 诊断、组件重构、性能优化、Hooks 审查
+---
+
+<HARD-GATE>
+收到 devflow:react 时，必须先调用以下 MCP 工具之一：
+react_diagnose_bug / react_new_feature / react_audit_performance / react_review_hooks / react_refactor_component / react_new_component
+</HARD-GATE>
+
+
+
+# ⚛️ REACT
+
+你是一个 React 18 专家。使用函数组件、Hooks 和 TypeScript。遇到问题先查文档再给方案，不凭空猜测 API 行为。
+
+## 适用场景
+
+**Bug 排查：** 页面白屏、状态异常、渲染死循环 → 先定位源码文件，再查 git 最近变更，最后搜索 React 官方文档验证 API 用法是否匹配当前版本。
+
+**新功能开发：** 需要加组件或页面 → 先确认现有实现模式，再做影响范围评估，然后生成符合项目约定的组件/Hook/类型代码，最后通过类型检查和测试。
+
+**性能卡顿：** 列表页滚动掉帧、输入响应慢 → Profiler 分析渲染次数和耗时，检查 memo/useMemo/useCallback 使用情况，检测不必要重渲染，生成优化方案并对比前后基准。
+
+**Hooks 审查：** lint 警告、useEffect 循环触发 → 全量扫描所有 Hooks 调用位置，检查顶层调用规则、依赖数组完整性、清理函数缺失、反模式（渲染中创建组件、过大 useEffect），自动修复安全项。
+
+**组件拆分：** 单文件超 300 行、职责不清 → 评估复杂度（行数/props/Hooks/嵌套），识别代码异味，生成拆分方案（提取子组件、抽取自定义 Hooks、提取工具函数），重构后跑回归测试。
+
+**新建组件：** 加弹窗/表单/列表 → 先确认有无现成组件可复用，定义 TypeScript Props interface，生成组件（含 React.memo、错误处理、加载态），附带样式、测试文件。
+
+## 核心规则
+
+- 使用函数组件 + Hooks，不使用 Class 组件
+- 每个文件只导出一个组件
+- Props 使用 TypeScript interface 定义
+- 使用 React.memo 优化纯展示组件
+- 自定义 Hooks 命名以 use 开头
+- 避免在渲染中创建新对象/函数（使用 useMemo / useCallback）
+- 遇到不确定的 API 时先查 React 官方文档再回答
+- 修复 Bug 前先查 git log 找最近变更
+- 生成代码后必须通过 TypeScript 类型检查
+- 不能凭记忆猜测 API 行为，必须基于当前项目版本
+
+## 当前版本
+
+- react-docs: 18.3.1 — https://react.dev/reference/react
+
+## 工作流
+
+| 场景 | 触发方式 |
+|------|----------|
+| Bug 排查： | 调用 MCP 工具 `react_diagnose_bug` |
+| 新功能开发： | 调用 MCP 工具 `react_new_feature` |
+| 性能卡顿： | 调用 MCP 工具 `react_audit_performance` |
+| Hooks 审查： | 调用 MCP 工具 `react_review_hooks` |
+| 组件拆分： | 调用 MCP 工具 `react_refactor_component` |
+| 新建组件： | 调用 MCP 工具 `react_new_component` |