🏗️ 三层知识架构 (3-Tier Knowledge Architecture)

Agent Workstation v1.4.0 的核心能力——三层知识种子体系，让每个 Agent 创建即有行业记忆：

🏭 行业知识 (Industry)    → 19 个行业分类
💼 岗位知识 (Job)         → 100 个岗位角色
🔧 工位知识 (Workstation) → 100 个工位场景

🔄 自下而上知识进化飞轮 (Bottom-Up Evolution Flywheel)

┌─────────────────────────────────────────────────┐
│  Agent 日常使用产生工位经验                        │
│       ↓                                          │
│  KnowledgeEvolver 自动提炼为岗位知识               │
│       ↓                                          │
│  岗位知识进一步沉淀为行业最佳实践                    │
│       ↓                                          │
│  新 Agent 创建时自动获得更优的知识种子               │
│       ↓                                          │
│  → 回到顶部，越转越快 🔄                           │
└─────────────────────────────────────────────────┘

越多 Agent 使用 → 知识越丰富 → 新 Agent 起步越高 → 整个生态越智能。

⚡ 快速开始

配合 OPC Agent CLI

npm install -g opc-agent
opc init my-agent --role customer-service-rep
# → 自动生成: SOUL.md + agent.yaml + CONTEXT.md + brain-seed.md

编程使用

import { searchRoles, getPopularRoles, getCategories } from 'agent-workstation';

// 模糊搜索
const roles = searchRoles('developer');
console.log(roles);
// → [{ category: 'engineering', role: 'backend-developer', score: 110 }, ...]

// 获取热门角色
const popular = getPopularRoles();

// 浏览分类
const categories = getCategories();

✨ 核心特性

📋 完整角色列表（20 个生产就绪）

另有 80 个骨架模板（含 OAD 配置，prompt 补全中），覆盖 admin、design、education、executive、healthcare、tech 等全部 19 个职能。

🏗️ 三层分类体系

行业 (11)  →  职能 (19)  →  工位 (100)

Technology     Engineering     backend-developer, frontend-developer, devops-engineer ...
               Product         product-manager, product-owner ...
               Data            data-analyst, data-engineer ...

E-commerce     Sales           sales-development-rep, account-executive ...
               Marketing       content-marketer, social-media-manager ...
               Customer Svc    customer-service-rep, complaint-handler ...

Finance        Finance         financial-analyst, tax-preparer ...
               Legal           corporate-lawyer, compliance-officer ...

🧠 三层知识架构 (3-Tier Brain Seeds)

每个角色拥有三层知识种子，从通用到具体层层递进：

roles/
├── tech/                              ← 行业分类
│   ├── brain-seed.md                  ← 🏭 行业级知识 (Industry)
│   ├── frontend-developer/
│   │   ├── brain-seed.md              ← 💼 岗位级知识 (Job)
│   │   ├── workstation-seed.md        ← 🔧 工位级知识 (Workstation)
│   │   └── system-prompt.md

当 opc init --role frontend-developer 时，自动生成：

my-agent/
├── brain-seeds/
│   ├── industry.md         ← 来自 tech/brain-seed.md
│   ├── job.md              ← 来自 tech/frontend-developer/brain-seed.md
│   └── workstation.md      ← 来自 tech/frontend-developer/workstation-seed.md
├── context.md              ← 空模板，填写公司特定知识
├── SOUL.md
└── agent.yaml

API 使用

import { getBrainSeeds, getIndustryBrainSeed, getWorkstationBrainSeed, getContextTemplate } from 'agent-workstation';

// 获取某角色的全部三层知识
const seeds = getBrainSeeds('frontend-developer');
// → { industry, job, workstation, contextTemplate }

// 单独获取行业级知识
const techSeed = getIndustryBrainSeed('tech');

// 获取企业上下文模板
const template = getContextTemplate();

📂 模板结构

每个完整模板包含五个文件：

roles/customer-service/customer-service-rep/
├── oad.yaml              # OAD 声明式配置（技能、渠道、指标）
├── system-prompt.md      # 50–80 行专业 system prompt
├── brain-seed.md         # 💼 岗位知识种子
├── workstation-seed.md   # 🔧 工位知识种子（SOP、场景、标准）
└── README.md             # 岗位说明书

workstation-seed.md 结构

# {角色}工位 — 工位知识库

## 典型工作场景 (3-5个)
## 标准操作流程 (SOP)
## 常见问题处理方案
## 质量标准/检查清单
## 新人上手指南
## 跨部门协作要点

