mcpField
H
harness-engineering-playbook

harness-engineering-playbook

github.com/broomvaAgent 工作流26384 次安装17 周前更新
代码仓库

关于 harness-engineering-playbook

用于搭建或重构 Agent 优先工作流的 skills.sh 技能，面向希望让自主运行可重复、可观测且安全的工程团队。它通过模板、确定性命令和审计流程落实 Harness Engineering 实践。

主要功能

  1. 01生成仓库级 Harness 文档与配置
  2. 02封装 smoke、check、ci 命令
  3. 03设置模块边界与数据契约
  4. 04加入结构化可观测性
  5. 05审计文档漂移与不稳定脚本

适用场景

  1. 01为现有仓库搭建 Agent 工作流
  2. 02统一自主运行的检查命令
  3. 03审计并改进 Harness 配置

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/broomva/harness-engineering --skill harness-engineering-playbook

安装后在 Claude Code 中输入/harness-engineering-playbook确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
.skills/harness-engineering-playbook/agents/
openai.yaml
.skills/harness-engineering-playbook/assets/templates/
Makefile.harness
PLANS.md
AGENTS.md
.skills/harness-engineering-playbook/assets/templates/.github/workflows/
harness.yml
nightly-harness-audit.yml
.skills/harness-engineering-playbook/assets/templates/docs/
OBSERVABILITY.md
ARCHITECTURE.md
.skills/harness-engineering-playbook/assets/templates/docs/control/
ACTUATORS.md
CONTROL_SYSTEM.md
ENTROPY.md
CONTROLLER.md
FEEDBACK_LOOP.md
SETPOINTS.md
SENSORS.md
STABILITY.md
.skills/harness-engineering-playbook/assets/templates/evals/
control-loop-metrics.yaml
.skills/harness-engineering-playbook/assets/templates/scripts/
audit_harness.sh
.skills/harness-engineering-playbook/assets/templates/scripts/harness/
entropy_check.sh
lint.sh
smoke.sh
test.sh
typecheck.sh
.skills/harness-engineering-playbook/references/
openai-harness-practices.md
rollout-checklist.md
wizard-cli.md
.skills/harness-engineering-playbook/scripts/
audit_harness.sh
bootstrap_harness.sh
harness_wizard.py

详细介绍

Harness Engineering 实践指南

一个兼容 skills.sh 的技能，将 OpenAI Harness Engineering 指南中的实践付诸实施。使用它来搭建或重构以 Agent 为先的工作流，让自主运行可重复、可观测且安全。

安装

npx skills add broomva/harness-engineering-skill --skill harness-engineering-playbook

功能

  • 引导创建 Harness 文件：AGENTS.md、PLANS.md、docs/ARCHITECTURE.md、docs/OBSERVABILITY.md、Makefile.harness 和 CI 工作流。
  • 将确定性命令封装在 make smoke、make check、make ci 后，供 Agent 可靠地运行。
  • 强制执行严格的模块边界和数据形状约定。
  • 从第 1 天起接入结构化可观测性（关联 ID、关键状态转换）。
  • 添加熵控制审计和每夜 Harness 检查，防止文档偏移和脚本不稳定。

工作流

  1. 建立基线：检查目标代码仓库，检测语言、工具链和现有 CI。
  2. 搭建：使用模板生成 Harness 文件（通过交互式向导或 Shell 脚本）。
  3. 应用：在代码仓库文件中落实九项 Harness Engineering 实践。
  4. 验证：运行 audit，将任何 MISSING 或 FAIL 视为阻塞项。
  5. 迭代：根据真实的 Agent 运行结果修补缺漏，并重新审计。

快速开始

# Interactive wizard (recommended)
python3 .agents/skills/harness-engineering-playbook/scripts/harness_wizard.py init <repo-path> --profile control

# Shell fallback
./scripts/bootstrap_harness.sh <repo-path>

# Audit
python3 .agents/skills/harness-engineering-playbook/scripts/harness_wizard.py audit <repo-path>

配置方案

配置方案范围
baseline仅包含核心 Harness 文件
control基线 + 控制系统原语
full控制 + 熵控制、每夜审计、CI

来源

OpenAI Harness Engineering 指南：https://openai.com/index/harness-engineering/

许可证

MIT

评论

支持 Markdown