zhijian-ai-bluebook-workbuddy-harness

WorkBuddy 很容易上手，也很容易在深入使用后碰到一堵看不见的墙：它为什么记住了这件事？插件往主线程里注入了什么？改了配置为什么不生效？专家、Skill、Connector、SubAgent 和 Agents Team 到底是什么关系？

这本书不复述按钮怎么点。它沿着一条更有用的路径往下拆：从界面行为找到本地文件，再从本地文件还原一次请求是怎样被拼装出来的。

直接阅读

PDF 文件较大，GitHub 在线预览可能加载不完整，建议下载后阅读。

适合谁

• 天天在用 WorkBuddy，但遇到“不生效、行为怪、插件装完反而变笨”时不知道从哪里排查的人。
• 想弄懂系统提示词、身份、记忆、插件和项目上下文如何共同进入一次请求的 Agent 实践者。
• 需要安全定制 WorkBuddy，或要把 Harness 机制讲给学员、同事和客户的工程师与讲师。
• 用过 Claude Code、Codex 等 Coding Agent，想理解 WorkBuddy 图形界面背后运行机制的人。

读完能解决什么

1. 建立一套可迁移的 Harness 心智模型，而不是背功能菜单。
2. 在本机找到 WorkBuddy 关键目录，并理解每一层文件负责什么。
3. 说清插件、专家、Skill、Connector、SubAgent 与 Agents Team 的关系。
4. 看懂身份、记忆、插件注入和项目上下文如何拼成系统提示词。
5. 用“层级 → 优先级 → 缓存 → 同步 → 版本”五步路径排查为什么配置没有生效。
6. 在安装插件或修改配置前，先判断注入面、权限面与隐私风险。

全书结构

两条推荐阅读路线

• 只想把 WorkBuddy 用稳： 1 → 2 → 3 → 5 → 7 → 12 → 14。
• 想做深度定制或讲课： 在主路线基础上补 4 → 6 → 8 → 9 → 10 → 13 → 15。

书中一页

这张图概括了全书的方法：每一个产品层级，都要能落回本地证据，并在书中找到对应解释。

版本与证据边界

• 目标版本： WorkBuddy 5.3.13（build 20fd9da5c9a0cac41feb61b133f7bce4fe183a89）。
• 声明环境： macOS 本地安装与运行时观测。
• 资料截止： 2026-08-15。
• 证据规模： 12 个来源、27 条 Claim，关键结论覆盖率 100%。
• 研究边界： 只解释本地文件、官方资料和可观测运行时能够支持的结论；不把闭源内部实现的推断写成事实。

WorkBuddy 更新很快。书中的路径、字段和默认行为都应放在上述版本边界内理解；使用更新版本时，请同时核对官方文档和本机实际结果。

本书是独立研究与实践指南，与 WorkBuddy 及相关厂商无隶属或官方合作关系。

许可

• 原创正文与确定性知识图：CC BY-SA 4.0。
• 原创示例代码：MIT。
• 第三方材料遵循其原始许可。
• 智见 AI 名称、Logo、智见小蓝角色设定与品牌母资产保留权利，不随正文许可开放。

完整边界见 LICENSES.md。文件完整性可通过 CHECKSUMS.sha256 核验。

关于作者

大鹏｜智见 AI

智见科技创始人，AI 落地顾问、企业与高校培训讲师，长期研究 Agent、Skill、Context Engineering 与 AI 编程工作流。

• GitHub：@zjp1997720

仓库边界

这个仓库只发布读者交付物：自包含 HTML、PDF、许可、校验和与经批准的展示图片。它不包含内部写书 Skill、作者画像、研究控制面、审稿记录、构建中间件或生产工作流。

如果你发现版本差异、事实错误或阅读问题，请直接提交 Issue。