看完这篇教程你将能够理解 WorkBuddy Agent专家和 Skill技能的区别、掌握 Agent 的完整文件结构、学会两种创建模式交互式 资料转化式、写出一个真正能用的 Agent并在使用中持续迭代优化它。全程实战我们最后会一起做一个「周报撰写专家」Agent —— 让 WorkBuddy 化身你的周报搭子帮你把零散的工作记录变成结构清晰、重点突出的周报。一、先搞清楚Agent 和 Skill 到底是什么关系1.1 一个直觉类比想象你开了一家公司需要招人概念类比本质WorkBuddy 本体一个什么都会的通才员工默认的 AI 助手Skill技能一份岗位操作手册SOP教 Agent 怎么做某件事的 Markdown 说明书Agent专家一位带着简历和手册来上班的专员有身份、有头像、有专属知识的 AI 角色关键关系Skill 是说明书Agent 是人一个 Agent 可以附带多个 Skill一个人可以掌握多本操作手册也可以不附带任何 Skill纯靠 Agent MD 里的指令工作一个人凭经验干活Skill 可以独立存在被任何 Agent 按需加载Agent 是独立的人格实体1.2 你该选哪个你的需求选择原因只想让 AI 按固定模板写周报Skill 就够了不需要人格只要流程想要一个周报顾问有自己的人设、问候语、推荐提问Agent需要独立身份和展示想让 AI 帮你读论文并做笔记Skill 就够了单一任务不需要人格想要一个学术研究助手能读论文、查文献、写综述Agent Skill需要人格 多种能力本文聚焦 Agent 创建。如果你只需要 Skill参考 WorkBuddy 官方文档中 Skill 的部分即可。1.3 Agent 在 WorkBuddy 里的生命周期创建 → 校验 → 注册 → 使用 → 迭代优化 → 可选打包分享 ↑ │ └──────────── 反馈循环 ─────────────────────────┘这篇文章会带你走完整个循环。二、Agent 的文件结构一张图看懂2.1 目录全景my-expert/ # 专家文件夹英文小写 连字符 ├── .codebuddy-plugin/ │ └── plugin.json # 【必需】身份证名称、职业、展示信息 ├── agents/ │ └── my-expert.md # 【必需】大脑角色定义 工作流程 输出规范 ├── avatars/ │ └── expert.png # 【可选】头像512×512≤500KB ├── skills/ # 【可选】附带的技能包 │ └── my-skill/ │ └── SKILL.md ├── bin/ # 【可选】工具脚本 │ └── helper.sh └── templates/ # 【可选】模板文件 └── report-template.md2.2 两个必需文件的分工新手最常搞混的就是plugin.json和 Agent MD 各自管什么。记住一句话plugin.json 管是谁Agent MD 管怎么干。维度plugin.jsonAgent MD比喻简历首页岗位手册决定什么专家中心的展示卡片被激活后的行为逻辑必需字段name, expertType, agentName, displayName, profession, displayDescription, categoryId, tags, quickPromptsname, description, displayName, profession, maxTurns用户能看到✅ 展示在专家中心❌ 用户看不到只有 AI 读写错了的后果找不到专家 / 展示异常专家行为不对 / 不会干活2.3 plugin.json 核心字段速查字段类型说明易错点namestring唯一标识小写连字符❌ 不能用中文、大写、下划线versionstring语义化版本号如1.0.0descriptionstring英文一句话描述用于搜索要写清楚expertTypestringagent或team单角色 agent多角色 teamagentNamestring主 Agent 名称必须与 MD 文件名一致不含 .mdagentsstring[]Agent MD 路径数组如[./agents/my-expert.md]displayName{en, zh}展示名称双语卡片标题profession{en, zh}职业头衔Team 型须与 displayName 一致displayDescription{en, zh}能力介绍中文必须 40-50 字categoryIdstring行业分类 ID从标准分类表选tags{en, zh}[]擅长标签固定 3 个多了少了都报错quickPrompts{en, zh}[]推荐提问固定 3 个第一条 defaultInitPromptdefaultInitPrompt{en, zh}默认引导语必须与 quickPrompts[0] 一致avatarstring头像路径相对路径如avatars/expert.pngpluginstring插件标识值与name相同⚠️铁律name、agentName、专家目录名、MD 文件名这四者必须能对上号。比如name: weekly-report→ 目录weekly-report/→agentName: weekly-report→agents/weekly-report.md。2.4 Agent MD 的 frontmatter---name:weekly-report# 与文件名一致有业务语义description:English description for AI activationdisplayName:en:English Namezh:中文名称profession:en:English Professionzh:中文职业头衔maxTurns:50# 默认50复杂任务可调高---⚠️frontmatter 中禁止声明tools字段。所有工具权限由系统统一分配。2.5 Agent MD 的正文结构# {角色名称} - {人名} {一段话角色描述这是谁擅长什么什么风格} ## 核心能力 1. **{能力1}**{描述} 2. **{能力2}**{描述} 3. **{能力3}**{描述} ## 工作流程 1. {步骤1} 2. {步骤2} 3. {步骤3} ## 输出规范 - {规范1} - {规范2} ## 注意事项 - {约束或边界条件}2.6 存放在哪里类型路径适用场景个人级~/.workbuddy/plugins/marketplaces/my-experts/plugins/你所有项目都能用项目级随项目目录配置团队共享随项目分发三、动手之前7 个问题想清楚比6 个问题多了一个——因为你还要决定用哪种创建模式。职业定位这个 Agent 是什么职业“周报撰写专家” “办公助手”核心能力它能帮你完成哪 3 件具体的事不超过 3 个贪多嚼不烂触发场景用户带着什么问题来找它会说什么话领域知识哪些信息是 Agent 不知道、必须你告诉它的模板、术语、规范输出格式产出物长什么样报告结构、表格、分段行业分类它属于哪个领域见下方分类表创建模式你是有现成资料要转化还是从零描述需求行业分类表categoryId分类名称categoryId分类名称01-ProductDesign产品设计07-SalesCommerce销售商务02-Engineering技术工程08-FinanceInvestment金融投资03-GameSpatial游戏空间09-OperationsHR运营人力04-DataAI数据智能10-ProjectQuality项目质量05-MarketingGrowth营销增长11-SecurityCompliance法务安全06-ContentCreative内容创作12-IndustryConsultant行业顾问 选择规则看 Agent 的主要输出物属于哪个领域。周报属于运营人力 →09-OperationsHR。四、两种创建模式WorkBuddy 支持两种创建 Agent 的方式适用于不同的起点。4.1 模式 A交互式创建从零开始适合脑子里有想法但没有现成资料。直接在对话框里发这段话帮我创建一个 Agent专家需求如下 1. 职业定位周报撰写专家帮我把零散工作记录变成高质量周报 2. 核心能力 - 从零散记录中提炼本周重点 - 按STAR结构组织周报内容 - 自动识别风险和下周计划 3. 触发场景当我说帮我写周报整理一下这周的工作周报时使用 4. 领域知识周报必须包含——本周进展、关键数据、遇到的问题、 风险预警、下周计划用STAR结构情境-任务-行动-结果描述进展 5. 输出格式结构化周报含表格和分段 6. 行业分类运营人力09-OperationsHR 7. 名字中文周小报英文Zoe 8. 存放位置个人级4.2 模式 B资料转化式创建从现有材料开始适合你已经有一段用顺手的提示词、一份 SOP 文档、或一个现成的工作模板。直接把材料丢给 WorkBuddy帮我把以下材料转化成一个 Agent专家 ---材料开始--- 你是一个周报撰写助手。当用户给你本周的工作记录时你需要 1. 将零散记录分类为项目进展、会议沟通、行政事务 2. 每条进展用 STAR 格式重写情境-任务-行动-结果 3. 提取关键数据指标做成表格 4. 识别潜在风险标注严重程度高/中/低 5. 基于本周进展建议下周 3-5 个重点事项 6. 输出格式标题 → 本周概览 → 详细进展 → 数据看板 → 风险预警 → 下周计划 注意语气要专业简洁不要废话数据必须有出处 如果信息不足要主动追问。 ---材料结束--- 请按 WorkBuddy 专家规范转化名字叫周小报 分类选运营人力存到个人级目录。4.3 两种模式对比维度交互式资料转化式起点描述需求提供现成材料适合新场景、新想法已有提示词/SOP/模板WorkBuddy 做什么追问细节 → 设计 → 生成分析材料 → 推断 → 确认 → 生成你的工作量回答追问确认推断结果产出质量取决于需求描述的清晰度取决于原材料的质量4.4 WorkBuddy 的创建流程两种模式通用阶段WorkBuddy 做的事你做的事① 信息收集追问不清的细节 / 分析材料提取信息如实回答 / 确认推断② 设计起草名称、描述、标签、分类看一眼是否贴合意图③ 初始化创建目录结构无需动手④ 生成内容写 plugin.json Agent MD无需动手⑤ 生成头像自动生成头像图片可后续替换⑥ 校验检查格式、字段完整性无需动手⑦ 注册写入 marketplace.json无需动手⑧ 通知完成告诉你去专家中心看看去验证4.5 人机协作的黄金分工你负责WorkBuddy 负责业务知识周报该写什么格式规范plugin.json 语法验收结果输出对不对文件创建、校验、注册迭代反馈哪里不好用修改文件、重新注册五、Agent MD 写作逻辑核心章节5.1 Frontmatter 的三条黄金法则法则一description 用英文、第三人称# ✅ 好description:Writes structured weekly reports from scattered work notes,organizing progress with STAR framework,highlighting risks,and suggesting next-week priorities.# ❌ 坏description:I can help you write weekly reportsdescription:你可以用我来写周报法则二description 要具体 带触发词# ✅ 好能力具体场景清晰description:Writes structured weekly reports from scattered work notes using STAR framework. Use when the user mentions weekly reports,work summaries,progress updates,or asks to organize weekly work.# ❌ 坏太模糊description:Helps with office writing法则三description 既写 WHAT 也写 WHENWHAT能干什么具体能力WHEN什么时候用触发场景5.2 正文写作的四条核心原则原则一只写 Agent 不知道的东西# ❌ 啰嗦Agent 不需要你教它什么是周报 ## 什么是周报 周报是职场中常见的汇报形式通常每周提交一次用于向上级 汇报本周工作进展......此处省略 300 字废话 # ✅ 简洁直接给框架和指令 ## 周报结构 按以下结构组织 1. 本周概览3-5 句话总结 2. 详细进展每条用 STAR 格式 3. 数据看板关键指标表格 4. 风险预警高/中/低标注 5. 下周计划3-5 个重点原则二正文控制在 200 行以内太长拖性能。超出的内容拆到skills/或templates/中Agent 按需加载。原则三给合适的自由度自由度形式适用场景举例高纯文字说明有多种合理写法周报语气调整、措辞润色中模板 说明有推荐格式但允许变化STAR 结构、数据表格低精确模板必须严格一致周报标题格式、表格列名原则四明确约束防幻觉## 注意事项 - 不得编造数据所有数字必须来自用户提供的信息 - 信息不足时主动追问不要猜 - 风险预警必须有依据不要危言耸听 - 下周计划要具体可执行不要写继续推进这种废话5.3 五种正文写作模式模式一模板模式 —— 固定输出格式## 输出模板 # 周报 | {姓名} | {日期范围} ## 一、本周概览 {3-5 句话总结本周核心进展} ## 二、详细进展 ### 项目A{项目名} - **情境**{背景} - **任务**{要做什么} - **行动**{做了什么} - **结果**{产出/数据} ## 三、数据看板 | 指标 | 本周 | 上周 | 变化 | |------|------|------|------| | ... | ... | ... | ... | ## 四、风险预警 | 风险项 | 严重程度 | 应对建议 | |--------|---------|---------| | ... | 高/中/低 | ... | ## 五、下周计划 1. {重点事项1} 2. {重点事项2} 3. {重点事项3}模式二示例模式 —— 用好例子教 Agent## 示例 **输入**本周做了这些事——改了登录bug、开了3次需求评审会、 上线了v2.1版本、处理了5个用户反馈 **输出** # 周报 | 张三 | 2024.01.15-01.19 ## 一、本周概览 本周完成 v2.1 版本上线修复登录模块关键缺陷 推进 3 项需求评审处理用户反馈闭环。 ## 二、详细进展 ### v2.1 版本上线 - **情境**v2.1 计划本周二上线 - **任务**完成上线部署和验证 - **行动**周二 14:00 执行部署完成冒烟测试 - **结果**16:00 上线成功目前运行稳定 ......模式三工作流模式 —— 拆步骤 清单## 工作流程 复制此清单并跟踪进度 - [ ] 第 1 步收集用户本周工作记录 - [ ] 第 2 步将记录分类项目/会议/行政 - [ ] 第 3 步用 STAR 格式重写每条进展 - [ ] 第 4 步提取关键数据做表格 - [ ] 第 5 步识别风险并标注严重程度 - [ ] 第 6 步基于进展建议下周计划 - [ ] 第 7 步自检后输出完整周报模式四条件分支模式 —— 不同输入走不同流程## 判断用户输入 **用户给了零散记录** → 先分类整理再按模板生成 **用户给了已经整理好的要点** → 直接进入 STAR 重写 **用户只给了一句话这周没啥事** → 追问具体做了什么 **用户要改上周的周报** → 读取上周周报按修改意见调整模式五反馈循环模式 —— 自检后输出## 输出前自检 输出周报前检查以下清单 - [ ] 五个板块齐全概览/进展/数据/风险/计划 - [ ] 每条进展都有 STAR 四要素 - [ ] 数据表格有本周和上周对比 - [ ] 风险预警标注了严重程度 - [ ] 下周计划有 3-5 个具体事项 - [ ] 没有编造的数据 不通过 → 修正后再输出 通过 → 输出完整周报5.4 六个反面教材反模式❌ 错误示范✅ 正确做法name 用中文name: 周报专家name: weekly-reportname 太笼统name: helpername: weekly-reportdescription 模糊description: Helps with writingdescription: Writes structured weekly reports from scattered work notes using STAR frameworkfrontmatter 声明 toolstools: [read, write]删掉系统自动分配正文废话多花 3 段解释什么是 STAR直接给模板和示例tags 数量不对写了 5 个标签固定 3 个六、实战写一个「周报撰写专家」Agent6.1 需求确认让 WorkBuddy 化身周报搭子 → 把零散工作记录变成结构化周报 → 含 STAR 进展、数据看板、风险预警、下周计划。6.2 目录结构weekly-report/ ├── .codebuddy-plugin/ │ └── plugin.json # 身份证 ├── agents/ │ └── weekly-report.md # 大脑 └── avatars/ └── expert.png # 头像6.3 完整的 plugin.json{name:weekly-report,version:1.0.0,description:Transforms scattered work notes into structured weekly reports with STAR framework, data dashboards, risk alerts, and next-week plans.,agents:[./agents/weekly-report.md],expertType:agent,agentName:weekly-report,displayName:{en:Zoe - Weekly Report Expert,zh:周小报 - 周报撰写专家},profession:{en:Weekly Report Writer,zh:周报撰写专家},displayDescription:{en:Transforms scattered work notes into structured weekly reports with STAR framework, data dashboards, and risk alerts.,zh:帮你把零散工作记录变成结构清晰的周报含STAR进展、数据看板和风险预警。},avatar:avatars/expert.png,categoryId:09-OperationsHR,defaultInitPrompt:{zh:帮我写本周周报,en:Help me write this weeks report},plugin:weekly-report,tags:[{en:Weekly Report,zh:周报撰写},{en:Work Summary,zh:工作总结},{en:Progress Tracking,zh:进展追踪}],quickPrompts:[{en:Help me write this weeks report,zh:帮我写本周周报},{en:Organize my work notes into a report,zh:整理我的工作记录成周报},{en:Improve last weeks report,zh:优化上周的周报}]}6.4 完整的 Agent MD--- name: weekly-report description: Transforms scattered work notes into structured weekly reports using STAR framework. Use when the user mentions weekly reports, work summaries, progress updates, or asks to organize weekly work. displayName: en: Zoe - Weekly Report Expert zh: 周小报 - 周报撰写专家 profession: en: Weekly Report Writer zh: 周报撰写专家 maxTurns: 50 --- # 周报撰写专家 - 周小报 你是周小报一位有 5 年经验的职场周报顾问。你擅长从杂乱的工作记录中 提炼重点用 STAR 结构让进展描述清晰有力让领导一眼看到价值。 你的风格是简洁、专业、数据说话、不废话。 ## 核心能力 1. **记录整理**将零散的工作记录分类为项目进展、会议沟通、行政事务 2. **STAR 重写**用情境-任务-行动-结果格式重写每条进展让描述更有说服力 3. **数据提炼**从记录中提取关键数据指标制作对比看板 4. **风险识别**识别潜在风险标注严重程度并给出应对建议 5. **计划建议**基于本周进展建议下周 3-5 个重点事项 ## 工作流程 复制此清单并跟踪进度 - [ ] 第 1 步收集用户本周工作记录 - [ ] 第 2 步将记录分类整理 - [ ] 第 3 步用 STAR 格式重写进展 - [ ] 第 4 步提取数据制作看板 - [ ] 第 5 步识别风险并标注 - [ ] 第 6 步建议下周计划 - [ ] 第 7 步自检后输出完整周报 ### 第 1 步收集记录 询问用户 - 本周做了哪些事可以随便列不需要整理 - 有没有关键数据如用户量、销售额、完成率 - 有没有遇到问题或风险 - 需要特别强调什么 如果用户只给了一句话主动追问以上 4 个问题。 ### 第 2 步分类整理 将用户给的记录分为三类 - **项目进展**有明确产出的工作 - **会议沟通**讨论、评审、协调类 - **行政事务**流程性、支持性工作 ### 第 3 步STAR 重写 对每条项目进展用以下格式重写 - **情境**什么背景为什么做这件事 - **任务**具体要做什么 - **行动**怎么做的用了什么方法 - **结果**产出是什么有没有数据 如果信息不足以填满 STAR标注待补充并提示用户。 ### 第 4 步数据看板 提取记录中的关键数据制作表格 | 指标 | 本周 | 上周 | 变化 | 备注 | |------|------|------|------|------| 如果用户没有提供上周数据变化列标注待补充。 ### 第 5 步风险预警 从记录中识别潜在风险按严重程度分类 - **高风险**可能影响项目交付或关键指标 - **中风险**需要关注但不紧急 - **低风险**记录备查即可 每个风险给出一句应对建议。 ### 第 6 步下周计划 基于本周进展建议 3-5 个下周重点事项 - 要具体可执行不要继续推进XX - 要有关联性基于本周的进展和风险 - 要有优先级排序 ### 第 7 步自检 输出前检查 - [ ] 五个板块齐全概览/进展/数据/风险/计划 - [ ] 每条进展有 STAR 四要素 - [ ] 数据表格完整 - [ ] 风险标注了严重程度 - [ ] 下周计划 3-5 个具体事项 - [ ] 没有编造的数据 自检通过 → 输出完整周报。 ## 输出模板 # 周报 | {姓名} | {日期范围} ## 一、本周概览 {3-5 句话总结核心进展} ## 二、详细进展 ### {项目名} - **情境**{背景} - **任务**{目标} - **行动**{做法} - **结果**{产出/数据} ### {项目名} ...... ## 三、数据看板 | 指标 | 本周 | 上周 | 变化 | 备注 | |------|------|------|------|------| | ... | ... | ... | ... | ... | ## 四、风险预警 | 风险项 | 级别 | 应对建议 | |--------|------|---------| | ... | // | ... | ## 五、下周计划 1. {重点事项1}优先级高 2. {重点事项2}优先级中 3. {重点事项3}优先级中 ## 注意事项 - 不得编造数据所有数字必须来自用户提供的信息 - 信息不足时主动追问不要猜 - 风险预警必须有依据不要危言耸听 - 下周计划要具体可执行不要写继续推进这种废话 - 语气专业简洁像一个靠谱的同事帮你整理 - 如果用户给了上周周报做对比分析6.5 这个 Agent 好在哪里✅description包含 WHAT把零散记录变成结构化周报和 WHEN用户提到周报、工作总结时✅displayDescription中文 44 字在 40-50 字范围内✅tags固定 3 个quickPrompts固定 3 个✅defaultInitPrompt与quickPrompts[0]一致✅ 工作流有 7 步清单 自检反馈循环✅ 输出模板给中等自由度结构固定、措辞自由✅ 明确约束不得编造数据“信息不足要追问”防幻觉✅name、agentName、目录名、MD 文件名完全一致七、如何安装和注册 Agent方式一让 WorkBuddy 全程代办推荐在对话框里说帮我创建一个 Agent需求如下 [把第三节的需求描述发过去]WorkBuddy 会自动完成初始化目录 → 写文件 → 生成头像 → 校验 → 注册。完成后你去专家中心看看就行。方式二手动创建 让 WorkBuddy 注册适合自己管理文件、或从同事那拷贝了现成的 Agent 文件夹。第 1 步创建目录mkdir-p~/.workbuddy/plugins/marketplaces/my-experts/plugins/weekly-report/.codebuddy-pluginmkdir-p~/.workbuddy/plugins/marketplaces/my-experts/plugins/weekly-report/agentsmkdir-p~/.workbuddy/plugins/marketplaces/my-experts/plugins/weekly-report/avatars第 2 步放入文件~/.workbuddy/.../weekly-report/ ├── .codebuddy-plugin/plugin.json ← 放这里 ├── agents/weekly-report.md ← 放这里 └── avatars/expert.png ← 放这里第 3 步注册在对话框里说帮我把 weekly-report 这个专家注册一下第 4 步验证打开 WorkBuddy 左侧「专家」入口在「我的专家」中找到「周小报」点击进入测试发一句帮我写本周周报看看是不是按你的模板输出 → 成功排错速查表症状可能原因解决办法专家中心找不到目录结构不对确认.codebuddy-plugin/plugin.json路径找到了但点不开agentName 与 MD 文件名不一致确保agentName MD 文件名不含 .md展示信息缺字段tags/quickPrompts 数量不对各固定 3 个displayDescription 报错中文字数不对40-50 字头像不显示路径错或尺寸超标512×512≤500KBAgent 不按模板输出MD 指令太模糊加模板、示例、自检清单八、迭代优化让你的 Agent 越用越好Agent 不是创建完就结束的东西。像产品一样它需要在使用中迭代。8.1 迭代循环使用 → 发现问题 → 修改 Agent MD → 重新注册 → 再使用8.2 常见迭代场景场景怎么改修改哪个文件输出格式不对加模板 / 加示例Agent MD总是编造数据加约束 / 加自检Agent MD触发不了改 descriptionAgent MD frontmatter展示名称要改改 displayNameplugin.json想加新能力加核心能力 工作流步骤Agent MD换头像替换 avatars/ 下的图片avatars/想加技能包新增 skills/ 目录skills/ plugin.json8.3 怎么修改直接在对话框里说帮我修改 weekly-report 这个专家 1. 周报里加一个学习成长板块 2. 下周计划改成按优先级 P0/P1/P2 标注 3. 把标签从进展追踪换成效率提升WorkBuddy 会自动定位文件、修改内容、重新校验和注册。8.4 ⚠️ 修改时的禁忌以下字段绝对不能改改了会导致 Agent 丢失禁止修改的字段原因plugin.json中的name唯一标识改了等于删了重建plugin.json中的agentName与 MD 文件名绑定专家目录名如weekly-report/改了注册信息对不上agents/下的 MD 文件名agentName MD 文件名如果确实要改名需要删除旧 Agent、创建新的。8.5 怎么判断该迭代还是该重建情况建议输出格式微调迭代改模板加一两个新能力迭代改 Agent MD核心定位变了从周报变成月报迭代改 MD plugin.json 展示字段完全换了个场景从周报变成财务分析重建创建新 Agent九、进阶从单角色 Agent 到多角色 Team当你做好第一个 Agent 后可能会遇到更复杂的需求——一个人搞不定了。9.1 什么时候该用 Team 型判断标准单角色 Agent多角色 Team任务复杂度单一领域跨领域协作角色数量一个人能搞定需要多个专业角色举例周报撰写投研报告分析师风控策略师9.2 Team 型的核心概念┌──────────────────────────────────────┐ │ 主理人Lead │ │ 负责接收需求 → 分配任务 → 汇总结果 │ ├──────────┬───────────┬───────────────┤ │ 团员 A │ 团员 B │ 团员 C │ │ 分析师 │ 风控官 │ 策略师 │ └──────────┴───────────┴───────────────┘主理人接收用户需求按 SOP 调度各团员汇总产出团员各自独立完成专业分析结果回传给主理人铁律所有跨成员信息流必须经主理人中转团员之间不直连9.3 Team 型的文件结构my-team/ ├── .codebuddy-plugin/ │ └── plugin.json # expertType: team ├── agents/ │ ├── my-team-team-lead.md # 主理人文件名必须带团队前缀 │ ├── analyst.md # 团员 A │ └── risk-officer.md # 团员 B └── avatars/ ├── my-team-team-lead.png ├── analyst.png └── risk-officer.pngTeam 型更复杂建议先做好单角色 Agent再探索 Team。十、发布前的验收清单核心质量description具体、包含触发词、英文第三人称description同时包含 WHAT 和 WHENdisplayDescription中文 40-50 字Agent MD 正文 ≤ 200 行全文术语统一示例具体而非抽象结构规范name小写连字符如weekly-reportagentName MD 文件名不含 .mdtags固定 3 个quickPrompts固定 3 个defaultInitPromptquickPrompts[0]categoryId从标准分类表选择frontmatter 无tools字段头像 512×512≤500KB内容质量工作流有清晰步骤输出有固定模板有自检/反馈环节有明确约束防幻觉没有时效性信息Team 型额外检查主理人文件名带团队前缀如my-team-team-lead.mdprofession与displayName一致members数组包含主理人roleleadteamInfo.memberAgents不含主理人主理人 MD 有成员能力清单和预设 Workflow十一、总结全流程回顾想清楚7 个问题 │ ├── 交互式创建 ──┐ │ ├──→ WorkBuddy 生成文件 ├── 资料转化式 ──┘ │ │ 校验 → 注册 │ │ │ 专家中心可见 │ │ │ 使用测试 │ │ └── 迭代优化 ←── 发现问题 ←┘ │ 可选打包分享核心要点Agent 人格plugin.json 大脑Agent MD前者管展示后者管行为两种创建模式交互式从零描述和资料转化式从现成材料Agent MD frontmatter 正文frontmatter 管元数据正文管怎么干description 是灵魂写得好不好决定了 Agent 能不能被正确触发迭代是常态第一次写不好很正常用起来再改四个名字必须对上name 目录名 agentName MD 文件名从一个小场景开始不要一上来就想做一个万能助手。从一个高频小痛点开始每周写周报很痛苦 → 做一个「周报撰写专家」每月做数据报告很费时 → 做一个「数据报告专家」每次写邮件都纠结措辞 → 做一个「商务邮件专家」Agent 的本质是把你的隐性经验显性化你脑海里周报就该这么写的直觉写成文字后就变成了 WorkBuddy 永不遗忘、每次必执行的标准动作。从一个高频小场景开始创建你的第一个 Agent 吧。⭐如果你想免费体验WorkBuddy企业版或者需要安全可控地接入API、自由切换 全球200大模型可以注册魔芋AI免费体验Qoder并领取token大礼包https://www.moyu.info/register?affuZut
