第 2 卷

一、WorkBuddy基础认识与入门

1. 先把 WorkBuddy 说清楚

普通聊天式 AI 更像一个会回答问题的顾问：你提出问题，它返回文字、建议或一段生成内容。

WorkBuddy 所代表的 Agent 工作方式，重点在于围绕一个目标处理资料、拆解步骤，并把结果整理成可检查的产物。

这不意味着它能替人承担所有判断。更准确的理解是：它可以接住一部分明确、重复、可复核的执行工作；人仍然要负责目标、事实、取舍、权限和最终使用。

可以用三个问题区分两种方式：

• 输入在哪里：普通对话通常依赖粘贴或上传；Agent 可能在授权范围内读取工作空间中的资料。
• 中间做什么：普通对话多是一次回答；Agent 可能先规划，再读取、整理、生成和检查。
• 交付是什么：普通对话常停留在聊天内容；Agent 更强调文件、清单、表格或其他可验收结果。

1. 四个基本概念

工作空间

工作空间是一次任务或一个长期主题的工作边界。它可以对应一个项目目录，也可以只是一个用于测试的独立位置。新手阶段建议一个空间只服务一个主题，避免把无关材料混在一起。

工作空间至少应有三个信息：允许读取的范围、允许写入的范围、任务完成后结果保存在哪里。不要因为工具能看到更多目录，就把整个电脑当成默认输入。

任务

任务是一次具体委托，例如“只读取这批资料，生成一份摘要和待核对清单”。一次任务应有清楚的目标、输入、处理方式、输出和验收条件。长期项目可以包含多次任务，但每次任务仍要有自己的边界。

文件

文件既是输入，也是可能产生变化的对象。输入文件需要确认名称、版本、范围和是否包含敏感信息。需要写入时，应优先使用复制件或新文件，不直接覆盖原件。

结果

结果不只是聊天框里的一句“已完成”，还包括实际生成的文档、表格、清单、来源说明、异常记录和变更记录。验收时要到结果所在位置检查文件能否打开、内容是否完整、来源是否对应。

1. 安装、登录和开始前的准备原则

安装入口、系统要求、登录方式、权限范围和客户端界面都可能更新。建议从官方入口进入，核对当前版本和系统提示，不把旧教程里的按钮名称、套餐描述或路径当成固定事实。

• 一份可以公开或脱敏的 Markdown 或 CSV 样例。
• 一个明确的小任务，例如读取并生成摘要。
• 一份人工验收清单，写好要检查的事实、来源和文件位置。
• 原始样例的备份或复制件。

不要把真实学生信息、账号密码、密钥、未公开研究数据或不必要的个人信息作为第一次测试材料。

涉及学校或单位设备限制时，按管理员和单位制度处理，不绕过安全策略。

1. 第一次使用的基本步骤
2. 从官方渠道安装并完成登录，记录客户端版本和使用账号。
3. 建立独立测试空间，只放脱敏或公开样例。
4. 先发一个只读任务，让 WorkBuddy 复述读取范围和目标。
5. 要求先给出预览、摘要或计划，不让它直接移动、删除、覆盖或外发。
6. 检查结果是否只使用了指定资料，是否列出了来源和待核对项。
7. 发现问题时缩小范围，一次只改一个条件，再重新测试。
8. 测试通过后，保留任务写法和验收清单，不急着扩大权限。
9. 当前测试环境下的明确实测行为

以下结论只指当前账号和环境中的 WorkBuddy 5.5.6，不代表所有版本和账号：

• 可以读取 Markdown 和 CSV。
• 可以对指定范围做只读扫描。
• 可以生成 Markdown 摘要。
• 可以列出来源和仍需核对的内容。
• 使用 Plan 时，会先列出执行计划并等待确认。
• 找不到指定文件时，会如实停止，不应把缺失文件当成已读取。

PDF、Word、Excel、图片、外部连接器、自动化、写回文件等能力，不能仅凭其他资料中的描述视为当前环境已确认。需要使用时，应按当前客户端逐项实测。

1. 安全边界和人工检查

适合优先交给工具的任务，通常同时满足四点：输入明确，过程可以复核，结果可以撤回，失败不会直接伤害他人权益。文件清单、资料摘要、字段整理和草稿生成通常更接近这个范围。

需要保留在人工决定区的事项包括：研究设计和因果判断、文献真实性和最终引用、学生评价和成绩认定、法律医疗财务判断、权限变化、删除或覆盖、向外发送重要内容。

• 文件数量、名称和版本是否符合预期。

• 关键数字、日期、引用和结论能否回到原始资料。
• 是否出现输入资料没有的人名、数据、来源或结论。
• 是否把“待核实”误写成了确定事实。
• 是否生成了不需要的副本、外发动作或写入动作。

1. 入门时的正确节奏

先从一个五到十分钟能验收的小任务开始，再逐步增加资料量和处理步骤。失败时不要直接归因于工具好不好用，先检查输入范围、任务写法、文件权限和验收标准。能稳定完成一次，再考虑把任务扩展成长期项目、流程或 Skill。

二、WorkBuddy任务写法与提示词模板

1. 为什么“帮我整理一下”容易返工

这句话没有说明整理对象、整理标准、输出形式和风险边界。工具只能根据常见习惯补全，可能把 “列清单”理解成“移动文件”，把“总结”理解成“改写观点”，把“分析”理解成“直接下结论”。

看起来完成得很快，返工反而更多。

写任务时，先把一个陌生助理需要知道的内容说清楚。可以使用下面六个要素：

1. 目标：最终要得到什么，最好用可检查的动词和产物描述。
2. 输入：允许读取哪些文件、文件夹、表格范围或知识库资料。
3. 处理：要提取、归类、比较、检查、摘要还是生成初稿。
4. 约束：不补事实、不改变原意、不覆盖原文件、不外发，或指定统计口径。
5. 输出：格式、字段、篇幅、文件名和保存位置。
6. 验收：什么情况算完成，要列哪些来源、异常、待确认项和抽查样本。

六要素不要求每次都写成很长的说明。简单任务可以压缩成一两句话，文件和科研任务则应把输入、边界和验收写完整。

1. Ask、Plan、Agent 怎么选

以下是按功能理解的通用分工，具体界面名称和行为以当前版本为准：

• Ask：用于问概念、看材料、讨论方案或检查一段内容。优先用于不需要改文件的咨询和只读分

析。

• Plan：用于复杂或有风险的任务，先让工具列出读取范围、步骤、输出和风险，人工确认后再决定

是否继续。当前测试环境已实测 Plan 会先列计划并等待确认。

• Agent：用于需要读取资料、调用工具、执行多步操作并交付结果的任务。部分版本可能将执行入

口称为 Craft 或其他名称，不能只凭旧教程判断。