WorkBuddy Harness.pdf
这份《WorkBuddy Harness 技术与实践指南》蓝皮书，旨在通过深入拆解 WorkBuddy 这款 Agent 产品底层文件与运行机制，揭示其实现“AI 能力可交付”的工程奥秘。
**核心心智模型：Harness 五层架构**
文档将 WorkBuddy 的复杂性归纳为“Harness”（工程挽具）系统，并定义了官方五层模型：
1. **运行环境层**：决定 Agent 的物理操作边界（沙箱、文件系统、连接器）。
2. **引导层**：预置任务前提（提示词模板、身份、技能、规则）。
3. **反馈层**：实现自我修正（工具报错、审计日志、文件历史快照）。
4. **编排层**：管理能力组合（专家团、渐进式加载、模型路由）。
5. **迭代层**：反映产品演进节奏（更新日志）。
**关键运行机制：从文件到请求的拼装**
文档的核心论点是：WorkBuddy 的一切行为都源于本地 `~/.workbuddy/` 目录中的纯文本文件。
* **一次对话的本质**：是一个“拼装（引导）→ 推理 → 执行（工具）→ 记录（日志）→ 沉淀（记忆）”的循环。
* **系统提示词渲染**：WorkBuddy 不存在写死的“机器人”，而是通过 Jinja2 模板引擎，在每次请求前将模式片段、插槽变量、身份配置及专家人设实时拼装成完整的 Prompt。
* **身份与记忆体系**：采用三层结构（云端画像、用户级 MEMORY.md、项目级工作区日志），并通过文件分工（SOUL.md、IDENTITY.md、USER.md）定义人格。
**核心工程设计：文件管 Harness，数据库管调度**
文档强调了 WorkBuddy 的架构决策：
* **文件化存储**：提示词、技能、插件清单等资产均采用纯文本格式，不仅便于用户直接查看与自定义，还天然适配 Git 等版本管理体系，使得生态资产具备极高的可复用性。
* **防错与排查**：文档提出了“五步排查法”（查层级、查开关、查拼装、查缓存、查版本），并将“证据意识”贯穿始终，利用会话流水（JSONL）、执行轨迹（traces）和审计日志（audit-log）这“三本账”作为排查问题的物理现场。
**安全与供应链视角**
文档警示了 Agent 时代的特殊风险：
* **注入面风险**：插件和专家的规则（alwaysApply 规则）会随对话注入，存在提示词注入风险。
* **数据出域**：强调了外部工具接入（MCP/连接器）后的数据流向控制，并建议通过严格的“三问一习惯”（评估作者、内容、边界，检查本地实际文件）来管理插件供应链。
**实战意义**
本书不仅是 WorkBuddy 的技术说明书，更是一套 Agent 开发的方法论：
* 对于普通用户，通过“修改配置文件”而非“提示词工程”来定制 AI 助手。
* 对于开发者，通过这种“标准化配置+标准格式”的设计，可以将代码助手快速转化为通用业务 Agent，实现知识与能力在不同项目间的版本化管理。
简而言之，WorkBuddy Harness 的本质是利用成熟的开发者工程底座，通过“界面 UI → 本地文件 → API 请求”的透明映射，将 AI 从模糊的黑盒变成了可治理、可定制、可追溯的业务工具。
相关报告
-
3.85 MB 69页 Harness Engneering—驯服Agent从理论到落地-北京大学-202607.pdf
-
24.43 MB 78页 驾驭工程（Harness Engineering）研究报告-清新研究-202603.pdf
-
3.83 MB 91页 电子：HarmonyOS 6.0安全技术白皮书.pdf
-
10.6 MB 57页 2026-ai-research-report_zh-TW.pdf
-
1.66 MB 128页 ACCC DPSI Consumer Survey Research Report.pdf
-
7.01 MB 2061页 不被理解的毛泽东 (虚声) (Z-Library).pdf
-
28.02 MB 81页 Arcadis凯谛思：《设计视野》趋势预测报告2025.pdf
-
7.31 MB 148页 ARK：Big Ideas 2025.pdf
-
15.04 MB 30页 2025短剧营销趋势洞察报告-Morketing Research-202510.pdf
-
6.55 MB 29页 2025消费行业年度趋势报告-PeopleSearch-202509.pdf
-
3.55 MB 160页 2025年AI就绪指数报告：Arm AI Readiness Index full-report.pdf
-
17.51 MB 60页 KVIC_Market Watch_Quarterly Journal_Q4 2024.pdf
-
957.87 KB 14页 2025Q1人工智能现状分析：中国-Artificial Analysis-202504.pdf