harness-engineering-playbook

Harness Engineering Playbook 是一个兼容 skills.sh 的技能，用于将 OpenAI Harness Engineering 指南中的实践操作化，帮助在任意仓库中搭建或重构面向智能体的工作流，使自主运行可重复、可观测且安全。

用途 该技能面向需要让自主智能体在代码仓库中稳定运行的场景，通过标准化产物和命令，减少运行过程中的不确定性与风险。

主要能力

• 引导生成 harness 产物：AGENTS.md、PLANS.md、docs/ARCHITECTURE.md、docs/OBSERVABILITY.md、Makefile.harness 以及 CI 工作流。
• 将确定性命令封装在 make smoke、make check、make ci 之后，使智能体能够可靠地运行这些命令。
• 强制严格的模块边界与数据形状契约。
• 从第一天起接入结构化可观测性（关联 ID、关键状态转换）。
• 加入熵控制审计与夜间 harness 检查，防止文档漂移和脚本不稳定。

使用方式 安装命令： npx skills add broomva/harness-engineering-skill --skill harness-engineering-playbook

工作流：

1. 对目标仓库进行基线检测——识别语言、工具链和现有 CI。
2. 从模板引导生成 harness 产物（交互式向导或 shell 脚本）。
3. 在仓库产物中应用九项 Harness Engineering 实践。
4. 通过 audit 进行校验——任何 MISSING 或 FAIL 均视为阻塞。
5. 在真实智能体运行后迭代——修补缺口并重新审计。

快速开始：

交互式向导（推荐）

python3 .agents/skills/harness-engineering-playbook/scripts/harness_wizard.py init <repo-path> --profile control

Shell 备用方案

./scripts/bootstrap_harness.sh <repo-path>

审计

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

配置档：

• baseline：仅核心 harness 产物。
• control：baseline 加控制系统原语。
• full：control 加熵控制、夜间审计、CI。

适用场景 适用于需要为自主智能体建立可重复、可观测、安全运行环境的代码仓库，尤其是希望采用 OpenAI Harness Engineering 实践的团队。

限制 资料未提供关于收费、价格、平台支持范围、具体效果或性能指标的信息。来源为 OpenAI Harness Engineering 指南，许可证为 MIT。