📖 API Reference

import {
  getCategories,            // () => { name, roles[] }[]
  getRole,                  // (category, role) => { category, role, files }
  searchRoles,              // (query) => { category, role, title, score }[]
  validateRole,             // (category, role) => { valid, errors[], warnings[] }
  getPopularRoles,          // () => top 20 curated roles
  getIndustries,            // () => industries/index.yaml content
  getIndustryBrainSeed,     // (category) => string | null
  getJobBrainSeed,          // (category, role) => string | null
  getWorkstationBrainSeed,  // (category, role) => string | null
  getContextTemplate,       // () => string
  getBrainSeeds,            // (role) => { industry, job, workstation, contextTemplate } | null
  WorkstationUI,            // Web UI server class
} from 'agent-workstation';

searchRoles(query)

模糊搜索，支持多词匹配，按相关度排序：

searchRoles('frontend');
// → [{ category: 'engineering', role: 'frontend-developer', score: 110 }]

validateRole(category, role)

校验模板完整性：

validateRole('sales', 'sales-development-rep');
// → { valid: true, errors: [], warnings: [] }

🔗 四件套生态

Agent Workstation 是跃盟 AI Agent 基础设施的一部分：

opc init --role customer-service-rep
    │
    ├──→ agent-workstation    提供 system-prompt + oad.yaml
    ├──→ deepbrain            brain-seed.md → learn() 初始化记忆
    └──→ agentkits            连接 LLM + 记忆，运行 Agent

🗺️ Roadmap

License

**双许可证 (Dual License)**：

• ✅ 直接使用模板（不修改）：无需开源你的项目
• ✅ 修改模板内容：修改部分需以 LGPL-3.0 开源
• ✅ 创建全新模板：完全属于你
• 💼 需要闭源修改或专有分发？请联系 licensing@deepleaper.com

⚡ Quick Start

With OPC Agent CLI

npm install -g opc-agent
opc init my-agent --role customer-service-rep
# → Generates: SOUL.md + agent.yaml + CONTEXT.md + brain-seed.md

Programmatic Usage

import { searchRoles, getPopularRoles, getCategories } from 'agent-workstation';

const roles = searchRoles('developer');
// → [{ category: 'engineering', role: 'backend-developer', score: 110 }, ...]

const popular = getPopularRoles(); // Top 20 curated roles
const categories = getCategories(); // All 19 function categories

✨ Key Features

📋 Production-Ready Roles (20)

Plus 80 skeleton templates (OAD config included, prompts in progress) across all 19 functions.

🏗️ 3-Tier Taxonomy

Industry (11)  →  Function (19)  →  Role (100)

Technology     Engineering     backend-developer, frontend-developer, devops-engineer ...
               Product         product-manager, product-owner ...
               Data            data-analyst, data-engineer ...

E-commerce     Sales           sales-development-rep, account-executive ...
               Marketing       content-marketer, social-media-manager ...
               Customer Svc    customer-service-rep, complaint-handler ...

Finance        Finance         financial-analyst, tax-preparer ...
               Legal           corporate-lawyer, compliance-officer ...

📂 Template Structure

roles/customer-service/customer-service-rep/
├── oad.yaml          # Declarative config (skills, channels, metrics)
├── system-prompt.md  # 50–80 line expert system prompt
├── brain-seed.md     # 🧠 Industry knowledge seed (works with DeepBrain)
└── README.md         # Role description

📖 API Reference

import {
  getCategories,     // () => { name, roles[] }[]
  getRole,           // (category, role) => { category, role, files }
  searchRoles,       // (query) => { category, role, title, score }[]
  validateRole,      // (category, role) => { valid, errors[], warnings[] }
  getPopularRoles,   // () => top 20 curated roles
  getIndustries,     // () => industries/index.yaml content
  getIndustryBrainSeed,     // (category) => string | null
  getJobBrainSeed,          // (category, role) => string | null
  getWorkstationBrainSeed,  // (category, role) => string | null
  getContextTemplate,       // () => string
  getBrainSeeds,            // (role) => { industry, job, workstation, contextTemplate } | null
  WorkstationUI,     // Web UI server class
} from 'agent-workstation';

🔗 Ecosystem

🗺️ Roadmap

License

Dual License:

• ✅ Use templates as-is (unmodified): no need to open-source your project
• ✅ Modify template content: modifications must be shared under LGPL-3.0
• ✅ Create brand-new templates: fully yours
• 💼 Need closed-source modifications or proprietary distribution? Contact licensing@deepleaper.com