@ai-setting/roy-agent-core 1.5.83 → 1.5.84

package/dist/env/event-source/index.js

@@ -4,7 +4,7 @@ import {
   builtInHandlers,
   getBuiltInHandler,
   larkCliHandler
-} from "../../shared/@ai-setting/roy-agent-core-67yzhmg2.js";
+} from "../../shared/@ai-setting/roy-agent-core-ya1ayt1k.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -15,7 +15,7 @@ import {
   validateEventSourceConfig
 } from "../../shared/@ai-setting/roy-agent-core-xb4hvk1m.js";
 import"../../shared/@ai-setting/roy-agent-core-v8xa6vs8.js";
-import"../../shared/@ai-setting/roy-agent-core-78yzt2bq.js";
+import"../../shared/@ai-setting/roy-agent-core-7fdzfsm6.js";
 import"../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import"../../shared/@ai-setting/roy-agent-core-92z6t4he.js";
 import"../../shared/@ai-setting/roy-agent-core-qxhq8ven.js";

package/dist/env/index.js

@@ -1,11 +1,11 @@
 import {
   BaseEnvironment
-} from "../shared/@ai-setting/roy-agent-core-68sef3es.js";
+} from "../shared/@ai-setting/roy-agent-core-29fh9mxg.js";
 import {
   EventSourceComponent,
   builtInHandlers,
   larkCliHandler
-} from "../shared/@ai-setting/roy-agent-core-67yzhmg2.js";
+} from "../shared/@ai-setting/roy-agent-core-ya1ayt1k.js";
 import {
   EventSourceInitHooks,
   getDefaultConfigForType,
@@ -17,11 +17,11 @@ import"../shared/@ai-setting/roy-agent-core-v8xa6vs8.js";
 import {
   PluginComponent
 } from "../shared/@ai-setting/roy-agent-core-t1ef8hf2.js";
-import"../shared/@ai-setting/roy-agent-core-78yzt2bq.js";
+import"../shared/@ai-setting/roy-agent-core-7fdzfsm6.js";
 import"../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import {
   WorkflowComponent
-} from "../shared/@ai-setting/roy-agent-core-v3t28k5n.js";
+} from "../shared/@ai-setting/roy-agent-core-bt7wezvg.js";
 import"../shared/@ai-setting/roy-agent-core-fjexv5nm.js";
 import"../shared/@ai-setting/roy-agent-core-6b0r2e7j.js";
 import"../shared/@ai-setting/roy-agent-core-m4qjnhz6.js";
@@ -29,11 +29,12 @@ import"../shared/@ai-setting/roy-agent-core-7z8fzxck.js";
 import"../shared/@ai-setting/roy-agent-core-6atd905e.js";
 import"../shared/@ai-setting/roy-agent-core-gb9gbkc3.js";
 import"../shared/@ai-setting/roy-agent-core-ddwa0n6h.js";
-import"../shared/@ai-setting/roy-agent-core-4t40mkpv.js";
+import"../shared/@ai-setting/roy-agent-core-hhrg314p.js";
 import"../shared/@ai-setting/roy-agent-core-j754zgb4.js";
 import"../shared/@ai-setting/roy-agent-core-qnrf2aw6.js";
-import"../shared/@ai-setting/roy-agent-core-a6j7g1qe.js";
+import"../shared/@ai-setting/roy-agent-core-r5axf0ad.js";
 import"../shared/@ai-setting/roy-agent-core-whw7jap0.js";
+import"../shared/@ai-setting/roy-agent-core-tq9528d3.js";
 import"../shared/@ai-setting/roy-agent-core-h0x19xgn.js";
 import"../shared/@ai-setting/roy-agent-core-1ce3fqrk.js";
 import {

package/dist/env/prompt/index.js

@@ -3,7 +3,7 @@ import {
   PromptConfigSchema,
   PromptPathSchema,
   PromptRenderer
-} from "../../shared/@ai-setting/roy-agent-core-vcvgq9hy.js";
+} from "../../shared/@ai-setting/roy-agent-core-akepggsr.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-qxhq8ven.js";
 import"../../shared/@ai-setting/roy-agent-core-rgckng3p.js";

