agency-orchestrator 0.3.0 → 0.3.1

package/README.md

@@ -160,7 +160,7 @@ analyze ──→ tech_review  ──→ summary
   condition: "{{job_type}} contains technical"
 
 - id: biz_path
-  role: "marketing/marketing-strategist"
+  role: "marketing/marketing-social-media-strategist"
   task: "Business evaluation: {{requirements}}"
   depends_on: [classify]
   condition: "{{job_type}} contains business"
@@ -176,12 +176,12 @@ Supported operators: `contains`, `equals`, `not_contains`, `not_equals`.
 
 ```yaml
 - id: write_draft
-  role: "content/content-creator"
+  role: "marketing/marketing-content-creator"
   task: "Write article: {{topic}}"
   output: draft
 
 - id: brand_review
-  role: "marketing/brand-guardian"
+  role: "design/design-brand-guardian"
   task: "Review brand compliance: {{draft}}"
   output: review_result
   depends_on: [write_draft]

package/dist/cli/explain.js

@@ -34,7 +34,7 @@ function buildLayers(steps) {
             remaining.delete(s.id);
             for (const [id, depList] of deps) {
                 if (depList.includes(s.id)) {
-                    inDegree.set(id, (inDegree.get(id) || 1) - 1);
+                    inDegree.set(id, (inDegree.get(id) ?? 0) - 1);
                 }
             }
         }
@@ -77,10 +77,12 @@ export function explainWorkflow(workflow) {
         for (const step of layer.steps) {
             const role = formatRole(step.role);
             // 取 task 的第一行作为摘要
-            const taskSummary = (step.task || '').split('\n')[0].trim().slice(0, 60);
+            const firstLine = (step.task || '').split('\n')[0].trim();
+            const taskSummary = firstLine.slice(0, 60);
+            const truncated = firstLine.length > 60 || (step.task || '').includes('\n');
             lines.push(`  • ${step.id} (${role})`);
             if (taskSummary) {
-                lines.push(`    ${taskSummary}${(step.task || '').length > 60 ? '...' : ''}`);
+                lines.push(`    ${taskSummary}${truncated ? '...' : ''}`);
             }
             // 标注条件
             if (step.condition) {
@@ -96,7 +98,7 @@ export function explainWorkflow(workflow) {
     }
     // 汇总
     const totalSteps = workflow.steps.length;
-    const maxParallel = Math.max(...layers.map(l => l.steps.length));
+    const maxParallel = layers.length > 0 ? Math.max(...layers.map(l => l.steps.length)) : 0;
     const hasLoop = workflow.steps.some(s => s.loop);
     const hasCondition = workflow.steps.some(s => s.condition);
     lines.push(`总计 ${totalSteps} 个步骤，${layers.length} 层执行，最大并行度 ${maxParallel}。`);

package/dist/cli/init-workflow.js

@@ -4,10 +4,14 @@
 import { createInterface } from 'readline';
 import { writeFileSync, mkdirSync, existsSync } from 'fs';
 import { resolve } from 'path';
+/** Escape double quotes for YAML string values */
+function yamlEscape(s) {
+    return s.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
 export function generateWorkflowYaml(opts) {
     const lines = [
-        `name: "${opts.name}"`,
-        `description: "${opts.description}"`,
+        `name: "${yamlEscape(opts.name)}"`,
+        `description: "${yamlEscape(opts.description)}"`,
         '',
         'agents_dir: "agency-agents-zh"',
         '',
@@ -21,22 +25,27 @@ export function generateWorkflowYaml(opts) {
     if (opts.hasInputs && opts.inputs.length > 0) {
         lines.push('', 'inputs:');
         for (const input of opts.inputs) {
-            lines.push(`  - name: ${input.name}`);
-            lines.push(`    description: "${input.description}"`);
+            lines.push(`  - name: "${yamlEscape(input.name)}"`);
+            lines.push(`    description: "${yamlEscape(input.description)}"`);
             lines.push(`    required: ${input.required}`);
         }
     }
     lines.push('', 'steps:');
     for (let i = 0; i < opts.roles.length; i++) {
         const step = opts.roles[i];
-        lines.push(`  - id: ${step.id}`);
-        lines.push(`    role: "${step.role}"`);
-        lines.push(`    task: |`);
-        // Indent task lines for YAML block scalar
-        for (const taskLine of step.task.split('\n')) {
-            lines.push(`      ${taskLine}`);
+        lines.push(`  - id: "${yamlEscape(step.id)}"`);
+        lines.push(`    role: "${yamlEscape(step.role)}"`);
+        // 单行 task 用引号，多行用 block scalar
+        if (step.task.includes('\n')) {
+            lines.push(`    task: |`);
+            for (const taskLine of step.task.split('\n')) {
+                lines.push(`      ${taskLine}`);
+            }
+        }
+        else {
+            lines.push(`    task: "${yamlEscape(step.task)}"`);
         }
-        lines.push(`    output: ${step.output}`);
+        lines.push(`    output: "${yamlEscape(step.output)}"`);
         if (i > 0) {
             lines.push(`    depends_on: [${opts.roles[i - 1].id}]`);
         }

package/dist/cli/watch.js

@@ -6,7 +6,7 @@ const ICONS = {
     running: '🔄',
     done: '✅',
     error: '❌',
-    skipped: '⏭️',
+    skipped: '⏩',
 };
 /**
  * 创建 watch 渲染器，返回 ProgressCallback
@@ -50,7 +50,9 @@ export function createWatchRenderer(workflowName, stepIds, roles) {
             lines.push(line);
         }
         lines.push(`│${''.padEnd(boxWidth - 2)}│`);
-        lines.push(`│ Progress: ${bar} ${completed}/${total}  ${elapsed}s${''.padEnd(Math.max(0, boxWidth - 38 - elapsed.length))}│`);
+        const progressContent = `Progress: ${bar} ${completed}/${total}  ${elapsed}s`;
+        const progressPad = Math.max(0, boxWidth - 4 - progressContent.length);
+        lines.push(`│ ${progressContent}${''.padEnd(progressPad)} │`);
         lines.push(`└${'─'.repeat(boxWidth - 2)}┘`);
         // 写到 stderr 避免与正常输出混合
         for (const line of lines) {

package/dist/cli.js

@@ -47,7 +47,7 @@ async function main() {
             break;
         default: {
             // 容错：用户可能漏了空格，如 "planworkflows/x.yaml"
-            const knownCmds = ['run', 'validate', 'plan', 'explain', 'roles'];
+            const knownCmds = ['run', 'validate', 'plan', 'explain', 'roles', 'init'];
             const match = knownCmds.find(c => command.startsWith(c) && command.length > c.length);
             if (match) {
                 console.error(`看起来少了个空格？试试:\n  ao ${match} ${command.slice(match.length)}\n`);

package/integrations/antigravity/README.md

@@ -5,18 +5,25 @@
 ## 安装
 
 ```bash
