minimal-agent 0.8.0 → 0.8.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minimal-agent",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "最小化 Agent 系统 —— 10 工具 + 插件系统 + workflow DSL + 自动压缩 + OpenAI 兼容 + Ink TUI；NodeNext + tsc 原地编译，dev 用 Bun .ts、install 用 Node .js（学习/教学用）",
   "license": "SEE LICENSE IN LICENSE",
   "author": "Bill Wang <leiwang0359@gmail.com>",

package/plugins/ralph-wiggum/plugin.js

@@ -22,8 +22,8 @@
 import { fileURLToPath } from 'node:url';
 import { dirname } from 'node:path';
 import { runQuery, getWorkingDir, } from '../../src/plugin-sdk.js';
+import { parseVerifyArgs, runVerification } from '../../src/infra/verification.js';
 import { GoalState, Phase } from './src/goalState.js';
-import { parseVerifyArgs, runVerification } from './src/verificationGate.js';
 import { makeCompletionMatcher, hasNeedReplanSentinel, hasNeedGoalRevisionSentinel, extractLearnings, } from './src/sentinels.js';
 import { executeStopHook } from './src/stopHookRunner.js';
 const PLUGIN_NAME = 'ralph-wiggum';

package/plugins/workflow-runner/plugin.js

@@ -12,6 +12,7 @@
  *  缓存这次 import，所以 cold start 后 dynamic import 只跑一次。
  * ============================================================
  */
+import { ALL_TOOLS, getWorkingDir } from '../../src/plugin-sdk.js';
 import { runWorkflowFromCommand, runWorkflowsList } from './src/index.js';
 const api = {
     async *runCommand(commandName, args, ctx) {
@@ -24,6 +25,8 @@ const api = {
                 provider: ctx.provider,
                 history: ctx.history,
                 signal: ctx.signal,
+                cwd: getWorkingDir(),
+                tools: ALL_TOOLS,
             });
             return;
         }

package/plugins/workflow-runner/src/loader.js

