agency-orchestrator 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,91 @@
+/** 工作流 YAML 定义的类型 */
+export interface WorkflowDefinition {
+    name: string;
+    description?: string;
+    agents_dir: string;
+    llm: LLMConfig;
+    concurrency?: number;
+    inputs?: InputDefinition[];
+    steps: StepDefinition[];
+}
+export interface LLMConfig {
+    provider: 'claude' | 'openai' | 'ollama' | 'deepseek';
+    base_url?: string;
+    api_key?: string;
+    model: string;
+    max_tokens?: number;
+    timeout?: number;
+    retry?: number;
+}
+export interface InputDefinition {
+    name: string;
+    description?: string;
+    required?: boolean;
+    default?: string;
+}
+export interface StepDefinition {
+    id: string;
+    role: string;
+    task: string;
+    output?: string;
+    depends_on?: string[];
+    type?: 'normal' | 'approval';
+    prompt?: string;
+}
+/** DAG 执行相关类型 */
+export interface DAGNode {
+    step: StepDefinition;
+    dependencies: string[];
+    dependents: string[];
+    status: 'pending' | 'running' | 'completed' | 'failed' | 'skipped';
+    result?: string;
+    error?: string;
+    startTime?: number;
+    endTime?: number;
+    tokenUsage?: {
+        input: number;
+        output: number;
+    };
+}
+/** LLM Connector 相关类型 */
+export interface LLMResult {
+    content: string;
+    usage: {
+        input_tokens: number;
+        output_tokens: number;
+    };
+}
+export interface LLMConnector {
+    chat(systemPrompt: string, userMessage: string, config: LLMConfig): Promise<LLMResult>;
+}
+/** Agent Loader 相关类型 */
+export interface AgentDefinition {
+    name: string;
+    description: string;
+    emoji?: string;
+    tools?: string;
+    systemPrompt: string;
+}
+/** 执行结果 */
+export interface WorkflowResult {
+    name: string;
+    success: boolean;
+    steps: StepResult[];
+    totalDuration: number;
+    totalTokens: {
+        input: number;
+        output: number;
+    };
+}
+export interface StepResult {
+    id: string;
+    role: string;
+    status: 'completed' | 'failed' | 'skipped';
+    output?: string;
+    error?: string;
+    duration: number;
+    tokens: {
+        input: number;
+        output: number;
+    };
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+/** 工作流 YAML 定义的类型 */
+export {};

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "agency-orchestrator",
+  "version": "0.1.0",
+  "description": "基于 agency-agents 角色定义的轻量多智能体编排引擎 — 用 YAML 定义工作流，自动调度 AI 角色协作完成复杂任务",
+  "keywords": [
+    "agency-agents",
+    "multi-agent",
+    "orchestrator",
+    "workflow",
+    "ai-agents",
+    "llm",
+    "claude",
+    "deepseek",
+    "ollama",
+    "openai",
+    "yaml-workflow",
+    "agent-orchestration",
+    "chinese-ai",
+    "dag",
+    "crewai-alternative"
+  ],
+  "author": "jnMetaCode",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/jnMetaCode/agency-orchestrator#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jnMetaCode/agency-orchestrator"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "agency-orchestrator": "dist/cli.js",
+    "ao": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "npx tsx test/run.ts && npx tsx test/e2e.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist/",
+    "workflows/",
+    "LICENSE",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.52.0",
+    "js-yaml": "^4.1.0"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  }
+}

package/workflows/content-pipeline.yaml

@@ -0,0 +1,83 @@
+name: "内容创作流水线"
+description: "从主题到成稿的完整内容创作流程 — 研究、写作、品牌审核"
+
+agents_dir: "agency-agents-zh"
+
+llm:
+  provider: "claude"
+  model: "claude-sonnet-4-6"
+  max_tokens: 4096
+
+concurrency: 2
+
+inputs:
+  - name: topic
+    description: "内容主题"
+    required: true
+  - name: target_audience
+    description: "目标受众"
+    required: true
+  - name: platform
+    description: "发布平台（如：公众号、知乎、小红书）"
+    required: true
+
+steps:
+  - id: research
+    role: "marketing/marketing-social-media-strategist"
+    task: |
+      为以下主题做内容研究：
+      主题：{{topic}}
+      目标受众：{{target_audience}}
+      平台：{{platform}}
+
+      请输出：
+      1. 关键信息点
+      2. 受众关注的痛点
+      3. 竞品内容分析
+      4. 建议的内容角度
+    output: research_report
+
+  - id: draft
+    role: "marketing/marketing-content-creator"
+    task: |
+      基于以下研究，撰写一篇适合 {{platform}} 的文章：
+
+      研究报告：
+      {{research_report}}
+
+      要求：
+      - 目标受众：{{target_audience}}
+      - 风格适合 {{platform}}
+      - 包含引人注目的标题
+      - 结构清晰，易于阅读
+    output: draft_content
+    depends_on: [research]
+
+  - id: brand_review
+    role: "marketing/marketing-growth-hacker"
+    task: |
+      请审核以下内容的品牌一致性：
+
+      {{draft_content}}
+
+      评审要点：
+      1. 品牌调性是否一致
+      2. 信息准确性
+      3. 是否有敏感内容
+      4. 改进建议
+    output: review_feedback
+    depends_on: [draft]
+
+  - id: final_edit
+    role: "marketing/marketing-content-creator"
+    task: |
+      根据品牌审核反馈，修改并定稿：
+
+      原文：
+      {{draft_content}}
+
+      审核反馈：
+      {{review_feedback}}
+
+      请输出最终稿件。
+    depends_on: [brand_review]

