@devflow-tools/devflow 0.16.5 → 0.16.6

package/dist/plugin/skills/react/SKILL.md

@@ -13,7 +13,7 @@ description: React 18 专家能力 — Bug 诊断、组件重构、性能优化
 
 **新功能开发：** 需要加组件或页面 → 先确认现有实现模式，再做影响范围评估，然后生成符合项目约定的组件/Hook/类型代码，最后通过类型检查和测试。
 
-**性能卡顿：** 列表页滚动掉帧、输入响应慢 → 先用静态工具生成候选，再用 Profiler、浏览器 Performance trace 或可复现 benchmark 测量渲染次数、耗时和 CPU；只有测量后才能确认影响和排序优化。
+**性能卡顿：** 列表页滚动掉帧、输入响应慢 → Profiler 分析渲染次数和耗时，检查 memo/useMemo/useCallback 使用情况，检测不必要重渲染，生成优化方案并对比前后基准。
 
 **Hooks 审查：** lint 警告、useEffect 循环触发 → 全量扫描所有 Hooks 调用位置，检查顶层调用规则、依赖数组完整性、清理函数缺失、反模式（渲染中创建组件、过大 useEffect），自动修复安全项。
 
@@ -26,10 +26,12 @@ description: React 18 专家能力 — Bug 诊断、组件重构、性能优化
 - 使用函数组件 + Hooks，不使用 Class 组件
 - 每个文件只导出一个组件
 - Props 使用 TypeScript interface 定义
-- 仅在父组件重复渲染、props 稳定且组件渲染成本可观时评估 React.memo；React.memo 不会阻止组件自身 state 或所消费 Context 变化引发的更新
+- 仅在父组件重复渲染、props 稳定且渲染成本可观时评估 React.memo；它不会阻止组件自身 state 或 Context 更新
 - 自定义 Hooks 命名以 use 开头
-- 内联 DOM style 默认是低影响静态发现；只有测量证明位于热点路径时才升级影响等级
-- requestAnimationFrame 只对齐浏览器绘制时机；没有明确采样频率、合并和丢弃策略时，不得把它描述为通用节流
+- 用运行时测量决定性能优化；内联 DOM style 默认低影响，requestAnimationFrame 没有采样策略时不是通用节流
+- runtimeProfilingOccurred=false 时所有性能发现只能称为静态候选，不得标记 P0、声称卡顿/掉帧/CPU 热点或给出具体收益比例
+- 性能报告必须分为工具发现、模型假设、需要运行时验证；工具返回 0 条发现不得表述为静态分析通过
+- scannedFiles=0 表示目标定位失败，必须修正 filePath/componentName 后重试，不能基于空结果继续推断
 - 遇到不确定的 API 时先查 React 官方文档再回答
 - 修复 Bug 前先查 git log 找最近变更
 - 生成代码后必须通过 TypeScript 类型检查
@@ -49,15 +51,3 @@ description: React 18 专家能力 — Bug 诊断、组件重构、性能优化
 | Hooks 审查： | 调用 MCP 工具 `react_review_hooks` |
 | 组件拆分： | 调用 MCP 工具 `react_refactor_component` |
 | 新建组件： | 调用 MCP 工具 `react_new_component` |
-
-## 性能证据契约
-
-`react_audit_performance` 返回静态候选，并通过 `runtimeProfilingOccurred` 明确说明是否执行过运行时 profiling。每条发现必须保留 `evidenceMode`、`detectionMethod`、`confidence`、`impact` 和 `limitations`，不得省略限制条件。
-
-最终答复必须按以下三个标题分开陈述：
-
-1. **工具发现**：只复述工具实际返回的证据、位置和限制，不扩写为已测事实。
-2. **模型假设**：明确标注基于代码上下文的推断，不与工具发现混写。
-3. **需要运行时验证**：列出复现场景、Profiler/trace/benchmark 方法和待采集指标。
-
-没有运行时测量时，不得把任何静态发现标为 P0，不得声称已观察到 jank/卡顿或 CPU 影响，也不得称其为性能瓶颈。只有包含场景、指标、数值和单位的 Profiler、Performance trace 或 benchmark 结果，才能支持这些结论。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devflow-tools/devflow",
-  "version": "0.16.5",
+  "version": "0.16.6",
   "type": "module",
   "description": "DevFlow - Developer Intelligence Platform (Distribution Package)",
   "bin": {
@@ -16,17 +16,17 @@
   },
   "dependencies": {
     "@colbymchenry/codegraph": "^1.1.1",
-    "@devflow-tools/adapters": "0.16.5",
-    "@devflow-tools/benchmark": "0.16.5",
-    "@devflow-tools/context-engine": "0.16.5",
-    "@devflow-tools/database": "0.16.5",
-    "@devflow-tools/knowledge-engine": "0.16.5",
-    "@devflow-tools/mcp-server": "0.16.5",
-    "@devflow-tools/memory-engine": "0.16.5",
-    "@devflow-tools/sdk": "0.16.5",
-    "@devflow-tools/server": "0.16.5",
-    "@devflow-tools/telemetry": "0.16.5",
-    "@devflow-tools/workflow-engine": "0.16.5",
+    "@devflow-tools/adapters": "0.16.6",
+    "@devflow-tools/benchmark": "0.16.6",
+    "@devflow-tools/context-engine": "0.16.6",
+    "@devflow-tools/database": "0.16.6",
+    "@devflow-tools/knowledge-engine": "0.16.6",
+    "@devflow-tools/mcp-server": "0.16.6",
+    "@devflow-tools/memory-engine": "0.16.6",
+    "@devflow-tools/sdk": "0.16.6",
+    "@devflow-tools/server": "0.16.6",
+    "@devflow-tools/telemetry": "0.16.6",
+    "@devflow-tools/workflow-engine": "0.16.6",
     "@inquirer/prompts": "^7.10.1",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "@nestjs/common": "^10.4.0",
@@ -54,5 +54,5 @@
     "plugin-registry.json",
     "scripts/postinstall.js"
   ],