@@ -130,6 +130,7 @@ function validate(obj, file) {
 // editor 因 D2 红线禁止 import 后端、手抄了同一份；后端在此演进时该测试会红，提示同步 editor。
 export const CONTROL_FLOW_TYPES = new Set([
     'assert',
+    'verify',
     'branch',
     'loop',
     'pause',
@@ -138,6 +139,7 @@ export const CONTROL_FLOW_TYPES = new Set([
 ]);
 export const VALID_STEP_TYPES = new Set([
     'assert',
+    'verify',
     'branch',
     'loop',
     'pause',
@@ -207,6 +209,16 @@ function validateSteps(steps, file, pathPrefix) {
         if (s.type === 'assert' && s.condition === undefined) {
             throw new WorkflowLoadError(`${p} type=assert 必须带 'condition'`, file);
         }
+        if (s.type === 'verify') {
+            if (!Array.isArray(s.checks) || s.checks.length === 0) {
+                throw new WorkflowLoadError(`${p} type=verify 必须带非空 'checks' 数组`, file);
+            }
+            for (const [ci, c] of s.checks.entries()) {
+                if (typeof c !== 'string' || !c.includes(':')) {
+                    throw new WorkflowLoadError(`${p}.checks[${ci}] 格式错误，应为 "type:value"（如 "file_exists:./x"）`, file);
+                }
+            }
+        }
         if (s.type === 'branch') {
             if (s.then !== undefined && !Array.isArray(s.then)) {
                 throw new WorkflowLoadError(`${p}.then 必须是数组`, file);

package/plugins/workflow-runner/src/runner.js

@@ -27,6 +27,7 @@ import { evalExpr, interpolate } from './expressions.js';
 import { runRecovery } from './recovery.js';
 import { execAgentStep } from './stepExecutors/agent.js';
 import { execAssertStep } from './stepExecutors/assert.js';
+import { execVerifyStep } from './stepExecutors/verify.js';
 import { execLlmStep } from './stepExecutors/llm.js';
 import { execSkillStep } from './stepExecutors/skill.js';
 import { execToolStep } from './stepExecutors/tool.js';
@@ -78,6 +79,8 @@ function bindCapture(captureMap, result, vars) {
 async function* dispatchActionStep(step, vars, ctx) {
     if (step.type === 'assert')
         return execAssertStep(step, vars);
+    if (step.type === 'verify')
+        return await execVerifyStep(step, vars);
     if (step.tool)
         return yield* execToolStep(step, vars, ctx);
     if (step.agent)
@@ -86,7 +89,7 @@ async function* dispatchActionStep(step, vars, ctx) {
         return yield* execLlmStep(step, vars, ctx);
     if (step.skill)
         return yield* execSkillStep(step, vars, ctx);
-    throw new Error(`step ${step.id}: 无可执行字段（tool/agent/llm/skill/assert）`);
+    throw new Error(`step ${step.id}: 无可执行字段（tool/agent/llm/skill/assert/verify）`);
 }
 /**
  * 递归执行 steps[]。返回 true 表示该 block 已 halt（上游应中止）。
@@ -527,14 +530,41 @@ export async function* runWorkflow(def, inputs, ctx) {
         };
         yield { type: 'workflow_done', name: def.name, vars: vars.snapshot() };
         succeeded = true;
+        // ---- 层1：写入摘要到对话历史（让后续对话记住这次 workflow 做了什么）----
+        const snapshot = vars.snapshot();
+        const summaryText = typeof snapshot.summary_text === 'string'
+            ? snapshot.summary_text
+            : '';
+        // 收集关键产出物（从 vars 中提取文件路径）
+        const artifacts = [];
+        if (typeof snapshot.plan_text === 'string')
+            artifacts.push('./PLAN.md');
+        // 检查是否有执行结果（execute_plan 步的产出）
+        if (typeof snapshot.execution_result === 'string') {
+            // 尝试从执行结果中提取文件路径（常见模式：产出物路径）
+            const fileMatches = snapshot.execution_result.match(/`[^`]*\.(pptx|docx|pdf|xlsx|md|ts|js|py)[^`]*`/g);
+            if (fileMatches)
+                artifacts.push(...fileMatches.map((f) => f.replace(/`/g, '')));
+        }
+        const summaryLines = [
+            `**工作流「${def.name}」执行完成**`,
+            ``,
+            `- 步骤: ${def.steps.length}/${def.steps.length} 全部完成`,
+            ...(artifacts.length > 0 ? [`- 产出物: ${artifacts.join(', ')}`] : []),
+            ...(summaryText ? [`- 摘要: ${summaryText}`] : []),
+        ];
+        yield {
+            type: 'assistant_message',
+            message: {
+                role: 'assistant',
+                content: summaryLines.join('\n'),
+            },
+        };
     }
     finally {
-        // 只在「干净跑完」时清现场；halt / 中断 / 抛错都**保留** .minimal-agent-workflow/
-        // （current.json / inputs.json / vars.json / progress.md，含失败那步的 ✗ 行）供事后排查
-        // ——这正是这些文件的设计目的（workflowState.ts 头注）；失败时删掉等于自废武功。
-        // 残留不会永久堆积：下次同名 workflow 的 init() 会先 rm，/new 也按 .minimal-agent-* 前缀统一清。
+        // 成功时归档（保留 vars.json/progress.md 供后续回溯）；失败/中断时保留原状供排查
         if (succeeded)
-            await state.cleanup();
+            await state.archive();
     }
 }
 /**

package/plugins/workflow-runner/src/stepExecutors/agent.js

@@ -11,6 +11,7 @@
  *    - agent 的产出经过验证闸门（interpretMiniReActResult），llm 直接透传
  * ============================================================
  */
+import { interpolate } from '../expressions.js';
 import { runMiniReAct } from '../miniReAct.js';
 import { AGENT_OPENING, buildWorkflowAgentSystem, describeCaptureContract, interpretMiniReActResult, } from '../agentCommon.js';
 /**
@@ -25,13 +26,17 @@ import { AGENT_OPENING, buildWorkflowAgentSystem, describeCaptureContract, inter
  *   这解决了之前 workflow 模式下模型不知道有 pptx/pdf 等 skill 的问题。
  */
 export async function* execAgentStep(step, vars, ctx) {
-    const tools = (ctx.tools ?? []).filter((t) => step.allowed_tools?.includes(t.name));
+    // 工具白名单：allowed_tools 声明时按白名单过滤；未声明时默认全量（不限制）
+    const allTools = ctx.tools ?? [];
+    const tools = step.allowed_tools
+        ? allTools.filter((t) => step.allowed_tools.includes(t.name))
+        : allTools;
     // ✅ Phase 2: 异步构建完整 system prompt（含 skill/plugin 列表）
     const systemContent = await buildWorkflowAgentSystem(ctx.cwd, // 新增：传入 cwd 用于 skill/plugin 扫描
     AGENT_OPENING, tools);
-    const userMsg = step.prompt +
+    const userMsg = interpolate(step.agent ?? '', vars) +
         describeCaptureContract(step) +
-        (step.input ? `\n\n上下文变量：${step.input}` : '');
+        (step.input ? `\n\n上下文变量：${interpolate(step.input, vars)}` : '');
     const messages = [
         { role: 'system', content: systemContent },
         { role: 'user', content: userMsg },

package/plugins/workflow-runner/src/stepExecutors/verify.js

@@ -0,0 +1,41 @@
+/**
+ * ============================================================
+ *  stepExecutors/verify.ts —— verify step 执行
+ * ------------------------------------------------------------
+ *  复用 src/infra/verification.ts 共享验证基础设施，
+ *  支持 shell / file_exists / file_contains / test_count 四种检查。
+ *
+ *  与 assert 的区别：
+ *    - assert: evalExpr 表达式（轻量，适合简单文件存在判断）
+ *    - verify: 完整检查器（重量，支持命令执行/正则匹配/测试计数）
+ * ============================================================
+ */
+import { parseCheckString, runVerification } from '../../../../src/infra/verification.js';
+import { interpolate } from '../expressions.js';
+export async function execVerifyStep(step, vars) {
+    if (!Array.isArray(step.checks) || step.checks.length === 0) {
+        throw new Error(`step ${step.id}: verify 缺少 checks 数组`);
+    }
+    // 解析并插值每条 check 字符串
+    const checks = [];
+    for (const raw of step.checks) {
+        const interpolated = interpolate(raw, vars);
+        const check = parseCheckString(interpolated);
+        if (!check) {
+            throw new Error(`step ${step.id}: 无法解析 check "${interpolated}"，格式应为 "type:value"`);
+        }
+        checks.push(check);
+    }
+    // 执行所有检查
+    const result = await runVerification(checks);
+    if (!result.passed) {
+        const msg = step.onFail
+            ? interpolate(step.onFail, vars)
+            : `verify 失败: ${result.summary}`;
+        throw new Error(msg);
+    }
+    return {
+        raw: { passed: true, summary: result.summary, details: result.details },
+        preview: result.summary,
+    };
+}

package/plugins/workflow-runner/src/workflowState.js

@@ -18,16 +18,19 @@
  *  因为执行流程是确定性的，没有 LLM 自规划过程。
  * ============================================================
  */
-import { mkdir, writeFile, appendFile, rm } from 'node:fs/promises';
+import { mkdir, writeFile, appendFile, rm, rename } from 'node:fs/promises';
 import { join } from 'node:path';
 const STATE_DIR = '.minimal-agent-workflow';
+const DONE_SUFFIX = '.done';
 export class WorkflowState {
     dir;
     constructor(workingDir) {
         this.dir = join(workingDir, STATE_DIR);
     }
     async init(name, inputs) {
-        await rm(this.dir, { recursive: true, force: true });
+        // 启动新 workflow 时清理旧状态（含之前的归档）
+        await rm(this.dir, { recursive: true, force: true }).catch(() => { });
+        await rm(this.dir + DONE_SUFFIX, { recursive: true, force: true }).catch(() => { });
         await mkdir(this.dir, { recursive: true });
         await writeFile(join(this.dir, 'current.json'), JSON.stringify({ name, startedAt: new Date().toISOString() }, null, 2), 'utf8');
         await writeFile(join(this.dir, 'inputs.json'), JSON.stringify(inputs, null, 2), 'utf8');
@@ -40,7 +43,32 @@ export class WorkflowState {
     async writeVars(snapshot) {
         await writeFile(join(this.dir, 'vars.json'), JSON.stringify(snapshot, null, 2), 'utf8').catch(() => { });
     }
+    /**
+     * 归档（成功完成时调用）：重命名状态目录为 .done 后缀，保留所有中间产物。
+     * vars.json / progress.md / inputs.json 全部保留——供后续对话 Read 回溯。
+     */
+    async archive() {
+        const doneDir = this.dir + DONE_SUFFIX;
+        try {
+            // 先清理旧的归档（如果存在）
+            await rm(doneDir, { recursive: true, force: true });
+        }
+        catch {
+            // ignore
+        }
+        try {
+            await rename(this.dir, doneDir);
+        }
+        catch {
+            // rename 失败时静默（某些文件系统/权限问题），保留原目录
+        }
+    }
+    /**
+     * 强制清理（/new 或新 workflow init 时调用）：删除状态目录（含 .done 归档）。
+     */
     async cleanup() {
         await rm(this.dir, { recursive: true, force: true }).catch(() => { });
+        // 同时清理可能的归档目录
+        await rm(this.dir + DONE_SUFFIX, { recursive: true, force: true }).catch(() => { });
     }
 }

package/skills/commit/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: commit
 description: 当用户说"提交"、"commit"、"git commit"、"保存改动"、"帮我提交代码"、"生成提交信息"时使用。自动分析 git diff，生成规范的 Conventional Commit message，支持 feat/fix/docs/refactor/chore/style/test 等类型前缀。
-triggers: 提交代码、git commit、生成 commit message、版本管理、commit message
 ---
 
 # /commit —— Git 提交规范化

package/skills/config/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: config
 description: 配置向导技能。当用户输入 "/config" 且没有任何其他内容时触发。用于重新配置 LLM provider（BASE_URL / API_KEY / MODEL）。
-triggers: 配置、初始化、设置、重新配置、config
 ---
 
 # Config Skill

package/skills/diff/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: diff
 description: 当用户问"改了什么"、"有什么变化"、"show me changes"、"看看改动"、"diff"、"差异"时使用。显示工作区或暂存区的变更内容，帮助用户理解当前代码状态。
-triggers: 代码差异、对比、变更审查、diff 分析、diff、代码对比
 ---
 
 # /diff —— 查看 Git 变更

package/skills/docx/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: docx
 description: "Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation."
-triggers: Word 文档、docx、文档编辑、报告撰写、合同、公文、批量文档处理、Word 文件
 license: Proprietary. LICENSE.txt has complete terms
 ---
 

package/skills/image-gen-openrouter/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: image-gen-openrouter
 description: 当用户说"生成图片"、"画一张图"、"配图"、"OpenRouter 生图"、"nano banana"、"image-gen-openrouter"，或在 workflow 里要按提示词生成图片时使用。调用 OpenRouter 的 Chat Completions 接口（OpenAI 兼容 + image modalities），按提示词生成任意比例图片并落盘。
-triggers: 生成图片、画一张图、配图、OpenRouter 生图、image-gen-openrouter、文生图、AI画图
 ---
 
 # image-gen-openrouter —— OpenRouter 文生图

package/skills/pdf/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: pdf
 description: Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.
-triggers: PDF 文件、PDF 转换、PDF 提取、PDF 生成、pdf 文件处理、PDF 操作
 license: Proprietary. LICENSE.txt has complete terms
 ---
 

package/skills/pptx/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: pptx
 description: "Use this skill any time a .pptx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates, layouts, speaker notes, or comments. Trigger whenever the user mentions \"deck,\" \"slides,\" \"presentation,\" or references a .pptx filename, regardless of what they plan to do with the content afterward. If a .pptx file needs to be opened, created, or touched, use this skill."
-triggers: PPT、幻灯片、演示文稿、deck、slides、presentation、pptx 文件、做汇报材料、演讲稿
 license: Proprietary. LICENSE.txt has complete terms
 ---
 

package/skills/simplify/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: simplify
 description: 当用户说"简化"、"审查"、"review"、"优化这段代码"、"太复杂了"、"能不能更简洁"、"代码质量"时使用。启动多维度代码审查，识别冗余、反模式、性能问题，给出具体修改建议。
-triggers: 简化代码、重构、代码精简、降低复杂度、simplify、代码简化
 ---
 
 # /simplify —— 代码审查与简化

package/skills/subtitle-srt/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: subtitle-srt
 description: 当用户说"生成字幕"、"做 SRT"、"字幕文件"、"subtitle-srt"，或在 workflow 里要把分段文本 + 时长信息转成标准 SRT 字幕文件时使用。给定 cue 列表（每条带文本和起止时间或时长），生成符合 SRT 规范的字幕文件。
-triggers: 生成字幕、做 SRT、字幕文件、subtitle-srt、字幕生成
 ---
 
 # subtitle-srt —— SRT 字幕生成

package/skills/tts-zh/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: tts-zh
 description: 当用户说"中文配音"、"中文 TTS"、"语音合成"、"文字转语音"、"tts-zh"，或在 workflow 里要把中文文本转成 mp3 时使用。优先用 MiniMax T2A API，失败时 fallback 到 edge-tts 离线方案，输出 mp3 到指定路径。
-triggers: 中文配音、中文 TTS、语音合成、文字转语音、tts-zh、配音、朗读
 ---
 
 # tts-zh —— 中文 TTS（minimax 主 + edge-tts 兜底）

package/skills/video-compose/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: video-compose
 description: 当用户说"合成视频"、"做 mp4"、"图片转视频"、"ffmpeg 拼视频"、"video-compose"，或在 workflow 里要把图片序列 + 可选音轨 + 可选字幕合成成 mp4 时使用。本 skill 是 ffmpeg 的 declarative 封装，所有参数（分辨率、字体、码率、转场）都可配置，不绑定特定视频格式。
-triggers: 合成视频、做 mp4、图片转视频、ffmpeg 拼视频、video-compose、视频制作
 ---
 
 # video-compose —— 通用 ffmpeg 视频合成

package/skills/web-artifacts-builder/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: web-artifacts-builder
 description: Suite of tools for creating elaborate, multi-component web artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui). Use for complex artifacts requiring state management, routing, or shadcn/ui components - not for simple single-file HTML/JSX artifacts. Trigger when user asks to build a web app, React component, interactive UI, landing page, dashboard, or any frontend project.
-triggers: Web 应用、React 组件、交互式 UI、落地页、仪表盘、前端项目、web-artifacts-builder、构建网页
 license: Complete terms in LICENSE.txt
 ---
 

package/skills/webapp-testing/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: webapp-testing
 description: Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.
-triggers: Web 测试、浏览器测试、Playwright、截图、UI 调试、webapp-testing、网页测试
 license: Complete terms in LICENSE.txt
 ---
 

package/skills/xlsx/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: xlsx
 description: "Use this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like \"the xlsx in my downloads\") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved."
-triggers: Excel、表格、xlsx、数据处理、图表、批量数据、CSV 导入导出、电子表格
 license: Proprietary. LICENSE.txt has complete terms
 ---
 

package/src/infra/verification.js

@@ -0,0 +1,228 @@
+/**
+ * ============================================================
+ *  src/infra/verification.ts —— 共享验证基础设施
+ * ------------------------------------------------------------
+ *  从 plugins/ralph-wiggum/src/verificationGate.ts 提升为共享模块。
+ *
+ *  支持四种检查器（跨平台）：
+ *    - shell:<cmd>                跨平台 spawn（Windows 走 cmd /c, 其余 bash -c）
+ *    - file_exists:<path>         fs.existsSync
+ *    - file_contains:<file>:<re>  正则匹配文件内容
+ *    - test_count:<min>           跑 `bun test`，从 stdout 解析 "N pass"
+ *
+ *  消费者：
+ *    - ralph-wiggum 插件（循环验证门）
+ *    - workflow-runner 插件（verify 步骤类型）
+ *    - 未来任何需要声明式验证的插件或模块
+ *
+ *  设计原则：
+ *    - 纯工具函数，无全局状态，无副作用（除了 shell 子进程）
+ *    - 不依赖任何插件代码，可被 src/ 和 plugins/ 同时导入
+ *    - 工作目录隔离：所有相对路径以 getWorkingDir() 为锚
+ * ============================================================
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { spawn } from 'node:child_process';
+import { getWorkingDir } from '../bootstrap/workingDir.js';
+/** 从 "type:value" 字符串解析为 Check 对象。 */
+function parseVerifyArg(arg) {
+    const colonIdx = arg.indexOf(':');
+    if (colonIdx < 0)
+        return null;
+    const type = arg.slice(0, colonIdx).trim().toLowerCase();
+    const value = arg.slice(colonIdx + 1).trim();
+    switch (type) {
+        case 'shell':
+            return { type: 'shell', command: value, timeout: 30_000 };
+        case 'file_exists':
+            return { type: 'file_exists', file: value };
+        case 'file_contains': {
+            const sep = value.indexOf(':');
+            if (sep < 0)
+                return null;
+            return {
+                type: 'file_contains',
+                file: value.slice(0, sep),
+                pattern: value.slice(sep + 1),
+            };
+        }
+        case 'test_count': {
+            const count = parseInt(value, 10);
+            if (isNaN(count) || count < 0)
+                return null;
+            return { type: 'test_count', minCount: count };
+        }
+        default:
+            return null;
+    }
+}
+/**
+ * 从命令行参数字符串中提取所有 --verify 项。
+ * 兼容两种调用方式：
+ *   - ralph-loop 的 args 字符串：`"goal --verify 'shell:bun test'"`
+ *   - workflow verify 步骤的 checks 数组元素：`"shell:bun test"`
+ */
+export function parseVerifyArgs(args) {
+    const checks = [];
+    const regex = /--verify\s+("[^"]*"|\S+)/gi;
+    let match;
+    while ((match = regex.exec(args)) !== null) {
+        const raw = match[1].replace(/^"|"$/g, '');
+        const check = parseVerifyArg(raw);
+        if (check)
+            checks.push(check);
+    }
+    return checks;
+}
+/** 从单个 check 字符串解析（workflow verify 步骤用）。 */
+export function parseCheckString(raw) {
+    return parseVerifyArg(raw);
+}
+function runShell(command, timeout) {
+    return new Promise((resolve) => {
+        const isWin = process.platform === 'win32';
+        const child = isWin
+            ? spawn('cmd', ['/c', command], { timeout, env: process.env })
+            : spawn('bash', ['-c', command], { timeout, env: process.env });
+        let stdout = '';
+        let stderr = '';
+        child.stdout.on('data', (d) => {
+            stdout += d.toString();
+        });
+        child.stderr.on('data', (d) => {
+            stderr += d.toString();
+        });
+        child.on('error', () => {
+            resolve({ exitCode: null, stdout, stderr, errored: true });
+        });
+        child.on('close', (code) => {
+            resolve({ exitCode: code, stdout, stderr, errored: false });
+        });
+    });
+}
+export async function verifyShell(command, timeout) {
+    const r = await runShell(command, timeout);
+    if (r.errored) {
+        return {
+            check: { type: 'shell', command },
+            passed: false,
+            output: `执行失败`,
+        };
+    }
+    return {
+        check: { type: 'shell', command },
+        passed: r.exitCode === 0,
+        output: r.stdout.trim() || r.stderr.trim() || `exit code ${r.exitCode}`,
+    };
+}
+export function verifyFileExists(file) {
+    // 相对路径以 workingDir 为锚
+    const resolved = file.startsWith('/') || /^[A-Za-z]:/.test(file)
+        ? file
+        : `${getWorkingDir()}/${file}`;
+    const exists = existsSync(resolved);
+    return {
+        check: { type: 'file_exists', file },
+        passed: exists,
+        output: exists ? '文件存在' : `文件不存在: ${resolved}`,
+    };
+}
+export function verifyFileContains(file, pattern) {
+    const resolved = file.startsWith('/') || /^[A-Za-z]:/.test(file)
+        ? file
+        : `${getWorkingDir()}/${file}`;
+    try {
+        const content = readFileSync(resolved, 'utf8');
+        const regex = new RegExp(pattern);
+        const matched = regex.test(content);
+        return {
+            check: { type: 'file_contains', file, pattern },
+            passed: matched,
+            output: matched ? `文件包含 "${pattern}"` : `文件不包含 "${pattern}"`,
+        };
+    }
+    catch {
+        return {
+            check: { type: 'file_contains', file, pattern },
+            passed: false,
+            output: `无法读取文件: ${resolved}`,
+        };
+    }
+}
+async function verifyTestCount(minCount) {
+    const r = await runShell(`bun test`, 60_000);
+    const combined = `${r.stdout}\n${r.stderr}`;
+    if (r.errored) {
+        return {
+            check: { type: 'test_count', minCount },
+            passed: false,
+            output: '无法执行 bun test',
+        };
+    }
+    const matches = [...combined.matchAll(/(\d+)\s+pass/gi)];
+    const count = matches.length > 0 ? parseInt(matches[matches.length - 1][1], 10) : 0;
+    const passed = count >= minCount;
+    return {
+        check: { type: 'test_count', minCount },
+        passed,
+        output: `${count} pass (需要 >=${minCount})`,
+    };
+}
+/**
+ * 执行一组检查，返回聚合结果。
+ * 全部通过 → passed=true；任一失败 → passed=false + summary 列出失败项。
+ */
+export async function runVerification(checks) {
+    if (checks.length === 0) {
+        return { passed: true, details: [], summary: '无验证项' };
+    }
+    const results = [];
+    for (const check of checks) {
+        let result;
+        switch (check.type) {
+            case 'shell':
+                result = await verifyShell(check.command ?? '', check.timeout ?? 30_000);
+                break;
+            case 'file_exists':
+                result = verifyFileExists(check.file ?? '');
+                break;
+            case 'file_contains':
+                result = verifyFileContains(check.file ?? '', check.pattern ?? '');
+                break;
+            case 'test_count':
+                result = await verifyTestCount(check.minCount ?? 0);
+                break;
+            default:
+                result = {
+                    check,
+                    passed: false,
+                    output: `未知验证类型: ${check.type}`,
+                };
+        }
+        results.push(result);
+    }
+    const allPassed = results.every((r) => r.passed);
+    const failedNames = results.filter((r) => !r.passed).map((r) => formatCheckName(r.check));
+    let summary;
+    if (allPassed) {
+        summary = `✅ 全部通过 (${results.length}/${results.length})`;
+    }
+    else {
+        summary = `❌ 验证未通过: ${failedNames.join(', ')}`;
+    }
+    return { passed: allPassed, details: results, summary };
+}
+function formatCheckName(check) {
+    switch (check.type) {
+        case 'shell':
+            return `shell(${(check.command ?? '').slice(0, 40)})`;
+        case 'file_exists':
+            return `exists(${check.file})`;
+        case 'file_contains':
+            return `contains(${check.file}:${check.pattern})`;
+        case 'test_count':
+            return `tests(>=${check.minCount})`;
+        default:
+            return check.type;
+    }
+}

package/src/plugins/pluginRunner.js

@@ -28,10 +28,27 @@ export async function* runWithPlugins(userInput, options) {
         });
         return;
     }
-    await discoverPlugins();
+    const manifests = await discoverPlugins();
     const matched = resolveCommand(userInput);
     if (!matched) {
-        // 未知 / 命令直接喂 LLM,让模型自然回复(等同于普通文本)
+        // 提取命令名用于错误提示
+        const cmdName = userInput.trimStart().split(/\s+/)[0]; // "/workflow" 或 "/plan"
+        // 有插件但未命中该命令 → 明确提示可用命令
+        if (manifests.length > 0) {
+            const cmdList = manifests.flatMap((m) => m.commands.map((c) => `/${c.name}`)).join('、');
+            yield {
+                type: 'error',
+                error: `未找到命令 "${cmdName}"。已安装的插件命令：${cmdList || '（无）'}。`,
+            };
+        }
+        else {
+            // 无任何插件 → 告知用户
+            yield {
+                type: 'error',
+                error: `当前未安装任何插件。命令 "${cmdName}" 无法执行。`,
+            };
+        }
+        // fallback 到普通 TAOR 对话，用户可继续操作
         yield* runQuery(userInput, {
             provider,
             history,

package/src/prompts/pluginList.js

@@ -37,8 +37,8 @@ export function formatPluginHint(plugins) {
     const lines = [
         '# 可用插件（/命令）',
         '',
-        '以下是当前已安装的插件。**注意：插件命令必须由用户主动通过 /xxx 输入触发**，你不要自行模拟或伪造插件执行。',
-        '当用户消息以 / 开头且匹配以下某个命令时，表示用户要触发对应插件功能。你可以根据上下文建议用户使用某个插件，但不能代替用户执行 / 命令。',
+        '以下是当前已安装的插件。**插件只能由用户通过 /xxx 命令触发——你绝对不能代替用户执行、模拟或建议使用插件功能**。',
+        '只有当用户明确询问"有哪些命令/插件可用"时，才列出以下内容。其他时候不要提及插件。',
         '',
     ];
     for (const p of plugins) {

package/src/prompts/promptAssembly.js

@@ -38,7 +38,11 @@ const CORE_IDENTITY = `# 思维与立场（核心：像专家一样独立思考
 
 # 行为约束
 - 没有用户许可不要执行破坏性操作（rm -rf / git reset --hard / git push --force 等）。
-- 如果用户的请求不清晰、或有多个合理方向需要取舍：优先用 AskUserQuestion 让用户拍板（带推荐项），而不是替他猜着干；只缺一点小信息时一句话澄清即可。
+- **提问克制原则（重要！）**：只在以下**三种情况**才使用 AskUserQuestion 提问用户，其他情况一律自己判断、选推荐项继续：
+  1. **信息不全且无法推断**：用户请求缺少关键信息（如"部署到哪个环境"），且无法从上下文/代码/文件中找到答案；
+  2. **多方案各有真实优劣**：存在多个可行方案，每个都有明确 trade-off（不是你懒得选），且选择会影响后续方向；
+  3. **不可逆破坏性操作前确认**：涉及数据丢失或不可回滚的操作（如删除数据库、覆盖生产配置）。
+  **不符合以上三条的，不要提问。** "有取舍就问"是错误的理解——大多数取舍你应该自己判断并选推荐项继续。只缺一点小信息时自己推断或用一句话默认假设即可。
 - 任务完成后用一两句话总结改了什么，不要长篇大论。
 
 # 修改 vs 讨论（动手边界，重要）
@@ -59,7 +63,21 @@ const CORE_IDENTITY = `# 思维与立场（核心：像专家一样独立思考
 1. **这是新任务还是上一任务的延续？**——"继续/接着做/再加一个/还有"=延续，保持当前任务上下文；"帮我做 X/这次做 Y/另外"=多半是新任务；"重新开始/不算了，做 X"=立即放下旧任务。
 2. **历史里哪些和当前问题相关？**——只把与当前问题直接相关的消息、文件、工具结果当活动上下文；无关的旧任务细节当背景，**不要拿旧任务的结论/文件/方案硬套当前问题**（典型翻车：上个任务在改 A，这次问的是 B，却惯性去翻 A）。
 3. **判不准边界就先确认**：一句话澄清"你是继续刚才的 X，还是开始新的？"，别默默假设。
-- 当前用户消息 + 紧邻的最近几条消息，权重永远高于更早历史；越早、越不相关的内容参考价值越低。`;
+- 当前用户消息 + 紧邻的最近几条消息，权重永远高于更早历史；越早、越不相关的内容参考价值越低。
+
+# 上下文隔离（重要！工作流/命令执行完毕后的行为规则）
+- /plan、/workflow 等命令执行完后**自动回到普通对话模式**——下一条用户输入默认是全新任务。
+- **只有当用户明确提到延续意图时**（"继续"、"接着做"、"按照计划执行"、"读一下 PLAN.md"、"修改刚才的结果"），才去关联之前的工作流产物（PLAN.md、生成的文件等）。
+- 用户提出全新任务时（如"帮我写个函数"、"这个bug怎么修"、"review 下代码"），**不要主动 Read 之前的 PLAN.md 或引用上次工作流的结果**——那是上一次的产出，与当前任务无关。
+- 当前目录可能存在之前 /plan 留下的 PLAN.md 文件：判断标准是**用户消息是否包含对之前产出的引用**？没有就当新任务处理。
+- 如果你不确定是新任务还是延续，优先按**新任务**处理——宁可多问一句也不要用旧上下文污染新工作。
+
+# 中断后调整（重要！）
+- 用户可能在上一步 /plan 或 /workflow 执行中途按 ESC/Ctrl+C 中断，然后立即输入调整指令（如"把第3步改成xxx"、"换个方向重新计划"）。
+- **检测方法**：如果用户消息包含调整/修改/重做/换方向 等词 + 历史中有 /plan 或 /workflow 的痕迹 → 这是**中断后调整**，不是全新任务。
+- **小调整处理**：先 Read ./PLAN.md 了解当前计划状态，然后直接在当前 TAOR 对话中完成修改（Edit 写入 PLAN.md 或用工具产出新文件）。不需要重新跑 /plan 工作流。
+- **大改/重做处理**：如果用户要求完全重做或换方向，建议用户用 '/plan 新目标' 重新跑完整流程——这会覆盖旧的 PLAN.md 并从头开始。
+- **不要混淆**："中断后调整"和"全新任务"的关键区别是**用户是否提到了对之前产出的修改意图**。提到修改→读 PLAN.md 继续接着做；没提→当新任务。`;
 // ==================== Layer 1: 环境感知 ====================
 function buildEnvLayer(cwd) {
     const today = new Date().toISOString().slice(0, 10);
@@ -154,12 +172,18 @@ export async function assembleBasePrompt(options) {
     const skillHint = formatSkillHint(skills);
     if (skillHint)
         parts.push(skillHint);
-    // Layer 4: 插件目录（实时扫描 plugins/）
+    // Layer 4: 插件目录（可选增量，异常时不阻塞基础内核）
     if (includePlugins) {
-        const plugins = await getPluginMetaList();
-        const pluginHint = formatPluginHint(plugins);
-        if (pluginHint)
-            parts.push(pluginHint);
+        try {
+            const plugins = await getPluginMetaList();
+            const pluginHint = formatPluginHint(plugins);
+            if (pluginHint)
+                parts.push(pluginHint);
+        }
+        catch {
+            // 插件扫描失败（目录损坏/权限错误/yaml语法错误等）不影响基础内核
+            // dlog('prompt', 'plugin scan failed, skipping Layer 4');
+        }
     }
     // Layer 5: 项目指令（可选）
     if (includeProjectInstructions) {
@@ -198,12 +222,17 @@ export async function assembleCapabilityHint(cwd) {
         parts.push(skillHint);
         hasContent = true;
     }
-    // Layer 4: Plugin 目录
-    const plugins = await getPluginMetaList();
-    const pluginHint = formatPluginHint(plugins);
-    if (pluginHint) {
-        parts.push(pluginHint);
-        hasContent = true;
+    // Layer 4: Plugin 目录（可选增量，异常时跳过）
+    try {
+        const plugins = await getPluginMetaList();
+        const pluginHint = formatPluginHint(plugins);
+        if (pluginHint) {
+            parts.push(pluginHint);
+            hasContent = true;
+        }
+    }
+    catch {
+        // 插件扫描失败不影响 skill hint
     }
     if (!hasContent)
         return '';

package/src/prompts/skillList.js

@@ -1,17 +1,16 @@
 /**
  * ============================================================
- *  src/prompts/skillList.ts —— Skill 列表生成（积极使用版）
+ *  src/prompts/skillList.ts —— Skill 列表生成
  * ------------------------------------------------------------
- *  设计原则（v3 重构）：
+ *  设计原则：
  *    1. System Prompt 里只注入 frontmatter 元数据轻量列表
- *       → 让 T 阶段的 LLM 知道"有哪些技能可用 + 何时触发 + 是什么类型"
+ *       → 让 LLM 知道"有哪些技能可用 + 功能是什么"
  *       → 不加载完整 SKILL.md（省 token，按需加载）
  *    2. LLM 决定使用某个 skill 时，用 Read 工具读取对应 SKILL.md
  *       → 类似 lazy loading：知道存在 → 需要时才加载详情
- *    3. 格式对齐 Tools 的风格：每个 skill 固定 3 行信息
- *    4. 完全依赖 frontmatter 声明（name / description / type / triggers），
- *       不再做任何启发式推断。新增 skill 时必须在 frontmatter 显式声明
- *       type 和 triggers 字段（缺省时给出占位提示）。
+ *    3. 格式简洁：每个 skill 固定 2-3 行信息
+ *    4. 仅依赖 frontmatter 的 name / description 字段，
+ *       不依赖 triggers（并非所有 skill 都声明触发词）。
  * ============================================================
  */
 import { readFile, readdir } from 'node:fs/promises';
@@ -33,14 +32,12 @@ function parseFrontmatter(content, sourceDir) {
     const nameMatch = frontmatter.match(/^name:\s*(.+)$/m);
     const descMatch = frontmatter.match(/^description:\s*(.+)$/m);
     const typeMatch = frontmatter.match(/^type:\s*(.+)$/m);
-    const triggersMatch = frontmatter.match(/^triggers:\s*(.+)$/m);
     if (!nameMatch || !descMatch)
         return null;
     return {
         name: stripQuotes(nameMatch[1]),
         description: stripQuotes(descMatch[1]),
         type: typeMatch ? stripQuotes(typeMatch[1]) : undefined,
-        triggers: triggersMatch ? stripQuotes(triggersMatch[1]) : undefined,
         sourceDir,
     };
 }
@@ -75,18 +72,18 @@ export async function getSkillList() {
     return skills;
 }
 /**
- * 生成积极的 skill 列表提示词。
+ * 生成 skill 列表提示词。
  *
- * 输出格式（每个 skill 固定 3 行）:
- *   ## /skill-name —— 一句话标题
- *   - **触发时机**: 用户说 "xxx"、"yyy" 时使用
+ * 输出格式（每个 skill 固定 2-3 行）:
+ *   ## /skill-name
  *   - **功能**: 一句话描述这个 skill 做什么
  *   - **类型**: prompt / local / local-jsx
  *
  * 关键设计决策：
  *   - 不加载 SKILL.md 全文（节省 ~1500+ tokens/skill）
- *   - 只输出 name + description（每个 skill ~40 tokens）
- *   - 明确告诉 LLM "决定用时再 Read SKILL.md"
+ *   - 只输出 name + description（每个 skill ~30 tokens）
+ *   - 不依赖 triggers 字段（并非所有 skill 都声明触发词）
+ *   - LLM 根据 description 语义匹配决定是否使用
  */
 export function formatSkillHint(skills) {
     if (skills.length === 0) {
@@ -96,15 +93,13 @@ export function formatSkillHint(skills) {
     // ---- 标题段 ----
     lines.push('# 可用技能（/命令）');
     lines.push('');
-    lines.push('以下是当前可用的技能（**双源**：用户项目目录 + minimal-agent 包目录，同名时项目优先）。**当用户意图匹配某个技能的触发时机时，你应该主动使用它**。');
+    lines.push('以下是当前可用的技能（**双源**：用户项目目录 + minimal-agent 包目录，同名时项目优先）。**当用户需求与某个技能的功能描述匹配时，你应该主动使用它**。');
     lines.push('在使用前，先用 Read 工具读取下方每个技能卡片里的 `**技能目录**` 路径 + `/SKILL.md` 了解完整流程。');
     lines.push('');
     // ---- 每个技能的卡片 ----
     for (const skill of skills) {
         const type = skill.type ?? 'prompt（展开为系统提示词，指导模型执行复杂任务）';
-        const triggers = skill.triggers ?? '（详见 SKILL.md）';
         lines.push(`## ${skill.name}`);
-        lines.push(`- **触发时机**: ${triggers}`);
         lines.push(`- **功能**: ${skill.description}`);
         lines.push(`- **类型**: ${type}`);
         lines.push(`- **技能目录**: \`${skill.sourceDir}\``);
@@ -114,8 +109,8 @@ export function formatSkillHint(skills) {
     lines.push('## 技能调用流程');
     lines.push('');
     lines.push('```');
-    lines.push('1. 在 T 阶段判断用户意图是否匹配某个技能的触发时机');
-    lines.push('2. 匹配 → 在 A 阶段用 Read 工具读取该技能卡片的"技能目录"/SKILL.md');
+    lines.push('1. 判断用户意图是否与某个技能的功能描述匹配');
+    lines.push('2. 匹配 → 用 Read 工具读取该技能卡片的"技能目录"/SKILL.md');
     lines.push('3. 按照 SKILL.md 的 Quick Reference 和流程执行');
     lines.push('4. 技能脚本（scripts/）与 SKILL.md 位于同一目录下，用绝对路径执行');
     lines.push('5. 如果技能类型是 prompt，将其内容作为额外上下文指导后续操作');

package/src/ui/App.js

@@ -190,7 +190,7 @@ export function App({ provider, initialHistory }) {
     // 它必须是兄弟节点中第一个，否则 above-sibling 会跟 Static commit 一起被重打
     // 到 stdout（实测看到 banner 反复打印 N 次）。
     const bannerText = `minimal-agent  · ${provider.name}/${provider.model} · /new 清空 · /compact 压缩 · /exit 退出 · Ctrl+C 中断`;
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(MessageList, { history: deferredHistory, compactGeneration: chat.compactGeneration, bannerText: bannerText, terminalRows: terminalRows }), _jsxs(Box, { flexDirection: "column", width: Math.max(1, terminalCols - 1), children: [_jsx(LiveArea, { progressStage: chat.progressStage, reasoningPreview: chat.reasoningPreview, streamingText: chat.streamingText, runningTools: chat.runningTools, pluginProgress: chat.pluginProgress, terminalCols: terminalCols, terminalRows: terminalRows }), chat.error && (_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { color: "red", children: ["\u26A0 ", chat.error] }) })), chat.interrupted && (_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "yellow", children: "\u26A1 \u64CD\u4F5C\u88AB\u7528\u6237\u4E2D\u65AD\uFF0C\u7B49\u5F85\u65B0\u7684\u4EFB\u52A1\u8F93\u5165..." }) })), chat.pendingAsk ? (_jsx(AskQuestion, { questions: chat.pendingAsk, onAnswer: chat.answerAsk, onCancel: chat.abort })) : (
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(MessageList, { history: deferredHistory, compactGeneration: chat.compactGeneration, bannerText: bannerText, terminalRows: terminalRows }), _jsxs(Box, { flexDirection: "column", width: Math.max(1, terminalCols - 1), children: [_jsx(LiveArea, { progressStage: chat.progressStage, reasoningPreview: chat.reasoningPreview, streamingText: chat.streamingText, runningTools: chat.runningTools, pluginProgress: chat.pluginProgress, terminalCols: terminalCols, terminalRows: terminalRows }), chat.error && (_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { color: "red", children: ["\u26A0 ", chat.error] }) })), chat.interrupted && (_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { color: "yellow", children: "\u26A1 \u64CD\u4F5C\u88AB\u7528\u6237\u4E2D\u65AD\uFF0C\u7B49\u5F85\u65B0\u7684\u4EFB\u52A1\u8F93\u5165..." }), _jsx(Text, { dimColor: true, children: "  \u8C03\u6574\u4E0A\u4E00\u6B21\u8BA1\u5212\uFF1A\u76F4\u63A5\u8BF4\u8C03\u6574\u5185\u5BB9 / \u91CD\u65B0\u8DD1 /plan \u76EE\u6807 / \u65B0\u4EFB\u52A1\u76F4\u63A5\u8BF4" })] })), chat.pendingAsk ? (_jsx(AskQuestion, { questions: chat.pendingAsk, onAnswer: chat.answerAsk, onCancel: chat.abort })) : (
                     /* handleSubmit 包装做 slash 命令拦截，非命令透传 chat.submit */
                     _jsx(InputBox, { onSubmit: handleSubmit, disabled: chat.isLoading, onAbort: chat.abort, onClear: handleClear, onCompact: chat.compactNow })), _jsx(StatusLine, { provider: provider, history: chat.history, pluginProgress: chat.pluginProgress })] })] }));
 }

package/workflows/plan.yaml

@@ -1,29 +1,22 @@
 # ============================================================
-#  workflows/plan.yaml —— 复刻 Claude Code「plan」流程（Clarify→Analyze→Verify→Synthesize→Critic→Gate）
+#  workflows/plan.yaml —— 零交互计划流程（Analyze→Verify→Synthesize→Critic→Gate→Execute→Summary）
 # ------------------------------------------------------------
-#  设计目标：① 跨基座模型稳（弱模型也能跑完，不依赖强 agent 多轮工具循环）；
-#            ② 提问只在「开头一次性」发生，之后全自主无打断，直到产出可提交的 PLAN.md。
+#  设计目标：① 跨模型稳（弱模型也能跑完）；② 零用户交互——全程自主；
+#            ③ 计划详细程度从 goal 自动推断，不提问。
 #  全用现有 StepKind（不改引擎）：
-#    Clarify   : clarify_depth(AskUserQuestion 开头一次性问深度——全流程唯一的人机交互点)
 #    Analyze   : analyze(agent 只读探索) → extract_findings(llm+schema 固化成可验证 claims)
 #    Verify    : verify_findings(type:vote 红队对每条 finding 反向提问证伪，存活的才进下游)
 #    Synthesize: draft_plan(llm 纯文本出计划正文) → read_existing_plan + write_plan(tool 确定性落盘)
 #    Critic    : critic_plan(skill:adversarial-review 反向提问审稿，追加进 PLAN.md)
 #    Gate      : verify(assert 守门确认 PLAN.md 生成)
+#    Execute   : execute_plan(agent 按计划执行，产出最终交付物)
+#    Summary   : exit_summary(llm 退出摘要)
 # ------------------------------------------------------------
-#  模型兼容性要点（为什么这样切分——上一版在火山 GLM-5.1 上两处翻车的根治）：
-#    1. 写盘用 "llm 出正文 + tool:Write 落盘" 而非 agent。原 agent+Write 写法在弱模型上
-#       会反复调 Write 触发 miniReAct 重复检测 halt；真因还叠加 Write 的"覆盖前须先 Read"
-#       守卫——PLAN.md 已存在时首个 Write 被拒、模型重试同参 Write→3 次→halt。
-#       故 write 前置一个 tool:Read（onError:continue，首跑文件不存在则略过）满足守卫。
-#    2. 结构化输出(extract_findings / vote)由 client.ts 自动退化：provider 不支持
-#       response_format.json_schema(火山 GLM)时去掉它、靠 prompt 内嵌 schema + 容错解析。
-#    3. 仍是 agent 的只剩 analyze（只读探索）与 critic（审稿，onError:continue 兜底），
-#       它们在弱模型上最坏只是 halt/跳过，不破坏已产出的计划。
-# ------------------------------------------------------------
-#  提问节奏：唯一提问点 clarify_depth 放最前——问完之后全程自主无打断。任务专属、
-#  本工作流没问的点（受众/时长/范围等）由 draft 自做合理默认假设并在正文开头列出，
-#  绝不中途打断（契合"明确有优劣自动判断、只有真取舍才问、开头问完即自主"）。
+#  提问策略：本工作流**零交互**。计划深度从用户 goal 自动推断：
+#    - 目标含"概览/快速/简单/简短" → 快速概览
+#    - 目标含"详细/完整/分步/彻底/带风险" → 带风险回滚评估
+#    - 其他 → 详细分步（默认推荐）
+#    不询问用户选择深度——自行判断。
 # ------------------------------------------------------------
 #  注：critic 用 skill: 节点 dogfood 仓库自带的 adversarial-review skill。
 #  skill 双源查找（cwd 优先、packageRoot fallback）；异地 cwd 缺该 skill 时
@@ -31,10 +24,10 @@
 # ============================================================
 name: plan
 description: |
-  受工作流指导 + 红队对抗验证 + 反向提问审稿的动态计划流程（跨模型稳、开头一次性提问后全自主）。
-  Clarify(开头问深度) → Analyze(探索+固化) → Verify(vote 红队证伪) → Synthesize(出正文+落盘)
-  → Critic(反向提问审稿追加) → Gate(assert 守门)。minimal-agent 的旗舰演示。
-version: "0.3"
+  零交互计划流程（跨模型稳、全程自主、自动推断深度）。
+  Analyze(探索+固化) → Verify(vote 红队证伪) → Synthesize(出正文+落盘)
+  → Critic(反向提问审稿追加) → Gate(assert 守门) → Execute(按计划执行) → Summary(退出摘要)。
+version: "0.4"
 
 inputs:
   - name: goal
@@ -43,26 +36,6 @@ inputs:
     description: "要做的事 / 目标"
 
 steps:
-  # ===================== Clarify（开头唯一提问点）=====================
-  # [Clarify] 一次性问"计划深度"（这是真有取舍、无统一最优的点；第一项=推荐，非交互自动选它）。
-  #   放最前：问完之后全程自主。其它任务专属细节(受众/时长/范围)由 draft 自做合理默认并列出，
-  #   不再中途打断——契合"明确有优劣自动判断、只有真取舍才问"。
-  - id: clarify_depth
-    tool: AskUserQuestion
-    args:
-      questions:
-        - header: "计划深度"
-          question: "希望这份实现计划做到多详细？"
-          options:
-            - label: "详细分步 (推荐)"
-              description: "拆成可执行的有序步骤，每步说清动作、涉及文件与验收点"
-            - label: "快速概览"
-              description: "只给高层方向与关键决策，不展开到每一步"
-            - label: "带风险/回滚评估"
-              description: "在详细分步之外，额外标注每步风险与回滚方案"
-    capture:
-      content: depth_answer
-
   # ===================== Analyze =====================
   # [Analyze-1] 只读探索：agent 自主用 Read/Grep/Glob 摸清现状（不写盘、不副作用）
   - id: analyze
@@ -128,17 +101,18 @@ steps:
       —— 仍未决的问题 ——
       ${open_questions}
 
-      —— 用户选择的计划深度 ——
-      ${depth_answer}
+      ## 计划详细程度（自动推断，不询问用户）
+      根据用户目标「${inputs.goal}」中的关键词自动判断：
+      - 如果目标包含"概览"、"快速"、"简单"、"简短"、"简要"、"大致"等词 → 输出快速概览（高层方向与关键决策，不展开到每一步）
+      - 如果目标包含"详细"、"完整"、"分步"、"彻底"、"风险"、"回滚"、"全面"等词 → 输出带风险/回滚评估的详细计划
+      - 其他情况 → 默认输出**详细分步**计划（可执行的有序步骤，每步说清动作、涉及文件与验收点）
 
       要求：
-      - 详细程度遵循用户选择的深度；
+      - 按上述推断的详细程度输出；
       - "存活结论"为空时不要硬编：按目标常识给出合理的计划骨架；
       - 凡需按需求拍板、但本工作流未询问的点（如受众/时长/范围），**自行做合理默认假设并继续**，
         在正文开头用「## 假设（如需调整请告知）」一节列出假设，**绝不中断提问**。
     capture:
-      # llm 步（无 output_schema）的 raw 只有 {text,result}，没有 content（那是 tool 步的字段）。
-      # 用错字段会 capture 到 undefined → 下游 Write 写 0 字节（已被端到端测试抓到）。
       text: plan_text
 
   # [Synthesize-2] 满足 Write 的"覆盖前须先 Read"守卫：PLAN.md 已存在则先 Read；
@@ -149,7 +123,7 @@ steps:
       file_path: ./PLAN.md
     onError: continue
 
-  # [Synthesize-3] 落盘：tool:Write 确定性写入（不经 agent 循环，弱模型也稳）
+  # [Synthesis-3] 落盘：tool:Write 确定性写入（不经 agent 循环，弱模型也稳）
   - id: write_plan
     tool: Write
     args:
@@ -174,3 +148,41 @@ steps:
     type: assert
     condition: 'fileExists("./PLAN.md")'
     onFail: "计划文件 ./PLAN.md 未生成，检查 draft_plan/write_plan 步是否成功"
+
+  # ===================== Execute（按计划执行）=====================
+  # [Execute] 读取已落盘的 PLAN.md，agent 自主按计划步骤逐一执行，
+  #   直到完成所有任务并产出最终交付物。
+  #   onError: recover —— 执行中撞上预料之外的错误就就地降级为 agent 自适应恢复。
+  - id: execute_plan
+    agent: |
+      下面是一份已经过完整工作流验证的实现计划（./PLAN.md）。
+      请先 Read ./PLAN.md 了解完整计划内容和步骤。
+      然后严格按照计划的步骤逐一执行，直到完成所有任务并产出最终交付物。
+      执行过程中：
+      1. 如果计划中提到使用某个 skill（如 pptx/pdf/docx），先用 Read 读取对应 skills/ 目录下的 SKILL.md 了解用法
+      2. 每完成一个主要步骤后简要汇报进度
+      3. 如果遇到计划中未预见的情况，自行判断合理方案并继续（不要中断等待）
+      4. 全部完成后用一两句话总结产出物位置和内容
+    allowed_tools: [Read, Write, Edit, Bash, Grep, Glob, WebSearch, WebFetch]
+    maxTurns: 40
+    onError: recover
+    capture:
+      content: execution_result
+
+  # ===================== Exit Summary（退出摘要）=====================
+  # [Exit Summary] 用 llm 产出一句话摘要，让用户知道"做了什么、产物在哪、如何继续"。
+  #   plan 工作流到此彻底结束，之后回到正常 TUI 对话模式。
+  - id: exit_summary
+    llm: |
+      用户的目标是「${inputs.goal}」。
+      计划已制定（PLAN.md）并执行完毕。
+      执行结果：${execution_result}
+
+      请用简洁中文写一段最终摘要（3-5句话），包含：
+      1. 完成了什么
+      2. 最终产物路径（文件名和目录）
+      3. 如有后续建议也简短提及
+
+      直接输出摘要正文，不要寒暄。
+    capture:
+      text: summary_text