package/dist/env/task/plugins/index.js

@@ -9,7 +9,7 @@ import {
   formatExtractorInput,
   formatExtractorInputFromDescription,
   parseExtractorOutput
-} from "../../../shared/@ai-setting/roy-agent-core-78yzt2bq.js";
+} from "../../../shared/@ai-setting/roy-agent-core-7fdzfsm6.js";
 import"../../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import"../../../shared/@ai-setting/roy-agent-core-92z6t4he.js";
 import"../../../shared/@ai-setting/roy-agent-core-qg4rma4c.js";

package/dist/env/workflow/index.js

@@ -1,6 +1,6 @@
 import {
   WorkflowComponent
-} from "../../shared/@ai-setting/roy-agent-core-v3t28k5n.js";
+} from "../../shared/@ai-setting/roy-agent-core-bt7wezvg.js";
 import"../../shared/@ai-setting/roy-agent-core-fjexv5nm.js";
 import"../../shared/@ai-setting/roy-agent-core-6b0r2e7j.js";
 import"../../shared/@ai-setting/roy-agent-core-m4qjnhz6.js";
@@ -8,7 +8,7 @@ import"../../shared/@ai-setting/roy-agent-core-7z8fzxck.js";
 import"../../shared/@ai-setting/roy-agent-core-6atd905e.js";
 import"../../shared/@ai-setting/roy-agent-core-gb9gbkc3.js";
 import"../../shared/@ai-setting/roy-agent-core-ddwa0n6h.js";
-import"../../shared/@ai-setting/roy-agent-core-4t40mkpv.js";
+import"../../shared/@ai-setting/roy-agent-core-hhrg314p.js";
 import"../../shared/@ai-setting/roy-agent-core-j754zgb4.js";
 import {
   BaseEventSchema,
@@ -61,8 +61,9 @@ import {
   pathNotFound,
   unresolvedVariable
 } from "../../shared/@ai-setting/roy-agent-core-qnrf2aw6.js";
-import"../../shared/@ai-setting/roy-agent-core-a6j7g1qe.js";
+import"../../shared/@ai-setting/roy-agent-core-r5axf0ad.js";
 import"../../shared/@ai-setting/roy-agent-core-whw7jap0.js";
+import"../../shared/@ai-setting/roy-agent-core-tq9528d3.js";
 import {
   Edge,
   NodeAs,

package/dist/env/workflow/service/index.js

@@ -1,9 +1,15 @@
 import {
-  WorkflowService,
   WorkflowServiceRegistry,
   getWorkflowService,
   registerWorkflowService
-} from "../../../shared/@ai-setting/roy-agent-core-4t40mkpv.js";
+} from "../../../shared/@ai-setting/roy-agent-core-hhrg314p.js";
+import {
+  WorkflowService
+} from "../../../shared/@ai-setting/roy-agent-core-tq9528d3.js";
+import"../../../shared/@ai-setting/roy-agent-core-k05v31rc.js";
+import"../../../shared/@ai-setting/roy-agent-core-shme7set.js";
+import"../../../shared/@ai-setting/roy-agent-core-7z9b1fm8.js";
+import"../../../shared/@ai-setting/roy-agent-core-c6592r3c.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {
   registerWorkflowService,

package/dist/env/workflow/storage/index.js

@@ -1,16 +1,19 @@
 import {
   WorkflowRepository,
-  rowToWorkflow
-} from "../../../shared/@ai-setting/roy-agent-core-496zzm5a.js";
-import {
   closeDatabase,
   getDatabase,
   getDatabasePath,
   initDatabase,
   initializeTables,
-  resetDatabase
-} from "../../../shared/@ai-setting/roy-agent-core-6b57g1zk.js";
+  migrateEmptyTagsToDefault,
+  resetDatabase,
+  rowToWorkflow
+} from "../../../shared/@ai-setting/roy-agent-core-h4h55x4h.js";
+import {
+  TagRepository
+} from "../../../shared/@ai-setting/roy-agent-core-3sv590cv.js";
 import"../../../shared/@ai-setting/roy-agent-core-rvxg1wps.js";
