一、plugin.json 字段总表
基础字段必填;展示字段上架市场时必填;Team 专用只在专家团里出现。
基础字段(必填)
| 字段 | 类型 | 说明 |
name | string | 唯一标识,kebab-case(小写+连字符),也是技能命名空间前缀 |
version | string | 语义化版本 MAJOR.MINOR.PATCH |
description | string | 英文一句话描述 |
可选基础字段
| 字段 | 类型 | 说明 |
author | {name,email} | 作者信息 |
homepage | string / {url,type} | 项目主页 |
license | string | 许可证 |
keywords | string[] | 搜索标签 |
类型字段
| 字段 | 说明 |
expertType | "agent" / "team" |
agentName | 主 Agent 名(对应 agents/ 下 MD 文件名,不含 .md)。必须有业务语义,禁用 team-lead |
teamInfo | team 时必填:{leadAgent, memberAgents[]} |
展示字段(上架市场必填)
| 字段 | 类型 | 说明 |
displayName | {en,zh} | 展示名称(花名) |
profession | {en,zh} | 职业头衔。Team 型须与 displayName 一致 |
displayDescription | {en,zh} | 能力介绍,中文 40–50 字 |
avatar | string | 头像相对路径 |
categoryId | string | 行业分类 ID(见第六节) |
defaultInitPrompt | {en,zh} | 默认引导语,须与 quickPrompts 第一条一致 |
tags | {en,zh}[] | 擅长领域标签,固定 3 个 |
quickPrompts | {en,zh}[] | 推荐提示词,固定 3 个 |
plugin | string | 值与 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
}
五、成员花名规范
用「姓+名」的谐音花名(如 问需明=问清需求),暗含职能巧思,但不刻意。
| profession | name(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 | 行业顾问 | 跨行业咨询、垂直经营 |
判定优先级
① 主要输出物属于哪类 → ② 服务对象是谁 → ③ 跨领域取最核心的一个。