-# 1. 安装角色定义
+# 1. 下载 186 个 AI 角色
 cd your-project
 git clone --depth 1 https://github.com/jnMetaCode/agency-agents-zh.git
 
-# 2. 将 AGENTS.md 复制到项目根目录
-cp integrations/antigravity/AGENTS.md AGENTS.md
+# 2. 下载工作流模板和技能文件
+git clone --depth 1 https://github.com/jnMetaCode/agency-orchestrator.git .ao-tmp
+cp -r .ao-tmp/workflows ./workflows
+cp .ao-tmp/integrations/antigravity/AGENTS.md ./AGENTS.md
+rm -rf .ao-tmp
+
+# 3. 开始使用
+# 在 Antigravity 中直接说：运行 workflows/story-creation.yaml
 ```
 
-如果项目根目录已有 `AGENTS.md`，将内容追加：
+如果项目根目录已有 `AGENTS.md`，可将内容追加而非覆盖：
 
 ```bash
-cat integrations/antigravity/AGENTS.md >> AGENTS.md
+# 替换上面第 2 步中的 cp 命令为：
+cat .ao-tmp/integrations/antigravity/AGENTS.md >> ./AGENTS.md
 ```
 
 ## 使用方式

package/integrations/codex/README.md

@@ -5,19 +5,26 @@
 ## 安装
 
 ```bash
-# 1. 安装角色定义
+# 1. 下载 186 个 AI 角色
 cd your-project
 git clone --depth 1 https://github.com/jnMetaCode/agency-agents-zh.git
 
