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

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

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

🔄 自进化飞轮 (Self-Evolution Flywheel)

Agent 不是从零开始——带着知识种子出生，然后越用越聪明：

┌─────────────────────────────────────────────────┐
│  🌱 Brain Seed（知识种子）→ Agent 带着行业知识出生  │
│       ↓                                          │
│  📥 learn() — 日常使用中自动积累经验                │
│       ↓                                          │
│  🧬 evolve() — 自动提炼为更精华的知识               │
│       ↓                                          │
│  📈 新的经验反哺知识种子，下一个 Agent 起步更高       │
│       ↓                                          │
│  → 回到顶部，越转越快 🔄                           │
└─────────────────────────────────────────────────┘

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

🔄 双闭环知识系统 (Dual-Loop Knowledge)

Agent Workstation 是双闭环知识系统的枢纽：

┌─────────────────────────────────────────────────────┐
│  小闭环（本地，免费）                                  │
│  Agent 本地 learn → recall → evolve                  │
│  离线也能用，数据完全在你手里                           │
│                                                     │
│  大闭环（Hub，增值）                                   │
│  Agent ↔ Workstation Hub 知识共享                    │
│  集体智慧 > 个体经验，新 Agent 站在前人肩膀上            │
└─────────────────────────────────────────────────────┘

本地是主人，Hub 是助手——没有网络也能用，联网后自动同步和进化。

agentkits (Model Layer) — 调 LLM
     ↕
opc-agent (Runtime) — 跑 Agent（本地）
     ↕
deepbrain (Memory Engine) — 存知识（引擎）
     ↕
agent-workstation (Knowledge Platform) — 知识生命周期（Hub）  ← 你在这里

⚡ 快速开始

配合 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 基础设施的一部分：

🔄 自进化飞轮：Templates 自带 Brain Seed → Model Layer 每次调用自动 learn → Runtime 持续运行 → Memory 自动 evolve → Agent 越来越强。

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

📊 完成度仪表盘 / Progress Dashboard

总览 Overview

各职能完成度

最近更新 Recent Updates

🗺️ 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

🔄 Self-Evolution Flywheel: Templates ship with Brain Seeds → Model Layer auto-learns on every call → Runtime runs continuously → Memory auto-evolves → Agent gets stronger over time.

🔄 Dual-Loop Knowledge System

Agent Workstation is the hub of the dual-loop knowledge system:

┌─────────────────────────────────────────────────────┐
│  Small Loop (Local, Free)                           │
│  Agent local learn → recall → evolve                │
│  Works offline, data stays on your machine          │
│                                                     │
│  Big Loop (Hub, Value-Add)                          │
│  Agent ↔ Workstation Hub knowledge sharing          │
│  Collective wisdom > individual experience          │
└─────────────────────────────────────────────────────┘

Local is the owner, Hub is the helper — works without internet, auto-syncs when connected.

agentkits (Model Layer) — LLM calls
     ↕
opc-agent (Runtime) — run Agents (local)
     ↕
deepbrain (Memory Engine) — store knowledge (engine)
     ↕
agent-workstation (Knowledge Platform) — knowledge lifecycle (Hub)  ← You are here

📊 Progress Dashboard

Recent Updates

🗺️ Roadmap

|-------|------|:------:| | v1.0 | 100 skeleton templates | ✅ | | v1.5 | 20 complete templates (prompt + brain-seed) | ✅ | | v2.0 | 100 complete templates | 🚧 | | v3.0 | 849 roles full coverage | 📋 |

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