+import"../../../shared/@ai-setting/roy-agent-core-k05v31rc.js";
 import"../../../shared/@ai-setting/roy-agent-core-shme7set.js";
 import"../../../shared/@ai-setting/roy-agent-core-7z9b1fm8.js";
 import"../../../shared/@ai-setting/roy-agent-core-c6592r3c.js";
@@ -18,10 +21,12 @@ import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {
   rowToWorkflow,
   resetDatabase,
+  migrateEmptyTagsToDefault,
   initializeTables,
   initDatabase,
   getDatabasePath,
   getDatabase,
   closeDatabase,
-  WorkflowRepository
+  WorkflowRepository,
+  TagRepository
 };

package/dist/env/workflow/tools/index.js

@@ -1,22 +1,28 @@
 import {
   AskUserInputSchema,
   RunWorkflowInputSchema,
+  WorkflowAddInputSchema,
   WorkflowGetInputSchema,
   WorkflowListInputSchema,
   WorkflowRunStatusInputSchema,
   WorkflowRunStopInputSchema,
+  WorkflowSearchInputSchema,
+  WorkflowTagListInputSchema,
   askUserTool,
   askUserToolInstance,
   createLegacyRunWorkflowTool,
   createRunWorkflowTool,
+  createWorkflowAddTool,
   createWorkflowGetTool,
   createWorkflowListTool,
   createWorkflowRunStatusTool,
   createWorkflowRunStopTool,
+  createWorkflowSearchTool,
+  createWorkflowTagListTool,
   getRunWorkflowTool,
   initRunWorkflowTool,
   resetRunWorkflowTool
-} from "../../../shared/@ai-setting/roy-agent-core-a6j7g1qe.js";
+} from "../../../shared/@ai-setting/roy-agent-core-r5axf0ad.js";
 import {
   WORKFLOW_SUBMIT_OUTPUT_TOOL_NAME,
   WorkflowJsonOutputMarker,
@@ -24,7 +30,9 @@ import {
   init_submit_json_output_tool,
   parseWorkflowJsonOutput
 } from "../../../shared/@ai-setting/roy-agent-core-whw7jap0.js";
+import"../../../shared/@ai-setting/roy-agent-core-tq9528d3.js";
 import"../../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
+import"../../../shared/@ai-setting/roy-agent-core-k05v31rc.js";
 import"../../../shared/@ai-setting/roy-agent-core-shme7set.js";
 import"../../../shared/@ai-setting/roy-agent-core-7z9b1fm8.js";
 import"../../../shared/@ai-setting/roy-agent-core-c6592r3c.js";
@@ -37,20 +45,26 @@ export {
   parseWorkflowJsonOutput,
   initRunWorkflowTool,
   getRunWorkflowTool,
+  createWorkflowTagListTool,
+  createWorkflowSearchTool,
   createWorkflowRunStopTool,
   createWorkflowRunStatusTool,
   createWorkflowListTool,
   createWorkflowGetTool,
+  createWorkflowAddTool,
   createSubmitJsonOutputTool,
   createRunWorkflowTool,
   createLegacyRunWorkflowTool,
   askUserToolInstance,
   askUserTool,
+  WorkflowTagListInputSchema,
+  WorkflowSearchInputSchema,
   WorkflowRunStopInputSchema,
   WorkflowRunStatusInputSchema,
   WorkflowListInputSchema,
   WorkflowJsonOutputMarker,
   WorkflowGetInputSchema,
+  WorkflowAddInputSchema,
   WORKFLOW_SUBMIT_OUTPUT_TOOL_NAME,
   RunWorkflowInputSchema,
   AskUserInputSchema

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   PromptStore,
   getBuiltInPrompt,
   getBuiltInPromptNames
-} from "./shared/@ai-setting/roy-agent-core-vcvgq9hy.js";
+} from "./shared/@ai-setting/roy-agent-core-akepggsr.js";
 import {
   LLMComponent,
   LLMConfigSchema,
@@ -35,7 +35,8 @@ import {
 } from "./shared/@ai-setting/roy-agent-core-8pk6a00t.js";
 import {
   closeDatabase
-} from "./shared/@ai-setting/roy-agent-core-6b57g1zk.js";
+} from "./shared/@ai-setting/roy-agent-core-h4h55x4h.js";
+import"./shared/@ai-setting/roy-agent-core-3sv590cv.js";
 import"./shared/@ai-setting/roy-agent-core-2grcjaad.js";
 import {
   MemoryComponent
@@ -57,13 +58,13 @@ import {
   BaseEnvironment,
   generateDescendingId,
   generateId
-} from "./shared/@ai-setting/roy-agent-core-68sef3es.js";
+} from "./shared/@ai-setting/roy-agent-core-29fh9mxg.js";
 import {
   EventSourceComponent,
   builtInHandlers,
   getBuiltInHandler,
   larkCliHandler
-} from "./shared/@ai-setting/roy-agent-core-67yzhmg2.js";
+} from "./shared/@ai-setting/roy-agent-core-ya1ayt1k.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -83,13 +84,13 @@ import {
 import {
   TaskTagPlugin,
   createAutoTaskPlugin
-} from "./shared/@ai-setting/roy-agent-core-78yzt2bq.js";
+} from "./shared/@ai-setting/roy-agent-core-7fdzfsm6.js";
 import {
   BasePlugin
 } from "./shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import {
   WorkflowComponent