-# 2. 复制 workflow-runner 指令到 .codex 目录
+# 2. 下载工作流模板和技能文件
+git clone --depth 1 https://github.com/jnMetaCode/agency-orchestrator.git .ao-tmp
+cp -r .ao-tmp/workflows ./workflows
 mkdir -p .codex
-cp integrations/codex/instructions.md .codex/instructions.md
+cp .ao-tmp/integrations/codex/instructions.md .codex/instructions.md
+rm -rf .ao-tmp
+
+# 3. 开始使用
+# 在 Codex CLI 中直接说：运行 workflows/story-creation.yaml
 ```
 
-如果 `.codex/instructions.md` 已存在，将内容追加：
+如果 `.codex/instructions.md` 已存在，可将内容追加而非覆盖：
 
 ```bash
-cat integrations/codex/instructions.md >> .codex/instructions.md
+# 替换上面第 2 步中的 cp 命令为：
+cat .ao-tmp/integrations/codex/instructions.md >> .codex/instructions.md
 ```
 
 ## 使用方式

package/integrations/cursor/README.md

@@ -5,16 +5,19 @@
 ## 安装
 
 ```bash
-# 1. 安装角色定义到项目
+# 1. 下载 186 个 AI 角色
 cd your-project
 git clone --depth 1 https://github.com/jnMetaCode/agency-agents-zh.git
 
-# 2. 复制工作流模板
-git clone --depth 1 https://github.com/jnMetaCode/agency-orchestrator.git .ao-tmp && cp -r .ao-tmp/workflows ./workflows && rm -rf .ao-tmp
-
-# 3. 添加工作流执行规则
+# 2. 下载工作流模板和技能文件
+git clone --depth 1 https://github.com/jnMetaCode/agency-orchestrator.git .ao-tmp
+cp -r .ao-tmp/workflows ./workflows
 mkdir -p .cursor/rules
-cp agency-orchestrator/integrations/cursor/workflow-runner.mdc .cursor/rules/
+cp .ao-tmp/integrations/cursor/workflow-runner.mdc .cursor/rules/
+rm -rf .ao-tmp
+
+# 3. 开始使用
+# 在 Cursor 中直接说：运行 workflows/story-creation.yaml
 ```
 
 ## 使用方式
@@ -87,11 +90,11 @@ ao run workflows/story-creation.yaml -i 'premise=时间旅行'
 
 ## 可用工作流
 
-| 工作流 | 说明 | 角色 |
+| 工作流 | 文件 | 说明 |
 |--------|------|------|
-| `story-creation.yaml` | 短篇小说创作 | 叙事学家 → 心理学家 + 叙事设计师 → 内容创作者 |
-| `product-review.yaml` | 产品需求评审 | 产品经理 → 架构师 + UX 研究员 → 产品经理 |
-| `content-pipeline.yaml` | 内容创作流水线 | 策略师 → 创作者 + SEO → 编辑 |
+| 短篇小说创作 | `story-creation.yaml` | 叙事学家 → 心理学家 + 叙事设计师 → 内容创作者 |
+| 产品需求评审 | `product-review.yaml` | 产品经理 → 架构师 + UX 研究员 → 产品经理 |
+| 内容流水线 | `content-pipeline.yaml` | 策略师 → 创作者 + SEO → 编辑 |
 
 ## 自定义
 

package/integrations/deerflow/README.md

@@ -5,13 +5,19 @@
 ## 安装
 
 ```bash
-# 1. 安装角色定义
+# 1. 下载 186 个 AI 角色
 cd your-project
 git clone --depth 1 https://github.com/jnMetaCode/agency-agents-zh.git
 
-# 2. 将 SKILL.md 复制到 DeerFlow 的自定义技能目录
+# 2. 下载工作流模板和技能文件
+git clone --depth 1 https://github.com/jnMetaCode/agency-orchestrator.git .ao-tmp
+cp -r .ao-tmp/workflows ./workflows
 mkdir -p skills/custom/ao-workflow-runner
