技能介绍

你在纠结什么

WorkBuddy 能读文件、跑命令、连飞书，但日常里更常卡在几类问题：该用 Craft、Plan 还是 Ask、长对话后模型「忘事」、换文件夹后任务列表变了、打包报错却不知道查哪份记忆。产品说明书往往按菜单罗列，缺少「同一项目怎么隔离上下文」「何时开新任务」这类工程决策。

技能如何帮你理清

本 Skill 在触发条件匹配时加载（功能询问、报错、最佳实践、连接器配置等），按场景组织说明而非功能目录：

工作区与任务：一个文件夹对应一个工作区，对话历史隔离；新任务不继承旧上下文，继续任务保留完整历史。
三种模式：Craft 直接执行；Plan 先方案再确认；Ask 只读分析。对话里输入模式名即可切换。
上下文与记忆：长对话（约 30 轮）易精度下降时的止损策略；HANDOFF.md → 项目 Skill；MEMORY.md（用户级 / 项目级）与 Skill 分工——记忆记「发生了什么」，Skill 记「怎么做」。
Skill 与连接器：用户级 ~/.workbuddy/skills/ 与项目级 .workbuddy/skills/；连接器多通过对应 Skill 使用，侧边栏绿点表示已连接。
排障索引：中文路径、授权目录、@ 引用文件、工作区切换等常见问题的对应做法，以及新项目 / 长项目 / 调研 / 报错四类工作流模板入口。

边界与注意

指南描述的是 WorkBuddy 的能力边界（例如不能访问未授权目录、不能替代 GUI 自动化），不能代替你本机的授权配置与连接器账号。自动化、具体连接器 API 以当时客户端与 Skill 正文为准；遇到「是否支持 X」可先查本 Skill 目录或 find-skills，再向 AI 确认实现路径。