学习 Harness 工程
通过实践课程，学习如何为 AI 编程智能体构建环境、状态管理、验证和控制机制，使它们可靠地完成真实任务。
证据显示：仓库是教学课程，不包含任何可执行代码或代理逻辑，因此没有权限请求、数据流或外部副作用。没有用户确认机制、敏感数据处理或回滚机制。依赖项仅用于文档构建，未发现安全审计。来源归属：README 引用了 OpenAI 和 Anthropic 的文章，但未提供具体版本或验证。扣分原因：由于没有实际代理行为，所有信任标准均得 0 分；来源归属仅部分满足，因为引用未经验证。
证据显示：README 和课程结构在描述课程内容时保持一致，没有明显矛盾。依赖项（vitepress、playwright 等）是常见的、可获取的，但未提供版本锁定或完整性校验。失败消息：没有提供任何错误处理或用户提示。扣分原因：自洽性和依赖可用性得 2 分，因为文档结构清晰且依赖常见；失败消息得 0 分，因为没有相关证据。
证据显示：课程面向初学者，提供了多语言支持和分阶段学习路径，适应不同场景。能力边界：课程明确说明是教学用途，但未详细说明其作为代理产品的边界。触发精度：没有定义任何触发条件。环境适配：提供了安装和构建说明，但未说明在不同操作系统或环境中的兼容性。扣分原因：受众和场景得 2 分，因为多语言和分阶段设计；能力边界得 1 分，因为边界描述不明确；触发精度得 0 分，因为没有触发机制；环境适配得 2 分，因为提供了构建说明。
证据显示：信息架构清晰，有目录和分章节结构。安装说明：提供了 npm 脚本和构建命令。命名稳定性：文件名如 claude-progress.md 被保留，但未说明命名约定。示例和 FAQ：提供了项目示例，但没有 FAQ。已知限制：未提及。许可证：MIT 许可证明确。版本和变更日志：有版本号 0.1.0，但无变更日志。维护责任：未明确说明。扣分原因：信息架构、安装说明、示例和许可证得 2 分；命名稳定性得 1 分，因为命名约定不明确；已知限制得 0 分，因为未提及；版本和变更日志得 1 分，因为只有版本号；维护责任得 1 分，因为未明确。
证据显示：输出可用性：课程提供了模板和资源，可直接使用。边际价值：课程提供了独特的视角，但作为代理产品，其直接价值有限。成本效益：课程是免费的，但需要时间投入。扣分原因：输出可用性得 2 分，因为模板实用；边际价值得 2 分，因为提供了独特内容；成本效益得 1 分，因为未提供成本分析。
证据显示：声明可追溯性：README 引用了 OpenAI 和 Anthropic 的文章，但未提供具体链接或版本。跨来源佐证：引用了多个来源，但未提供交叉验证。事实与推断分离：课程内容区分了事实和推断，但未明确标注。扣分原因：声明可追溯性得 1 分，因为引用不完整；跨来源佐证得 1 分，因为引用多个来源但未验证；事实与推断分离得 1 分，因为未明确标注。
- 该仓库是教学课程，不是可执行的代理产品，因此信任相关标准均不适用。
- 依赖项未锁定版本，存在供应链风险。
- 未提供已知限制或故障处理说明。
这个 Agent 能做什么，适合哪些场景？
Learn Harness Engineering 是一个以项目为基础的课程，专门教授 AI 编码智能体的工程化。它系统性地综合了 OpenAI、Anthropic 等行业领导者的前沿 Harness 工程理论与实践，并深度整合了《Awesome Harness Engineering》列表中的资源。该课程包含 14 讲理论课程和 8 个动手实践项目，所有项目都围绕一个 Electron 桌面知识库应用展开，从零开始逐步构建一个生产级的 harness。核心概念是构建一个包含五个子系统的完整工作环境：指令、状态、验证、范围控制和会话生命周期，这些子系统通过 AGENTS.md、init.sh、feature_list.json 和 claude-progress.md 等文件实现。课程支持 15 种语言，并提供 PDF 构建流程和 VitePress 文档网站，以及一个用于快速搭建 harness 的可复用 skill 和一个无依赖的审计脚本。无论你是正在使用编码智能体的工程师、研究者还是技术负责人，这门课程都能帮助你理解如何通过环境设计来提升智能体的稳定性和输出质量。
该仓库是一个教学课程，不仅教授理论，还提供可操作的工具和模板。它包含14个讲座（L01-L14），深入探讨从基础概念到循环工程和图工程的主题，提供8个项目（P01-P08），指导用户逐步构建一个完整的Agent harness。课程的核心交付物包括：AGENTS.md 和 CLAUDE.md 模板，用于定义智能体的操作手册；init.sh 脚本，用于初始化环境并运行健康检查；feature_list.json 文件，用于跟踪功能完成状态；claude-progress.md 文件，用于记录会话进度。此外，它还提供了一个名为 harness-creator 的 skill，可以自动生成生产级 harness 脚手架，以及一个名为 audit-harness.sh 的无依赖 shell 脚本，用于审计现有仓库是否满足五个 harness 子系统。课程内容以 VitePress 文档网站形式呈现，并提供多个语言的资源库，包含可直接复制的模板和清单。用户可以通过运行 npm run docs:dev 在本地预览文档。
- 使用 Claude Code 或 Codex 的工程师，希望减少智能体在完成任务时跳过步骤、破坏测试或过早宣布完成的情况。
- 技术负责人需要向团队解释为什么某些智能体可靠而另一些不可靠，并希望引入一套标准化的 harness 实践。
- 研究人员想要系统性地理解 harness 设计的不同方案和权衡，并参考社区积累的最佳实践。
- 课程学习者希望通过一个完整的 Electron 应用案例，跟随 8 个项目逐步从零构建一个完整的 harness，并对比前后差异。
- 开发者希望快速为现有项目生成一个包含 AGENTS.md、init.sh、feature_list.json 和验证流程的生产级 harness 脚手架。
- 团队希望使用无 Node.js 依赖的 audit-harness.sh 脚本，快速检查现有仓库是否满足 harness 的最佳实践。
这个 Agent 有哪些优点和局限？
- 基于项目实践，通过一个真实的应用案例（Electron 知识库应用）逐步构建 harness，让抽象概念变得具体。
- 覆盖了五个核心子系统（指令、状态、验证、范围、生命周期），提供可操作的模板和文件（AGENTS.md、init.sh、feature_list.json 等）。
- 课程内容翻译成 15 种语言，并附带 PDF 构建流程，方便不同语言背景的学习者使用。
- 提供了 reusable skill（harness-creator）和无依赖的审计脚本（audit-harness.sh），可以快速应用到实际项目中。
- 需要具备终端、git 和至少一种编程语言的经验，不适合完全的零基础学习者。
- 课程假设学习者拥有支持文件编辑、命令执行和多步任务的编码智能体工具，如 Claude Code 或 Codex，否则项目练习无法完成。
- 示例应用是 Electron 桌面应用，可能不适用于所有类型的项目，但课程的原则是通用的。
- 虽然课程覆盖了多种编程智能体，但并未提供针对特定工具（如 Codex 或 Claude Code）的详细配置指南，需要用户自行适配。
如何安装或部署这个 Agent？
git clone https://github.com/walkinglabs/learn-harness-engineering.git
cd learn-harness-engineering
npm install如何使用这个 Agent？
要本地预览文档，运行 npm run docs:dev 并打开输出的 URL。要生成 PDF 课程书，运行 npm run pdf:build，输出文件位于 artifacts/pdfs/。要使用 harness-creator skill，请按照 skills/harness-creator/ 中的说明将其安装到你的 IDE 或智能体工作区中。要快速审计现有仓库，可以运行 bash tools/audit-harness.sh /path/to/your/repo。