-  "gitHead": "7adad5462e435a6ee4fba92c350e85930db0ee80"
+  "gitHead": "b5628c42b4f6795103838c11e65601f6a59cb559"
 }

package/plugin-registry.json

@@ -1,172 +1,172 @@
 {
   "version": "1.0.0",
-  "lastUpdated": "2026-07-23T01:32:18.902Z",
+  "lastUpdated": "2026-07-23T03:27:11.960Z",
   "plugins": [
     {
       "name": "@devflow-tools/plugin-animation",
-      "version": "0.16.5",
+      "version": "0.16.6",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "animation"
       ],
-      "size": "121096 B",
+      "size": "121269 B",
       "author": "DevFlow Team",
       "homepage": ""
     },
     {
       "name": "@devflow-tools/plugin-css",
-      "version": "0.16.5",
+      "version": "0.16.6",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "css"
       ],
-      "size": "108593 B",
+      "size": "108760 B",
       "author": "DevFlow Team",
       "homepage": ""
     },
     {
       "name": "@devflow-tools/plugin-docker",
-      "version": "0.16.5",
+      "version": "0.16.6",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "docker"
       ],
-      "size": "137402 B",
+      "size": "137572 B",
       "author": "DevFlow Team",
       "homepage": ""
     },
     {
       "name": "@devflow-tools/plugin-electron",
-      "version": "0.16.5",
+      "version": "0.16.6",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "electron"
       ],
-      "size": "153079 B",
+      "size": "153251 B",
       "author": "DevFlow Team",
       "homepage": ""
     },
     {
       "name": "@devflow-tools/plugin-git",
-      "version": "0.16.5",
+      "version": "0.16.6",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "git"
       ],
-      "size": "118941 B",
+      "size": "119108 B",
       "author": "DevFlow Team",
       "homepage": ""
     },
     {
       "name": "@devflow-tools/plugin-graphql",
-      "version": "0.16.5",
+      "version": "0.16.6",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "graphql"
       ],
-      "size": "121086 B",
+      "size": "121257 B",
       "author": "DevFlow Team",
       "homepage": ""
     },
     {
       "name": "@devflow-tools/plugin-nest",
-      "version": "0.16.5",
+      "version": "0.16.6",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "nest"
       ],
-      "size": "158182 B",
+      "size": "158350 B",
       "author": "DevFlow Team",
       "homepage": ""
     },
     {
       "name": "@devflow-tools/plugin-nextjs",
-      "version": "0.16.5",
+      "version": "0.16.6",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "nextjs"
       ],
-      "size": "119735 B",
+      "size": "119905 B",
       "author": "DevFlow Team",
       "homepage": ""
     },
     {
       "name": "@devflow-tools/plugin-performance",
-      "version": "0.16.5",
+      "version": "0.16.6",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "performance"
       ],
-      "size": "169576 B",
+      "size": "169751 B",
       "author": "DevFlow Team",
       "homepage": ""
     },
     {
       "name": "@devflow-tools/plugin-react",
-      "version": "0.16.5",
+      "version": "0.16.6",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "react"
       ],
-      "size": "265646 B",
+      "size": "281286 B",
       "author": "DevFlow Team",
       "homepage": ""
     },
     {
       "name": "@devflow-tools/plugin-tailwind",
-      "version": "0.16.5",
+      "version": "0.16.6",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "tailwind"
       ],
-      "size": "125746 B",
+      "size": "125918 B",
       "author": "DevFlow Team",
       "homepage": ""
     },
     {
       "name": "@devflow-tools/plugin-taro",
-      "version": "0.16.5",
+      "version": "0.16.6",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "taro"
       ],
-      "size": "129369 B",
+      "size": "129537 B",
       "author": "DevFlow Team",
       "homepage": ""
     },
     {
       "name": "@devflow-tools/plugin-ui-layout",
-      "version": "0.16.5",
+      "version": "0.16.6",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "ui-layout"
       ],
-      "size": "106465 B",
+      "size": "106638 B",
       "author": "DevFlow Team",
       "homepage": ""
     },
     {
       "name": "@devflow-tools/plugin-vue",
-      "version": "0.16.5",
+      "version": "0.16.6",
       "description": "",
       "tags": [],
       "compatibleStacks": [
         "vue"
       ],
-      "size": "138017 B",
+      "size": "138184 B",
       "author": "DevFlow Team",
       "homepage": ""
     }