@devflow-tools/devflow 0.18.14 → 0.18.17

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

@@ -10,13 +10,22 @@ description: 通过可审计 Delivery Line 将需求推进到验证完成的 int
 ## 开始案件
 
 收到新的交付需求时，调用 `mcp__devflow__delivery_create_case`。使用当前项目绝对路径；默认 `baseRef=HEAD`、`targetRef=main`，除非用户明确指定其他值。为 actor、session、execution 和每次写操作生成稳定且可追踪的标识与幂等键。
+- 若上下文检索发现同名组件、同一路由或多个框架实现，将候选路径通过 `existingImplementations` 传入创建案件参数，让案件先进入阻塞澄清；不要自行选择复用或替换。
 
 ## 推进规则
 
+- 调用 `mcp__devflow__get_project_context` 后必须等待该 MCP 返回，再进行任何 Read/Grep/Glob/Bash/Write/Edit；不要并发发起上下文请求和直接工具调用。
 - 每次写操作后读取返回状态；状态不明确或发生 stale turn 时调用 `mcp__devflow__delivery_status`。
 - 只执行当前 `nextActions` 允许的操作。
+- `designing` 阶段没有 `design` 审批动作。设计方案确认后，必须使用当前状态返回的
+  `turn` 调用 `delivery_compare_options`，由它生成 `spec_ready`；随后才可调用
+  `delivery_approve(stage=spec)`。不得调用 `delivery_approve(stage=design)`，也不得用
+  `delivery_advance` 代替 `compare_options`。
+- `delivery_advance` 仅允许在 `plan_approved` 阶段使用；其他阶段返回失败时必须按
+  `nextActions` 恢复，不得把无推进当作成功。
 - 澄清与设计交互使用当前 turn；后续写操作携带案件当前 context receipt。
 - 只有用户明确同意时才能调用 `mcp__devflow__delivery_approve`；不得代替用户批准。
+- 审批返回后不要结束会话：立即读取同一次返回的 `stage` 和 `nextActions`，按其允许的下一步继续推进；只有 `nextActions` 为空或用户明确暂停时才结束。
 - `mcp__devflow__delivery_advance` 用于推进已满足的状态，`mcp__devflow__delivery_resume` 只恢复已经具备运行条件的 gate 或 task。
 - 失败任务只通过 `mcp__devflow__delivery_retry_task` 重试；取消和导出分别使用 `mcp__devflow__delivery_cancel` 与 `mcp__devflow__delivery_export`。
 - Claude 在当前工作区产生的修改不是 Delivery 输出；只能先调用 `mcp__devflow__delivery_import_external_change`，由系统校验 base/candidate、允许文件、context receipt 和验证证据后再进入 integration。
@@ -35,6 +44,7 @@ description: 通过可审计 Delivery Line 将需求推进到验证完成的 int
 - `error.retryable=false` 时不得自动重试；`error.recoveryAction` 是下一步建议，不是已完成的动作。
 - 遇到 `HELD`、`WORKER_UNAVAILABLE`、`REQUIRED_CONTEXT_MISSING` 或 producer/stale 警告时，先刷新 `delivery_status` 并保留阻塞状态；不得通过普通 Write/Edit/Bash/git commit 绕过 Delivery authority。
 - 遇到 `STALE_INTERACTION_TURN`、`MISSING_PREREQUISITE` 或 `INVALID_TRANSITION` 时，先调用 `mcp__devflow__delivery_status` 刷新案件状态；只有新的 `nextActions` 明确允许时才继续。
+- Delivery 工具失败后不得为了绕过写入限制调用 `delivery_cancel`；只有用户明确要求取消时才可取消。取消或拒绝后的同一会话仍禁止直接 Write/Edit/Bash，必须新建 Delivery 案件或开启新会话。
 - 用户拒绝审批，或遇到 `UNAUTHORIZED_ROLE`、权限失败、`PROJECT_ROOT_MISMATCH` 时不得自动重试；保留案件当前状态并请求用户处理。
 - 不通过更换 actor、project root、turn、context receipt 或幂等键来规避失败。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devflow-tools/devflow",