-cp integrations/deerflow/SKILL.md skills/custom/ao-workflow-runner/SKILL.md
+cp .ao-tmp/integrations/deerflow/SKILL.md skills/custom/ao-workflow-runner/SKILL.md
+rm -rf .ao-tmp
+
+# 3. 开始使用
+# 在 DeerFlow 中直接说：运行 workflows/story-creation.yaml
 ```
 
 ## 使用方式

package/integrations/gemini-cli/README.md

@@ -5,18 +5,25 @@
 ## 安装
 
 ```bash
-# 1. 安装角色定义
+# 1. 下载 186 个 AI 角色
 cd your-project
 git clone --depth 1 https://github.com/jnMetaCode/agency-agents-zh.git
 
-# 2. 将 workflow-runner 指令追加到项目根目录的 GEMINI.md
-cat integrations/gemini-cli/GEMINI.md >> GEMINI.md
+# 2. 下载工作流模板和技能文件
+git clone --depth 1 https://github.com/jnMetaCode/agency-orchestrator.git .ao-tmp
+cp -r .ao-tmp/workflows ./workflows
+cp .ao-tmp/integrations/gemini-cli/GEMINI.md ./GEMINI.md
+rm -rf .ao-tmp
+
+# 3. 开始使用
+# 在 Gemini CLI 中直接说：运行 workflows/story-creation.yaml
 ```
 
-如果项目根目录还没有 `GEMINI.md`，直接复制即可：
+如果项目根目录已有 `GEMINI.md`，可将内容追加而非覆盖：
 
 ```bash
-cp integrations/gemini-cli/GEMINI.md GEMINI.md
+# 替换上面第 2 步中的 cp 命令为：
+cat .ao-tmp/integrations/gemini-cli/GEMINI.md >> ./GEMINI.md
 ```
 
 ## 使用方式

package/integrations/kiro/README.md

@@ -5,16 +5,19 @@
 ## 安装
 
 ```bash
-# 1. 安装角色定义到项目
+# 1. 下载 186 个 AI 角色
 cd your-project
 git clone --depth 1 https://github.com/jnMetaCode/agency-agents-zh.git
 
-# 2. 复制工作流模板
-git clone --depth 1 https://github.com/jnMetaCode/agency-orchestrator.git .ao-tmp && cp -r .ao-tmp/workflows ./workflows && rm -rf .ao-tmp
-
-# 3. 添加工作流执行规则
+# 2. 下载工作流模板和技能文件
+git clone --depth 1 https://github.com/jnMetaCode/agency-orchestrator.git .ao-tmp
+cp -r .ao-tmp/workflows ./workflows
 mkdir -p .kiro/steering
-cp agency-orchestrator/integrations/kiro/ao-workflow-runner.md .kiro/steering/
+cp .ao-tmp/integrations/kiro/ao-workflow-runner.md .kiro/steering/
+rm -rf .ao-tmp
+
+# 3. 开始使用
+# 在 Kiro 中直接说：运行 workflows/story-creation.yaml
 ```
 
 ## 使用方式

package/integrations/trae/README.md

@@ -5,16 +5,19 @@
 ## 安装
 
 ```bash
-# 1. 安装角色定义到项目
+# 1. 下载 186 个 AI 角色
 cd your-project
 git clone --depth 1 https://github.com/jnMetaCode/agency-agents-zh.git
 
-# 2. 复制工作流模板
-git clone --depth 1 https://github.com/jnMetaCode/agency-orchestrator.git .ao-tmp && cp -r .ao-tmp/workflows ./workflows && rm -rf .ao-tmp
-
-# 3. 添加工作流执行规则
+# 2. 下载工作流模板和技能文件
+git clone --depth 1 https://github.com/jnMetaCode/agency-orchestrator.git .ao-tmp
+cp -r .ao-tmp/workflows ./workflows
 mkdir -p .trae/rules
-cp agency-orchestrator/integrations/trae/ao-workflow-runner.md .trae/rules/
+cp .ao-tmp/integrations/trae/ao-workflow-runner.md .trae/rules/
+rm -rf .ao-tmp
+
+# 3. 开始使用
+# 在 Trae 中直接说：运行 workflows/story-creation.yaml
 ```
 
 ## 使用方式

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agency-orchestrator",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Multi-agent workflow orchestrator — 186 ready-to-use AI roles, YAML-defined pipelines, auto DAG parallelism, zero code required",
   "keywords": [
     "multi-agent",