mcpField
H
harness-engineering-zh

harness-engineering-zh

github.com/10xchengtuAgent workflows10392 installsUpdated 12w ago
Repository

About harness-engineering-zh

harness-engineering-zh is a skill for setting up, diagnosing, and incrementally improving the operating environment around project AI agents. It covers context, guardrails, evaluation, multi-agent work, long-running tasks, loops, and memory.

Key features

  1. 01Project setup and context design
  2. 02Constraints and guardrails
  3. 03Multi-agent coordination
  4. 04Evaluation and feedback loops
  5. 05Long-running task support
  6. 06Cross-session memory and diagnosis

Use cases

  1. 01Set up an agent harness for a new project
  2. 02Diagnose poor agent performance
  3. 03Improve an existing harness incrementally
  4. 04Support unattended or long-running agent work

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/10xchengtu/harness-engineering --skill harness-engineering-zh

After installing, type/harness-engineering-zhin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
01-project-setup.md
02-context-engineering.md
03-constraints.md
04-multi-agent.md
05-eval-feedback.md
06-long-running.md
07-diagnosis.md
08-loops.md
09-memory.md

Details

From the project README

Harness Engineering

Harness = 为项目中工作的 AI Agent 提供的操作系统。Model 是 CPU，Context 窗口是 RAM，Harness 则是操作系统。

核心原则

从简单开始，仅在必要时增加复杂度。 每一个 Harness 组件都代表了对模型无法独立完成任务的一种假设。要对这些假设进行压力测试 — 随着模型能力的提升，这些假设会失效。为"删除"而构建。

何时激活此 Skill

信号行动
空项目/新项目→ 进行完整的项目设置 (Section 1)
用户对 Agent 感到沮丧→ 诊断并修复 Harness 缺失 (Section 7)
现有项目需要改进→ 评估并逐步改进
明确的 Harness 问题→ 参考相关章节

工作流

对于新项目
  1. 评估 (Assess) — 项目是什么？技术栈？团队规模？Agent 将如何被使用？
  2. 设置 (Setup) — 创建基础 Harness 文件 → 阅读 references/01-project-setup.md
  3. Context — 设计信息架构 → 阅读 references/02-context-engineering.md
  4. 约束 (Constraints) — 添加护栏和 Linters → 阅读 references/03-constraints.md
  5. 评估 (Evaluate) — 设置反馈循环 → 阅读 references/05-eval-feedback.md
  6. 如果项目涉及多 Agent 或长任务 → 阅读 references/04-multi-agent.md, references/06-long-running.md
  7. 如果 Agent 将无人值守运行（定时任务、CI 循环）→ 阅读 references/08-loops.md；如果希望 Agent 跨会话越用越懂 → 阅读 references/09-memory.md
对于诊断 (Agent 表现不佳)
  1. 立即阅读 references/07-diagnosis.md
  2. 识别是哪一层 Harness 出现了问题
  3. 从相关参考文档中应用针对性修复
对于逐步改进

评估当前 Harness 的成熟度，识别最薄弱的层级，一次改进一个层级。

Harness 层级 (快速参考)

层级内容参考文档
项目设置 (Project Setup)AGENTS.md, docs/, 目录规范01-project-setup.md
Context 工程 (Context Engineering)Agent 看到的信息、渐进式展示、工作状态02-context-engineering.md
约束与护栏 (Constraints & Guardrails)Linters、类型系统、架构强制执行、安全自主权03-constraints.md
多 Agent 架构 (Multi-Agent Architecture)Agent 分离、协作协议、委派模式04-multi-agent.md
Eval 与反馈 (Eval & Feedback)测试、评分、GC Agent、可观测性05-eval-feedback.md
长运行任务 (Long-Running Tasks)进度跟踪、Context 重置、交付产物06-long-running.md
循环 (Loops)验证器、停止条件、护栏、自主运行08-loops.md
记忆 (Memory)跨会话记忆、index-then-fetch、记忆整理、遗忘09-memory.md
诊断 (Diagnosis)当 Agent 失败时 — 在 Harness 中识别根因，而非模型07-diagnosis.md

自我更新协议

当你在项目中发现新的可复用 Harness 模式时：

  1. 识别它属于哪个参考文件（或者是否需要一个新文件）
  2. 添加该模式，包括：它解决了什么问题，何时使用，以及如何实现它
  3. 保持简洁 — 拒绝废话，只保留模式

Comments

Markdown supported