mcpField
H
harness-engineering

harness-engineering

github.com/kangarookingAgent 工作流693181 次安装8 周前更新
代码仓库

关于 harness-engineering

harness-engineering 是用于在项目目录中初始化 Harness Engineering 框架的技能，面向希望采用结构化 AI 辅助开发的项目团队。它配置规划、实现与评估 Agent、迭代工作流及质量钩子。

主要功能

  1. 01初始化项目框架文件
  2. 02配置规划、实现和评估 Agent
  3. 03制定可验证的冲刺完成条件
  4. 04添加循环检测和完成检查钩子
  5. 05提供计划、构建、测试和冲刺命令

适用场景

  1. 01为新项目搭建 AI 辅助开发流程
  2. 02在现有项目中配置计划、构建与验证循环

安装

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

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

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

包含的文件

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

scripts/
scaffold.py
templates/
CLAUDE.md
settings.json
templates/agents/
doc-gardener.md
evaluator.md
generator.md
planner.md
templates/commands/
build.md
plan.md
qa.md
sprint.md
templates/docs/
architecture.md
golden-principles.md
sprint-workflow.md
templates/docs/contracts/
TEMPLATE.md
templates/hooks/
context-injector.py
loop-detector.py
pre-completion-check.py

详细介绍

Harness 工程框架

一键在任意项目目录中初始化完整的 Harness 工程框架。

此技能基于 OpenAI（Codex）、Anthropic（3-agent GAN 架构）和 LangChain（自我验证循环）的经验，创建以下配置：

  • 3-agent 架构：规划器（规格）、生成器（构建）、评估器（测试）
  • Sprint 合约：编码前设定可由机器验证的“完成”标准
  • 质量钩子：循环检测、完成前检查清单、上下文注入
  • 斜杠命令：/plan、/build、/qa、/sprint
  • 黄金原则：由所有 Agent 严格遵守的 10 条不可妥协规则

适用场景

  • 启动新项目，并希望采用结构化的 AI 辅助开发
  • 希望在当前项目中设置 Plan-Build-Verify-Fix 工作流
  • 用户提到“harness”、“init harness”、“setup framework”或类似表述

初始化流程

步骤 1：收集项目信息

生成文件前，询问用户：

  1. 项目名称（或根据当前目录名称自动识别）
  2. 技术栈（可选，例如“React + Node.js”、“Python FastAPI”、“Go 微服务”）
  3. 项目类型（Web 应用、API 服务、CLI 工具、库等）

如果用户使用 /harness <description> 提供描述，请从上下文中提取相关信息。

步骤 2：生成框架文件

执行脚手架脚本：

python3 {{SKILL_PATH}}/scripts/scaffold.py --project-name "<PROJECT_NAME>" --tech-stack "<TECH_STACK>" --project-type "<PROJECT_TYPE>" --target-dir "<CURRENT_PROJECT_DIR>"

此脚本会在当前项目中生成以下结构：

<project>/
  CLAUDE.md                        # Project map (<80 lines)
  .claude/
    agents/
      planner.md                   # Spec creation agent
      generator.md                 # Implementation agent
      evaluator.md                 # Testing/grading agent
      doc-gardener.md              # Doc freshness agent
    commands/
      plan.md                      # /plan command
      build.md                     # /build command
      qa.md                        # /qa command
      sprint.md                    # /sprint command
    hooks/
      loop-detector.py             # File edit loop detection
      pre-completion-check.py      # Task completion checklist
      context-injector.py          # Session context middleware
  docs/
    architecture.md                # System design
    golden-principles.md           # Non-negotiable rules
    sprint-workflow.md             # Sprint process
    contracts/
      TEMPLATE.md                  # Sprint contract template
    specs/                         # (populated by planner)
    plans/                         # (populated by planner)
步骤 3：配置钩子

生成文件后，将钩子配置合并到项目的 .claude/settings.json 中（或创建该文件）：

python3 {{SKILL_PATH}}/scripts/merge_settings.py --target-dir "<CURRENT_PROJECT_DIR>"

这会添加钩子定义，同时保留现有设置。

步骤 4：验证安装

确认所有文件均已创建：

ls -la CLAUDE.md .claude/agents/ .claude/commands/ .claude/hooks/ docs/

向用户说明创建了哪些内容，以及如何开始使用。

初始化后的用法

命令用途
/plan <description>根据 1-4 句话创建功能规格说明
/build使用 Sprint 工作流构建最近的规格说明
/qa使用评估器检查当前代码
/sprint <description>从头开始执行完整的 Plan-Build-Verify 循环

关键原则

该框架强制执行以下规则（安装后请参阅 docs/golden-principles.md）：

  1. 先写规格，再写代码——没有书面规格，不得开始实现
  2. 标准可测试——每项功能都有可由机器验证的验收标准
  3. 先自我验证——评估器运行前，生成器必须先完成自检
  4. 关注循环——同一文件编辑 5 次或更多时，触发停止并重新评估
  5. 合约驱动——Sprint 合约在编码开始前定义“完成”标准

架构

如需了解完整详情，请在安装后阅读生成的 docs/architecture.md。主要流程如下：

User Prompt → Planner (spec) → Generator + Evaluator negotiate contract
→ Generator builds → Evaluator tests → Fix loop (max 3x) → Complete

评论

支持 Markdown