package/workflows/product-review.yaml

@@ -0,0 +1,77 @@
+name: "产品需求评审"
+description: "多角色协作评审 PRD 文档 — 产品经理分析需求，架构师评估技术，设计师评估体验，最后汇总结论"
+
+agents_dir: "agency-agents-zh"
+
+llm:
+  provider: "claude"
+  model: "claude-sonnet-4-6"
+  max_tokens: 4096
+  timeout: 120000
+  retry: 3
+
+concurrency: 2
+
+inputs:
+  - name: prd_content
+    description: "PRD 文档内容"
+    required: true
+
+steps:
+  - id: analyze
+    role: "product/product-manager"
+    task: |
+      请分析以下 PRD 文档，提取：
+      1. 核心需求（按优先级排列）
+      2. 目标用户画像
+      3. 潜在风险和不确定性
+      4. 关键成功指标
+
+      PRD 内容：
+      {{prd_content}}
+    output: requirements
+
+  - id: tech_review
+    role: "engineering/engineering-software-architect"
+    task: |
+      基于以下需求分析，请评估：
+      1. 技术可行性（高/中/低）
+      2. 推荐技术架构
+      3. 预估开发复杂度
+      4. 技术风险点
+
+      需求分析：
+      {{requirements}}
+    output: tech_report
+    depends_on: [analyze]
+
+  - id: design_review
+    role: "design/design-ux-researcher"
+    task: |
+      基于以下需求分析，请评估：
+      1. 用户体验风险
+      2. 可用性问题
+      3. 设计建议
+      4. 需要进一步验证的假设
+
+      需求分析：
+      {{requirements}}
+    output: design_report
+    depends_on: [analyze]
+
+  - id: final_summary
+    role: "product/product-manager"
+    task: |
+      综合以下技术和设计两方面的反馈，输出最终评审结论：
+
+      ## 技术评估
+      {{tech_report}}
+
+      ## 设计评估
+      {{design_report}}
+
+      请输出：
+      1. 总体结论（通过/需修改/不通过）
+      2. 必须解决的问题清单
+      3. 建议的下一步行动
+    depends_on: [tech_review, design_review]

package/workflows/story-creation.yaml

