Agent Harness 工程阅读库

一份面向 AI 工程团队的中文 Agent Harness 阅读库。项目完整阅读三篇核心来源，并为每篇分别制作独立文档：

• Lingxi Li 的 Grok Bot for Engineering：一支工程 Bot 团队怎样实际运转。
• Lilian Weng 的 Harness Engineering for Self-Improvement：Harness 怎样从上下文、工作流走向自我改进。
• Mahax 的 Grok Bot. What It Is, and How to Actually Use It.：持续运行的角色 Bot 怎样进入普通工作流，以及哪些动作必须停在批准门前。

每份正文都有自己的论证、来源边界、目录、原创图和 PDF；网站首页只提供目录与切换入口。项目不把三篇文章合并为一篇长文，也不代表原作者的官方中文版。

在线阅读

• 阅读网站：https://yizhiyanhua-ai.github.io/agent-harness-engineering-zh/
• 文档 01：Grok Bot for Engineering · PDF
• 文档 02：Harness Engineering for Self-Improvement · PDF
• 文档 03：Grok Bot：使用与边界 · PDF

这份项目讨论什么

• 用七层运行栈说明 Harness 到底包裹了哪些系统能力。
• 还原领域 Bot、云端 Agent、私有 Worker、任务数据库和证据门的协作方式。
• 解释为什么长任务状态应落到可恢复工件，而不是只留在聊天上下文。
• 把提示、上下文、工作流、Harness 代码和优化器放进同一条优化路线。
• 给出弱点挖掘、有界提案、双层评测、接受/拒绝与版本观察组成的自我改进闭环。
• 用“影响面 × 验证强度”决定自动执行、人工抽查、批准后执行或只做方案。

本地阅读与验证

npm ci
npm run dev

完整验收：

npm test
npm run validate:content
npm run build
npm run validate:dist

PDF 由 scripts/build-pdf.py 生成，正文使用嵌入式中文字体、A4 页面、目录、页码和可选择文字。

每周官方资料发现

每周一 09:00（Asia/Shanghai）运行只读发现任务，从允许清单中的官方博客和项目 Release 获取元数据。候选按官方性、Agent/Harness 相关性、机制增量、证据和影响面筛选。

正式内容采用人工确认门：

1. 工作流创建候选 Issue，网站和正文不变。
2. Brad 打开原文，勾选候选并添加 approved-for-update 标签。
3. 独立工作流核对操作者、来源允许清单、候选哈希、链接、测试与构建。
4. 全部通过才写入 src/data/updates.json 并部署网站。
5. 没有明确确认或任一验证失败，本周零更新。

仓库管理员需要配置：

• Actions variable APPROVER_LOGIN：允许确认候选的 GitHub 账号。
• Actions secret CANDIDATE_SIGNING_KEY：至少 32 字节，用于冻结候选内容。

来源和评分规则位于 config/。

项目结构

content/                    中文综合稿与来源账本
public/assets/diagrams/     原创 Agent Harness 系统图
public/downloads/           中文 PDF
src/                        React 阅读网站
config/                     周更来源与评分规则
scripts/                    PDF、发现、批准应用与校验
.github/workflows/          CI、Pages、周更发现与确认后更新

许可

• 站点代码：MIT。
• 本项目独立中文综合稿、原创图和站点文案：CC BY-SA 4.0。
• 外部网页、论文、截图、商标和项目名称不包含在本项目许可中。

完整说明见 NOTICE.md。