-  "version": "0.18.14",
+  "version": "0.18.17",
   "type": "module",
   "description": "Installable DevFlow distribution containing the CLI, runtime hooks, and Claude plugin.",
   "bin": {
@@ -19,21 +19,21 @@
   },
   "dependencies": {
     "@colbymchenry/codegraph": "^1.1.1",
-    "@devflow-tools/adapters": "0.18.14",
-    "@devflow-tools/benchmark": "0.18.14",
-    "@devflow-tools/context-engine": "0.18.14",
-    "@devflow-tools/database": "0.18.14",
-    "@devflow-tools/delivery-line": "0.18.14",
-    "@devflow-tools/knowledge-engine": "0.18.14",
-    "@devflow-tools/mcp-server": "0.18.14",
-    "@devflow-tools/memory-engine": "0.18.14",
-    "@devflow-tools/retrieval-engine": "0.18.14",
-    "@devflow-tools/sdk": "0.18.14",
-    "@devflow-tools/semantic-engine": "0.18.14",
-    "@devflow-tools/server": "0.18.14",
-    "@devflow-tools/task-runtime": "0.18.14",
-    "@devflow-tools/telemetry": "0.18.14",
-    "@devflow-tools/workflow-engine": "0.18.14",
+    "@devflow-tools/adapters": "0.18.17",
+    "@devflow-tools/benchmark": "0.18.17",
+    "@devflow-tools/context-engine": "0.18.17",
+    "@devflow-tools/database": "0.18.17",
+    "@devflow-tools/delivery-line": "0.18.17",
+    "@devflow-tools/knowledge-engine": "0.18.17",
+    "@devflow-tools/mcp-server": "0.18.17",
+    "@devflow-tools/memory-engine": "0.18.17",
+    "@devflow-tools/retrieval-engine": "0.18.17",
+    "@devflow-tools/sdk": "0.18.17",
+    "@devflow-tools/semantic-engine": "0.18.17",
+    "@devflow-tools/server": "0.18.17",
+    "@devflow-tools/task-runtime": "0.18.17",
+    "@devflow-tools/telemetry": "0.18.17",
+    "@devflow-tools/workflow-engine": "0.18.17",
     "@inquirer/prompts": "^7.10.1",
     "@modelcontextprotocol/sdk": "^1.30.0",
     "@nestjs/common": "^11.1.28",

package/plugin-registry.json

@@ -1,172 +1,172 @@
 {
   "version": "1.0.0",
-  "lastUpdated": "2026-09-08T06:17:52.020Z",
+  "lastUpdated": "2026-09-09T02:04:39.860Z",
   "plugins": [
     {
       "name": "@devflow-tools/plugin-animation",
-      "version": "0.18.14",
+      "version": "0.18.17",
       "description": "Animation analysis and generation tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "animation"
       ],
-      "size": "78359 B",
+      "size": "78887 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-css",
-      "version": "0.18.14",
+      "version": "0.18.17",
       "description": "CSS analysis and selector audit tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "css"
       ],
-      "size": "65564 B",
+      "size": "66074 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-docker",
-      "version": "0.18.14",
+      "version": "0.18.17",
       "description": "Docker configuration and diagnostic tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "docker"
       ],
-      "size": "94277 B",
+      "size": "94796 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-electron",
-      "version": "0.18.14",
+      "version": "0.18.17",
       "description": "Electron application analysis and implementation tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "electron"
       ],
-      "size": "110073 B",
+      "size": "110598 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-git",
-      "version": "0.18.14",
+      "version": "0.18.17",
       "description": "Git repository analysis and workflow tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "git"
       ],
-      "size": "75885 B",
+      "size": "76395 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-graphql",
-      "version": "0.18.14",
+      "version": "0.18.17",
       "description": "GraphQL schema and operation tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "graphql"
       ],
-      "size": "78016 B",
+      "size": "78538 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-nest",
-      "version": "0.18.14",
+      "version": "0.18.17",
       "description": "NestJS analysis and implementation tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "nest"
       ],
-      "size": "114722 B",
+      "size": "115235 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-nextjs",
-      "version": "0.18.14",
+      "version": "0.18.17",
       "description": "Next.js analysis and implementation tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "nextjs"
       ],
-      "size": "76376 B",
+      "size": "76895 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-performance",
-      "version": "0.18.14",
+      "version": "0.18.17",
       "description": "Web performance audit and optimization tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "performance"
       ],
-      "size": "126707 B",
+      "size": "127241 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-react",
-      "version": "0.18.14",
+      "version": "0.18.17",
       "description": "React analysis, audit, and component tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "react"
       ],
-      "size": "265547 B",
+      "size": "266063 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-tailwind",
-      "version": "0.18.14",
+      "version": "0.18.17",
       "description": "Tailwind CSS analysis and component tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "tailwind"
       ],
-      "size": "82761 B",
+      "size": "83286 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-taro",
-      "version": "0.18.14",
+      "version": "0.18.17",
       "description": "Taro application analysis and implementation tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "taro"
       ],
-      "size": "86407 B",
+      "size": "86920 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-ui-layout",
-      "version": "0.18.14",
+      "version": "0.18.17",
       "description": "UI layout analysis and implementation tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "ui-layout"
       ],
-      "size": "63737 B",
+      "size": "64265 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     },
     {
       "name": "@devflow-tools/plugin-vue",
-      "version": "0.18.14",
+      "version": "0.18.17",
       "description": "Vue analysis, audit, and component tools for DevFlow.",
       "tags": [],
       "compatibleStacks": [
         "vue"
       ],
-      "size": "94536 B",
+      "size": "95046 B",
       "author": "DevFlow Team",
       "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
     }