解法库

Appearance

第 1 章：从提问到交付，认识 WorkBuddy ​

本章目标 ​

理解 WorkBuddy 的基本工作方式：把自然语言目标转成有边界的任务，读取经过授权的资料，规划并执行步骤，最后交付可以检查和修改的产物。本章不要求一次掌握所有功能，重点是建立安全、可验收的第一次使用方法。

适用场景 ​

  • 第一次接触 WorkBuddy，需要完成一个小而具体的任务；
  • 想把“问一个问题”升级为“得到一份文件、清单或草稿”；
  • 需要让 WorkBuddy 处理本地资料，但不确定应该怎样描述范围和权限；
  • 希望在复杂任务开始前先建立计划和验收点。

前置条件 ​

  • 已安装并登录当前可用的 WorkBuddy 客户端；
  • 准备一份可以用于练习的公开或脱敏资料；
  • 明确目标、输入范围、期望输出和禁止动作；
  • 准备一个独立工作目录，不直接使用唯一原件或共享业务目录。

核心概念 ​

概念含义使用重点
目标任务想达成的结果写成可以检查的结果，不只写“帮我处理一下”
工作区任务可以读取、生成和保存文件的边界按任务隔离，避免资料串用
Agent 任务能理解目标、安排步骤并调用可用能力的工作流程仍然需要人确认权限和结果
Skill / 连接器可复用的专业方法或外部能力使用前检查来源、权限和副作用
产物文档、表格、清单、摘要或其他交付结果要有格式、位置和验收标准

WorkBuddy 的价值不只是回答问题，而是帮助你完成一段从输入到产物的工作流程。它能做什么、界面如何命名、可用模型和连接器有哪些，应以当前产品版本为准。

分步操作 ​

  1. 选择低风险任务。 优先选择可以重跑、结果容易检查、不会触碰敏感资料的任务，例如整理练习目录或生成一页摘要。
  2. 写任务卡。 说明目标、输入、允许动作、禁止动作、输出位置和验收标准。
  3. 设置工作区。 让任务只接触本次需要的目录和文件，不要一开始就打开完全访问。
  4. 先让 WorkBuddy 复述计划。 要求它列出将读取的资料、准备执行的动作、预计产物和待确认问题。
  5. 先预览再执行。 文件移动、改名、覆盖、外发或调用外部服务前，先生成映射、草稿或调用计划。
  6. 按阶段放权。 可以先允许分析和生成草稿，确认中间结果后再允许写入；发送、发布、删除和覆盖必须单独确认。
  7. 检查产物。 对照数量、格式、事实来源、异常项和保存位置验收，留下可回看的记录。

示例 ​

练习任务：把一个脱敏资料目录整理成“待处理”“已确认”“待补充”三类清单。

text
目标：为练习资料生成一份分类清单，不直接移动或删除文件。
输入：只读取 ./practice-materials/ 目录中的文件名和基本属性。
输出：在 ./practice-output/ 生成 Markdown 清单，包含原路径、建议分类和理由。
禁止动作：不删除、不覆盖、不外发、不读取目录之外的内容。
验收：清单条数与扫描结果一致，所有不确定项单独标记，等待我确认后再进行任何文件变更。

验收方法 ​

  • WorkBuddy 能复述正确的目标、输入范围和禁止动作；
  • 输出清单中的数量、路径和分类理由可以逐项核对；
  • 练习目录之外没有被读取，原文件没有被改动；
  • 不确定项、失败项和待人工确认项被明确列出；
  • 你知道下一步是继续修改草稿、执行变更，还是结束任务。

常见问题 ​

只写一句自然语言，WorkBuddy 能自己完成吗？

简单任务可能可以，但没有范围和验收标准时，结果很难判断是否完整。第一次使用时，至少补充输入、输出和禁止动作。

工作区越大越方便吗？

不一定。范围越大，误读、误改和资料串用的风险越高。先从独立的小目录开始，确实需要时再扩大范围。

模型、模式和工具应该怎么选？

先按任务风险和资料类型选择当前产品提供的合适选项：只读理解、计划拆解和实际执行的要求不同。具体名称、模型和能力以当前产品版本为准。

风险和权限边界 ​

  • 不把唯一原件、敏感资料或共享生产目录作为第一次练习输入；
  • 不因 WorkBuddy 的计划看起来合理，就跳过人工确认；
  • 读取、写入、外发、删除、发布和调用外部系统分别确认；
  • 任务失败时保留错误信息和已确认产物，不用猜测补齐结果。

相关解决方案 ​

来源引用 ​

  • SRC-UPSTREAM-CH01：从自然语言目标到工作成果的基本定位，经重新组织后使用。
  • SRC-UPSTREAM-CH03：工作区、任务、模式和结果查看的概念，经重新组织后使用。
  • SRC-UPSTREAM-CH04：任务卡、预览、权限和验收方法，经重新组织后使用。

内容版本与核对日期 ​

  • 内容版本：0.1.0
  • 最后核对日期：2026-08-05
  • 适用版本状态：当前产品能力，界面、模型和功能以当前产品版本为准。
  • 来源提交版本：6b5e2403f0f2ad5d3f7ab7a67e9c4d4113583ff3

章节导航 ​