首页 / 规范手册

规范手册
plugin.json 全字段 · Agent/Team 模板

本页规范来自 WorkBuddy 内置 expert-manager 技能的一手资料(v2.0,整理于 2026-08)。这是全网首次系统公开整理。注:本教程只教「如何在你自己的 WorkBuddy 里创建专家团」,不涉及市场上架与打包分发。

一、plugin.json 字段总表

基础字段必填;展示字段上架市场时必填;Team 专用只在专家团里出现。

基础字段(必填)

字段类型说明
namestring唯一标识,kebab-case(小写+连字符),也是技能命名空间前缀
versionstring语义化版本 MAJOR.MINOR.PATCH
descriptionstring英文一句话描述

可选基础字段

字段类型说明
author{name,email}作者信息
homepagestring / {url,type}项目主页
licensestring许可证
keywordsstring[]搜索标签

类型字段

字段说明
expertType"agent" / "team"
agentName主 Agent 名(对应 agents/ 下 MD 文件名,不含 .md)。必须有业务语义,禁用 team-lead
teamInfoteam 时必填:{leadAgent, memberAgents[]}

展示字段(上架市场必填)

字段类型说明
displayName{en,zh}展示名称(花名)
profession{en,zh}职业头衔。Team 型须与 displayName 一致
displayDescription{en,zh}能力介绍,中文 40–50 字
avatarstring头像相对路径
categoryIdstring行业分类 ID(见第六节)
defaultInitPrompt{en,zh}默认引导语,须与 quickPrompts 第一条一致
tags{en,zh}[]擅长领域标签,固定 3 个
quickPrompts{en,zh}[]推荐提示词,固定 3 个
pluginstring值与 name 一致

Team 专用字段

字段说明
members[]每个成员 {id, name:{en,zh}, profession:{en,zh}, avatar, role};主理人也在内,role="lead"
teamInfo.memberAgents 不含 主理人;role 取值 "lead" / "member"
📌 字段映射:卡片上每个位置来自哪
• 名字(职业)= profession • 花名 = displayName • 类型 = expertType(agent→专家 / team→专家团)
• 行业 = categoryId • 能力介绍 = displayDescription • 擅长领域 = tags • 试试这样问我 = quickPrompts

二、Agent 型 plugin.json 模板

plugin.json
{
  "name": "kebab-case-name",
  "version": "1.0.0",
  "description": "English one-line description",
  "author": { "name": "author-name", "email": "author@email" },
  "agents": ["./agents/agent-name.md"],
  "expertType": "agent",
  "agentName": "agent-name",
  "displayName": { "en": "English", "zh": "中文花名" },
  "profession": { "en": "English", "zh": "中文职业头衔" },
  "displayDescription": { "en": "English", "zh": "中文描述,40-50字" },
  "avatar": "avatars/expert.png",
  "categoryId": "XX-CategoryName",
  "defaultInitPrompt": { "zh": "首次对话提示", "en": "First prompt" },
  "plugin": "kebab-case-name",
  "tags": [
    { "en": "Tag1", "zh": "标签1" },
    { "en": "Tag2", "zh": "标签2" },
    { "en": "Tag3", "zh": "标签3" }
  ],
  "quickPrompts": [
    { "en": "Prompt1", "zh": "提示词1(同defaultInitPrompt)" },
    { "en": "Prompt2", "zh": "提示词2" },
    { "en": "Prompt3", "zh": "提示词3" }
  ]
}

三、Agent MD 规范

⛔ 重要
frontmatter 中 不可添加 tools 字段。所有工具权限由系统统一分配。
agents/agent-name.md
---
name: agent-name          # 与文件名一致,有业务语义
description: English description   # AI 用来判断何时激活
displayName:
  en: "English"
  zh: "中文花名"
profession:
  en: "English title"
  zh: "中文职业头衔"
maxTurns: 50
---

# 角色名称 - 花名

角色描述:这是谁,擅长什么。

## 核心能力
1. **能力1**:描述
2. **能力2**:描述
3. **能力3**:描述

## 工作流程
1. 步骤1
2. 步骤2

## 输出规范
- 规范1
- 规范2

## 注意事项
- 约束或边界条件

四、Team 型 plugin.json + settings.json

plugin.json(team)
{
  "name": "kebab-case-team",
  "version": "1.0.0",
  "description": "English one-line description",
  "author": { "name": "author", "email": "e@mail" },
  "agents": [
    "./agents/kebab-case-team-lead.md",
    "./agents/member-a.md",
    "./agents/member-b.md"
  ],
  "expertType": "team",
  "agentName": "kebab-case-team-lead",
  "teamInfo": {
    "leadAgent": "kebab-case-team-lead",
    "memberAgents": ["member-a", "member-b"]   // 不含 lead
  },
  "displayName": { "en": "Team", "zh": "中文团队名" },
  "profession":  { "en": "Team", "zh": "中文团队名" }, // 必须与 displayName 一致
  "displayDescription": { "en": "English", "zh": "中文描述,40-50字" },
  "avatar": "avatars/team.png",
  "categoryId": "XX-CategoryName",
  "defaultInitPrompt": { "zh": "首次问候", "en": "First" },
  "plugin": "kebab-case-team",
  "tags": [ {en,zh},{en,zh},{en,zh} ],          // 固定 3 个
  "quickPrompts": [ {en,zh},{en,zh},{en,zh} ],  // 固定 3 个,第1=defaultInitPrompt
  "members": [
    { "id":"kebab-case-team-lead", "displayName":{en,zh},
      "profession":{en,zh}, "avatar":"avatars/kebab-case-team-lead.png", "role":"lead" },
    { "id":"member-a", "displayName":{en,zh},
      "profession":{en,zh}, "avatar":"avatars/member-a.png", "role":"member" }
  ]
}
settings.json(team 必须有)
{
  "agent": "kebab-case-team-lead"   // 必须 == plugin.json 的 agentName
}

五、成员花名规范

用「姓+名」的谐音花名(如 问需明=问清需求),暗含职能巧思,但不刻意。

professionname(zh)巧思
需求洞察师问需明问清需求
产品对比师比优劣对比优劣
方案架构师配周全配置周全
保障规划总监顾周全顾及周全
⛔ 禁止
叠字谐音(领码码)、单字或纯职能词、与 profession 重复、无意义随机名(张三/John Doe)、英文用 Agent ID、读起来像短语而非人名。

六、12 个行业分类(categoryId)

categoryId分类举例
01-ProductDesign产品设计UI/UX、原型、交互
02-Engineering技术工程编程、架构、DevOps
03-GameSpatial游戏空间游戏、3D、VR
04-DataAI数据智能数据分析、BI、大模型
05-MarketingGrowth营销增长品牌、投放、SEO
06-ContentCreative内容创作文案、脚本、翻译
07-SalesCommerce销售商务销售、商务、电商
08-FinanceInvestment金融投资投研、财务、风控
09-OperationsHR运营人力运营、HR、培训
10-ProjectQuality项目质量项目管理、测试
11-SecurityCompliance法务安全合规、法务、安全
12-IndustryConsultant行业顾问跨行业咨询、垂直经营
判定优先级
① 主要输出物属于哪类 → ② 服务对象是谁 → ③ 跨领域取最核心的一个。