-} from "./shared/@ai-setting/roy-agent-core-v3t28k5n.js";
+} from "./shared/@ai-setting/roy-agent-core-bt7wezvg.js";
 import {
   init_node_registry_helper,
   registerDecoratorNodeType
@@ -100,11 +101,12 @@ import"./shared/@ai-setting/roy-agent-core-7z8fzxck.js";
 import"./shared/@ai-setting/roy-agent-core-6atd905e.js";
 import"./shared/@ai-setting/roy-agent-core-gb9gbkc3.js";
 import"./shared/@ai-setting/roy-agent-core-ddwa0n6h.js";
-import"./shared/@ai-setting/roy-agent-core-4t40mkpv.js";
+import"./shared/@ai-setting/roy-agent-core-hhrg314p.js";
 import"./shared/@ai-setting/roy-agent-core-j754zgb4.js";
 import"./shared/@ai-setting/roy-agent-core-qnrf2aw6.js";
-import"./shared/@ai-setting/roy-agent-core-a6j7g1qe.js";
+import"./shared/@ai-setting/roy-agent-core-r5axf0ad.js";
 import"./shared/@ai-setting/roy-agent-core-whw7jap0.js";
+import"./shared/@ai-setting/roy-agent-core-tq9528d3.js";
 import {
   Edge,
   NodeAs,

package/dist/shared/@ai-setting/{roy-agent-core-68sef3es.js → roy-agent-core-29fh9mxg.js}

@@ -1,6 +1,6 @@
 import {
   createAutoTaskPlugin
-} from "./roy-agent-core-78yzt2bq.js";
+} from "./roy-agent-core-7fdzfsm6.js";
 import {
   ContextError,
   ErrorCodes

package/dist/shared/@ai-setting/roy-agent-core-3sv590cv.js

@@ -0,0 +1,132 @@
+import {
+  TracedAs,
+  init_decorator
+} from "./roy-agent-core-k05v31rc.js";
+import {
+  __legacyDecorateClassTS
+} from "./roy-agent-core-fs0mn2jk.js";
+
+// src/env/workflow/storage/tag-repo.ts
+init_decorator();
+class TagRepository {
+  db;
+  constructor(db) {
+    this.db = db;
+  }
+  static createTable(db) {
+    db.exec(`
+      CREATE TABLE IF NOT EXISTS workflow_tags (
+        name TEXT PRIMARY KEY,
+        usage_count INTEGER NOT NULL DEFAULT 0,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+    `);
+    db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_workflow_tags_usage
+        ON workflow_tags(usage_count DESC);
+    `);
+  }
+  upsertMany(names) {
+    if (!names || names.length === 0)
+      return;
+    const insertStmt = this.db.prepare(`
+      INSERT INTO workflow_tags (name, usage_count, created_at, updated_at)
+      VALUES (?, 1, ?, ?)
+      ON CONFLICT(name) DO UPDATE SET
+        usage_count = usage_count + 1,
+        updated_at = excluded.updated_at
+    `);
+    const now = new Date().toISOString();
+    for (const name of names) {
+      const trimmed = (name ?? "").trim();
+      if (!trimmed)
+        continue;
+      insertStmt.run(trimmed, now, now);
+    }
+  }
+  decrementMany(names) {
+    if (!names || names.length === 0)
+      return;
+    const updateStmt = this.db.prepare(`
+      UPDATE workflow_tags
+         SET usage_count = MAX(0, usage_count - 1),
+             updated_at = ?
+       WHERE name = ?
+    `);
+    const now = new Date().toISOString();
+    for (const name of names) {
+      const trimmed = (name ?? "").trim();
+      if (!trimmed)
+        continue;
+      updateStmt.run(now, trimmed);
+    }
+  }
+  list(options = {}) {
+    const sortBy = options.sortBy ?? "usage_count";
+    const order = (options.order ?? "desc").toUpperCase();
+    const limit = options.limit ?? undefined;
+    let sortColumn;
+    switch (sortBy) {
+      case "name":
+        sortColumn = "name";
+        break;
+      case "created_at":
+        sortColumn = "created_at";
+        break;
+      case "usage_count":
+      default:
+        sortColumn = "usage_count";
+        break;
+    }
+    let sql = `SELECT name, usage_count, created_at, updated_at
+                 FROM workflow_tags
+                ORDER BY ${sortColumn} ${order}, name ASC`;
+    if (typeof limit === "number" && limit > 0) {
+      sql += ` LIMIT ${Math.floor(limit)}`;
+    }
+    const rows = this.db.prepare(sql).all();
+    return rows.map((r) => ({
+      name: r.name,
+      usage_count: r.usage_count,
+      created_at: r.created_at,
+      updated_at: r.updated_at
+    }));
+  }
+  get(name) {
+    const row = this.db.prepare(`SELECT name, usage_count, created_at, updated_at
+           FROM workflow_tags
+          WHERE name = ?`).get(name);
+    if (!row)
+      return;
+    return {
+      name: row.name,
+      usage_count: row.usage_count,
+      created_at: row.created_at,
+      updated_at: row.updated_at
+    };
+  }
+}
+__legacyDecorateClassTS([
+  TracedAs("workflow.tag_repo.upsertMany", {
+    recordParams: true,
+    recordResult: false,
+    log: false
+  })
+], TagRepository.prototype, "upsertMany", null);
+__legacyDecorateClassTS([
+  TracedAs("workflow.tag_repo.decrementMany", {
+    recordParams: true,
+    recordResult: false,
+    log: false
+  })
+], TagRepository.prototype, "decrementMany", null);
+__legacyDecorateClassTS([
+  TracedAs("workflow.tag_repo.list", {
+    recordParams: true,
+    recordResult: true,
+    log: false
+  })
+], TagRepository.prototype, "list", null);
+
+export { TagRepository };

package/dist/shared/@ai-setting/{roy-agent-core-78yzt2bq.js → roy-agent-core-7fdzfsm6.js}

@@ -369,11 +369,11 @@ ${prompt}`;
     }
     if (!this._workflowRepo) {
       try {
-        const sqlite = await import("./roy-agent-core-74cp3zp1.js");
+        const sqlite = await import("./roy-agent-core-taxvytzz.js");
         this.ensureDataDir();
         const db = sqlite.getDatabase();
         sqlite.initializeTables();
-        const { WorkflowRepository } = await import("./roy-agent-core-am646wfz.js");
+        const { WorkflowRepository } = await import("./roy-agent-core-86d4exyf.js");
         this._workflowRepo = new WorkflowRepository(db);
         return this._workflowRepo;
       } catch {

package/dist/shared/@ai-setting/{roy-agent-core-am646wfz.js → roy-agent-core-86d4exyf.js}

@@ -1,14 +1,17 @@
 import {
   WorkflowRepository,
+  migrateEmptyTagsToDefault,
   rowToWorkflow
-} from "./roy-agent-core-496zzm5a.js";
-import"./roy-agent-core-6b57g1zk.js";
+} from "./roy-agent-core-h4h55x4h.js";
+import"./roy-agent-core-3sv590cv.js";
 import"./roy-agent-core-rvxg1wps.js";
+import"./roy-agent-core-k05v31rc.js";
 import"./roy-agent-core-shme7set.js";
 import"./roy-agent-core-7z9b1fm8.js";
 import"./roy-agent-core-c6592r3c.js";
 import"./roy-agent-core-fs0mn2jk.js";
 export {
   rowToWorkflow,
+  migrateEmptyTagsToDefault,
   WorkflowRepository
 };

package/dist/shared/@ai-setting/{roy-agent-core-vcvgq9hy.js → roy-agent-core-akepggsr.js}

@@ -136,7 +136,8 @@ var builtInPrompts = {
 - **文件浏览 / 读取**：\`ls -la\`、\`cat file.txt\`、\`head -n 20 file.txt\`、\`tail -n 50 log.txt\`、\`grep "pattern" file.txt\`、\`find . -name "*.ts"\`
 - **状态查询**：\`pwd\`、\`date\`、\`whoami\`、\`which node\`、\`git status\`、\`git log -5\`、\`git diff\`
 - **简单测试 / 工具调用**：\`echo "hello"\`、\`node --version\`、\`bun --version\`
-- **调用一行 \`roy-agent\` 命令**（如 \`bun packages/cli/dist/bin/roy-agent.js tasks list\`）
+- **调用一行 \`roy-agent\` 命令**（如 \`bun packages/cli/dist/bin/roy-agent.js tasks list\`、\`roy-agent workflow list\`、\`roy-agent workflow tag list\`、\`roy-agent workflow search --keyword xxx\`）
+  - workflow 创建流程：\`roy-agent workflow add --name <name> --file <yaml> --tags "tag1,tag2"\`，创建前可用 \`roy-agent workflow validate --file <yaml>\` 验证 YAML 语法
 
 **\`bash\` 适合 vs 需要委托的边界：**
 - ✅ \`ls -la\`、\`cat file.txt\`、\`grep "TODO" src/*.ts\`、\`git status\`、\`find . -name "*.ts"\` — **直接用 \`bash\` 执行**
@@ -245,6 +246,21 @@ delegate_task(
 4. **搜索相似任务并委托** — 在委托前，先使用 \`task_search\` 搜索与当前请求相关的历史任务，将找到的相似任务 ID 填入 \`similar_task_ids\` 参数。在给子智能体的提示词中，始终包含简要指令，要求将工作视为任务一等公民：创建任务（\`task_create\`）、跟踪进度并完成。
 5. **汇报结果** — 向用户总结结果
 
+## Workflow 创建指南
+
+当收到用户请求**创建/注册 Workflow** 时，必须遵循以下标准流程：
+
+### 流程
+1. **先查 tag 池** — 调用 \`bash\` 执行 \`roy-agent workflow tag list\` 查看现有 tag，选择语义最匹配的 1-3 个 tag
+2. **验证 YAML** — 调用 \`bash\` 执行 \`roy-agent workflow validate --file <yaml路径>\` 验证 Workflow 定义语法
+3. **注册 Workflow** — 确认验证通过后，用 \`roy-agent workflow add --name <name> --file <yaml> --tags "tag1,tag2"\` 注册
+4. **核实结果** — 用 \`roy-agent workflow get <name>\` 或 \`roy-agent workflow list --tag <tag>\` 确认注册成功
+
+### Tag 选择原则
+- **必选已有 tag**：优先从 \`workflow tag list\` 显示的已有 tag 池中选语义最相似的
+- **新增 tag**：池中确实没有合适 tag 时才新增，以扩展 tag 池
+- **避免膨胀**：已有 \`ci-cd\` 时不新增 \`continuous-integration\`，已有 \`build-publish\` 时不新增 \`release-deploy\`
+
 ## 行为规则
 
 1. **复杂任务必须委托** — 不要尝试自己解决复杂任务。使用 \`delegate_task\` 委托给子智能体。
@@ -287,6 +303,37 @@ delegate_task(
 - 遇到阻塞：尝试绕过或选替代方案，无法绕过的暂停任务等用户回来
 - 任务完成：记录完整结果，用户回来时统一汇报
 
+
+## Workflow 操作指南
+
+Workflow 是预定义的自动化流程，可以高效解决常见类型的任务。在接手一个复杂任务时，**建议先用 workflow 检索看看有没有现成的解决方案**。
+
+### 如何用 workflow 辅助解决任务
+1. **查 tag 发现可用 workflow**：\`workflow tag list\` — 查看 tag 池，找与任务领域匹配的 tag
+2. **按 tag 搜索 workflow**：\`workflow list --tag <tag>\` — 找到相关的 workflow
+3. **按关键词搜索**：\`workflow search --keyword <key>\` — 用关键词匹配
+4. **查看详情**：\`workflow get <name>\` — 了解 workflow 的输入参数和节点流程
+5. **运行 workflow**：\`workflow run <name> --input '{"key":"value"}'\` — 直接执行
+
+> \uD83D\uDCA1 **什么时候该用 workflow？**
+> - ✅ 你的任务与现有 workflow 的 tag 或描述高度匹配时 → 优先用 \`workflow run\`
+> - ✅ 现有 workflow 可以作为参考模板 → 参考其设计自行实现
+> - ❌ 找不到匹配的 workflow → **用传统方式解决**（委托子智能体、直接编码等）
+
+### 可用命令速查
+- \`workflow tag list\` — 查看所有 tag
+- \`workflow list --tag <tag>\` — 按 tag 搜索
+- \`workflow search --keyword <key>\` — 按关键词搜索
+- \`workflow get <name>\` — 查看详情
+- \`workflow run <name>\` — 执行 workflow（如果已找到匹配的）
+- \`workflow add --file <path> --tags "a,b,c"\` — 添加新 workflow
+- \`workflow validate --file <path>\` — 验证 workflow 定义
+
+### ⚠️ 重要原则
+- **Workflow 是辅助手段，不是目的**。如果能找到现成 workflow 就使用它；如果找不到或效果不好，**用非 workflow 方式解决**也是完全正确的
+- **不要为了用 workflow 而用**，强行创建一个不合适的 workflow 来套用任务不如直接用传统方式解决
+- **委托子智能体时**：如果认为有 workflow 可能帮助子智能体，可以在 prompt 中提示子智能体先查询 tag 池搜索可用 workflow
+
 ### {{memory}}`,
   roy: `You are Roy, a versatile AI assistant inspired by Jarvis - intelligent, proactive, and capable.
 
@@ -337,6 +384,13 @@ roy-agent <command>
 | Command | Description |
 |---------|-------------|
 | \`roy-agent workflow\` | Workflow DAG management and execution |
+| \`roy-agent workflow list\` | List workflows (paginated, supports --tag/--search/--limit/--page) |
+| \`roy-agent workflow get <name>\` | Get workflow definition details |
+| \`roy-agent workflow add\` | Add new workflow (requires --name --file --tags 1-3) |
+| \`roy-agent workflow validate --file <yaml>\` | Validate workflow YAML definition syntax |
+| \`roy-agent workflow tag list\` | List all available tags with usage counts |
+| \`roy-agent workflow tag get <name>\` | Get tag details by name |
+| \`roy-agent workflow search --keyword\` | Search workflows by keyword and/or tags |
 | \`roy-agent eventsource\` / \`roy-agent es\` | Event source management (lark-cli, timer, websocket) |
 | \`roy-agent mcp\` | MCP (Model Context Protocol) server management |
 | \`roy-agent config\` / \`roy-agent cfg\` | Configuration management |
@@ -420,12 +474,55 @@ roy-agent commands list|add|remove|info|dirs
 #### Workflow Command
 
 \`\`\`bash
-roy-agent workflow list|add|nodes|get|update|remove|run|pause|resume|stop|status
+roy-agent workflow list|add|search|get|tag|validate|update|remove|run|pause|resume|stop|status|nodes
 \`\`\`
 
-- \`roy-agent workflow run <name>\` - Run a workflow
-- \`roy-agent workflow status <run-id>\` - Check run status
-- \`roy-agent workflow pause|resume|stop <run-id>\` - Control workflow execution
+**Subcommands**:
+
+| Subcommand | Description |
+|------------|-------------|
+| \`workflow list [--tag] [--search] [--limit N] [--offset N] [--page N]\` | List workflows with pagination (default limit=50). Filter by tag (single or AND multiple). Shows total count + page info + available_tags. |
+| \`workflow add --file <path> --tags "a,b,c"\` | Add a new workflow from YAML/JSON file. ⚠️ **Tags (1-3) required**. See tag guidance below. |
+| \`workflow search --keyword <key>\` | Search workflows by keyword. |
+| \`workflow get <name>\` | Get workflow definition details. |
+| \`workflow tag list [--sort-by name/usage_count/created_at] [--order desc/asc]\` | List all available tags with usage_count. \`\`\` |
+| \`workflow validate --file <path>\` | Validate a workflow YAML/JSON before adding. Always run this BEFORE \`workflow add\`. |
+| \`workflow run <name> [--input JSON] [--sync/--async]\` | Run a workflow. |
+| \`workflow status <run-id>\` | Check workflow run status. |
+| \`workflow pause/resume/stop <run-id>\` | Control workflow execution. |
+| \`workflow update <id> [--tags] [--description]\` | Update workflow metadata. |
+| \`workflow remove <name>\` | Remove a workflow. |
+
+**\uD83C\uDFAF Tag Selection Guidance (IMPORTANT)**:
+When adding a workflow via \`workflow add\` or delegating to a sub-agent:
+1. **Always** check existing tags first: \`roy-agent workflow tag list\`
+2. **Prefer reusing** existing tags over creating new ones — this keeps the tag pool compact and semantic
+3. **Only create new tags** when no existing tag matches the workflow's purpose
+4. **Example**: For a CI/CD workflow, use existing \`ci-cd\` or \`build-publish\` tags, NOT \`continuous-integration\`
+
+**✅ Validation Before Add (REQUIRED)**:
+Before calling \`workflow add\`, always run \`workflow validate --file <path>\` to:
+- Check YAML/JSON syntax
+- Verify node references and dependency graph (DAG)
+- Confirm the workflow will load correctly
+Only proceed to \`workflow add\` after validation passes.
+
+
+### \uD83D\uDCA1 Using Workflows to Solve Tasks
+
+Workflows are pre-built automation pipelines. When tackling a complex task, **consider checking if an existing workflow can help**:
+
+1. **Discover**: \`roy-agent workflow tag list\` — see the tag pool; \`roy-agent workflow list --tag <tag>\` — find workflows by tag
+2. **Search**: \`roy-agent workflow search --keyword <key>\` — search by keyword
+3. **Inspect**: \`roy-agent workflow get <name>\` — examine inputs and structure
+4. **Run**: \`roy-agent workflow run <name> --input '{"key":"value"}'\` — execute
+
+> **When to use workflows:**
+> - ✅ Task matches an existing workflow's tag/description → prefer \`workflow run\`
+> - ✅ Existing workflow serves as a reference → borrow its design
+> - ❌ No matching workflow found → **solve it manually** (delegate sub-agent, direct coding, etc.)
+
+**Key principle**: Workflows are here to help, not restrict. If no workflow fits, **do NOT force it** — just solve the task directly. This is the correct approach.
 
 #### EventSource Command