@@ -0,0 +1,102 @@
+name: "短篇小说创作"
+description: "从创意到成稿：叙事学家设计结构 → 心理学家塑造人物 + 叙事设计师构建冲突 → 内容创作者执笔成稿"
+
+agents_dir: "agency-agents-zh"
+
+llm:
+  provider: "deepseek"
+  model: "deepseek-chat"
+  max_tokens: 2048
+  timeout: 180000
+  retry: 2
+
+concurrency: 2
+
+inputs:
+  - name: premise
+    description: "故事创意/主题/一句话梗概"
+    required: true
+  - name: style
+    description: "风格偏好（如：悬疑、温情、荒诞、科幻）"
+    required: false
+    default: "悬疑"
+  - name: length
+    description: "目标字数（默认 800）"
+    required: false
+    default: "800"
+
+steps:
+  - id: story_structure
+    role: "academic/academic-narratologist"
+    task: |
+      请用中文为以下创意设计一个短篇小说的叙事结构：
+
+      创意：{{premise}}
+      风格偏好：{{style}}
+
+      请输出：
+      1. 核心冲突（一句话）
+      2. 叙事视角（第几人称、谁的视角）
+      3. 结构安排（开头钩子 → 发展 → 高潮 → 结尾），每段用一句话概括
+      4. 关键的叙事技巧（如：倒叙、留白、意外反转等）
+      5. 故事想要传递的情感/主题
+
+      简洁明确，不要废话。
+    output: structure
+
+  - id: character_design
+    role: "academic/academic-psychologist"
+    task: |
+      请用中文基于以下叙事结构，设计主要人物：
+
+      {{structure}}
+
+      请为每个关键人物输出：
+      1. 名字和一句话描述
+      2. 核心动机（想要什么）
+      3. 内心矛盾（害怕什么）
+      4. 一个让读者记住的细节/习惯
+      5. 人物弧线（从开头到结尾的变化）
+
+      人物要真实可信，不要脸谱化。
+    output: characters
+    depends_on: [story_structure]
+
+  - id: conflict_design
+    role: "game-development/narrative-designer"
+    task: |
+      请用中文基于以下叙事结构，设计具体的冲突场景和对话：
+
+      {{structure}}
+
+      请输出：
+      1. 开头钩子的具体场景（用 2-3 句话描绘画面）
+      2. 核心冲突爆发的关键对话（3-5 句，要有张力）
+      3. 高潮时刻的情感转折点
+      4. 结尾的留白或余韵
+
+      要具体、有画面感，不要抽象概括。
+    output: scenes
+    depends_on: [story_structure]
+
+  - id: write_story
+    role: "marketing/marketing-content-creator"
+    task: |
+      请用中文根据以下素材，写一篇完整的短篇小说（约 {{length}} 字）。
+
+      ## 叙事结构
+      {{structure}}
+
+      ## 人物设定
+      {{characters}}
+
+      ## 关键场景和对话
+      {{scenes}}
+
+      写作要求：
+      - 直接输出小说正文，不要写标题或说明
+      - 开头第一句就要抓住读者
+      - 对话要自然，像真人说的话
+      - 描写要有画面感，用具体细节而不是形容词堆砌
+      - 结尾要有余韵，让读者回味
+    depends_on: [character_design, conflict_design]

package/workflows/test-deepseek.yaml

@@ -0,0 +1,68 @@
+name: "DeepSeek 实战测试"
+description: "3步工作流：产品分析 → 技术+设计并行评估 → 汇总，验证 DAG 并行和变量传递"
+
+agents_dir: "agency-agents-zh"
+
+llm:
+  provider: "deepseek"
+  model: "deepseek-chat"
+  max_tokens: 1024
+  timeout: 60000
+  retry: 2
+
+concurrency: 2
+
+inputs:
+  - name: idea
+    description: "产品创意"
+    required: true
+
+steps:
+  - id: pm_analyze
+    role: "product/product-manager"
+    task: |
+      请用中文简要分析以下产品创意（200字以内）：
+      - 目标用户是谁
+      - 核心价值主张
+      - 最大风险
+
+      创意：{{idea}}
+    output: analysis
+
+  - id: tech_eval
+    role: "engineering/engineering-software-architect"
+    task: |
+      请用中文基于以下分析，评估技术可行性（150字以内）：
+      - 推荐技术栈
+      - 预估难度（高/中/低）
+      - 一个关键技术风险
+
+      {{analysis}}
+    output: tech_report
+    depends_on: [pm_analyze]
+
+  - id: design_eval
+    role: "design/design-ux-researcher"
+    task: |
+      请用中文基于以下分析，评估用户体验（150字以内）：
+      - 核心用户旅程
+      - 最大 UX 风险
+      - 一个设计建议
+
+      {{analysis}}
+    output: design_report
+    depends_on: [pm_analyze]
+
+  - id: final
+    role: "product/product-manager"
+    task: |
+      请用中文综合以下反馈，给出最终结论（200字以内）：
+
+      ## 技术评估
+      {{tech_report}}
+
+      ## 设计评估
+      {{design_report}}
+
+      请输出：是否值得做（是/否），以及 3 条关键行动项。
+    depends_on: [tech_eval, design_eval]

package/workflows/test-real.yaml

@@ -0,0 +1,35 @@
+name: "Real LLM Test"
+description: "2-step workflow to verify real LLM integration"
+
+agents_dir: "agency-agents-zh"
+
+llm:
+  provider: "ollama"
+  model: "llama3"
+  max_tokens: 512
+  timeout: 120000
+  retry: 1
+
+concurrency: 2
+
+inputs:
+  - name: topic
+    description: "Topic to analyze"
+    required: true
+
+steps:
+  - id: analyze
+    role: "product/product-manager"
+    task: |
+      用中文简要分析以下主题的市场前景（100字以内）：
+
+      {{topic}}
+    output: analysis
+
+  - id: plan
+    role: "engineering/engineering-software-architect"
+    task: |
+      基于以下分析，用中文给出 3 条技术建议（每条一句话）：
+
+      {{analysis}}
+    depends_on: [analyze]