harness-creator

Harness Creator

使用 Fusion Architecture 为你的项目生成定制的 Claude Code harness 框架：受 GAN 启发的多 Agent 系统 + 领域专家。

快速开始

/harness-creator [target-dir]

• 带参数：使用指定目录
• 不带参数：询问目标目录
• 新项目（0→1）：完整的头脑风暴流程
• 现有项目（1→N）：自动分析并快速设置

---

Fusion Architecture

核心模式：受 GAN 启发的多 Agent 系统

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   Planner   │ ──► │  Generator  │ ──► │  Evaluator  │
│  (Plans)    │     │ (Implements)│     │  (Grades)   │
└─────────────┘     └──────┬──────┘     └─────────────┘
                           │
                    spawns specialists
                           │
              ┌────────────┼────────────┐
              ▼            ▼            ▼
        ┌──────────┐ ┌──────────┐ ┌──────────┐
        │ frontend │ │   api    │ │ database │
        │   -dev   │ │   -dev   │ │   -dev   │
        └──────────┘ └──────────┘ └──────────┘

为什么要分开 Agent？ 模型无法可靠地评估自己的工作。它们会夸奖平庸的输出，并忽略边缘情况。分离角色可以实现客观的质量评估。

三层架构

层	Agent	职责
决策	Planner、architect-lead	产品与架构决策
执行	Generator、[domain]-dev	实现功能
评估	Evaluator	测试并评估实现

关键组件

组件	用途
Sprint Contract	在实现前协商“完成”标准
Domain Specialists	按领域划分的专业实现 Agent
Evaluation Criteria	将主观判断转化为可评分的标准
Context Reset	为长时间运行的任务提供结构化交接

---

工作流

1. 解析参数

• 验证目标路径
• 如果未提供，则询问用户：

  Where should I generate the harness?
  A) Current directory: .
  B) Specify path: [input]
  C) Create new project: [name]
  

2. 分析目标目录

自动检测：

• 项目类型：package.json → Node.js，pyproject.toml → Python
• 架构：services/ → 微服务，apps/ + packages/ → 单体仓库
• 技术栈：从配置文件中读取依赖项
• 模块边界：检测 src/、apps/、packages/
• 领域类型：与领域模板匹配

生成分析报告 → 用户确认或调整

3. 领域检测（v2.0 新增）

Analyze project structure
        │
        ▼
┌─────────────────────────────────────┐
│ Match against domain templates:     │
│                                     │
│ • web-development   (frontend+api+db)│
│ • game-development  (gameplay+gfx+audio)│
│ • data-science      (ml+data+analysis)│
│ • mobile-app        (ios+android)│
│ • ...                               │
└─────────────────────────────────────┘
        │
        ├─────────────┬─────────────┐
        ▼             ▼             ▼
   Matchfound    No match      User specifies
        │             │             │
        ▼             ▼             ▼
   Use template   Dynamic gen   Custom config

4. 专家选择

检测到项目类型: Game Development (Unity)

推荐的配置:

核心 Agents (固定):
  Planner        - 产品规划
  Generator      - 协调执行 (+Agent工具)
  Evaluator      - 评估实现
  architect-lead - 架构决策

Specialists (可调整):
  [√] gameplay-dev    游戏逻辑、机制、AI
  [√] graphics-dev    渲染、shader、特效
  [√] audio-dev       音效、音乐系统
  [ ] physics-dev     物理模拟、碰撞检测
  [√] ui-dev          游戏UI、HUD、菜单

操作:
  A) 直接使用推荐
  B) 调整选择
  C) 添加自定义 specialist
  D) 查看详情

5. 生成 Harness（并行执行）

使用子 Agent 并行生成组件以提高速度：

User confirms generation│
        ├─► Subagent 1: Core agents (planner, generator, evaluator, architect-lead)
        │
        ├─► Subagent 2: Domain specialists (from template or dynamic)
        │
        ├─► Subagent 3: Evaluation system (skills, templates, docs)
        │
        ├─► Subagent 4: Progress system (skills, hooks, templates)
        │
        ├─► Subagent 5: Safety system (hooks, rules, docs)
        │
        ├─► Subagent 6: Domain-specific skills and rules
        │
        └─► Main thread: Integrate results + generate settings.json

6. 生成后的指导

✅ Harness generated at [target-dir]/.claude/

Next steps:
1. cd [target-dir]
2. claude
3. Run /start

---

领域模板系统

模板位置

domain-templates/
├── web-development/      # Web应用模板│   ├── template.yaml
│   └── specialists/
│       ├── frontend-dev.yaml
│       ├── api-dev.yaml
│       ├── database-dev.yaml
│       └── devops-dev.yaml
│
├── game-development/     # 游戏开发模板
│   ├── template.yaml
│   └── specialists/
│       ├── gameplay-dev.yaml
│       ├── graphics-dev.yaml
│       ├── audio-dev.yaml
│       └── ui-dev.yaml
│
├── data-science/         # 数据科学模板│   └── ...
│
└── _dynamic/             # 动态生成│   ├── specialist-template.yaml
    └── detection-rules.yaml

模板结构（template.yaml）

template:
  name: game-development
  version: 1.0.0
  
  # Detection rules
  detection:
    files: ["*.unity", "*.gd"]
    directories: ["Assets/", "Scripts/"]
    keywords: ["game", "unity"]
  
  # Core agents (fixed)
  core_agents:
    - planner
    - generator
    - evaluator
    - architect-lead
  
  # Domain specialists
  specialists:
    - name: gameplay-dev
      source: ./specialists/gameplay-dev.yaml
    - name: graphics-dev
      source: ./specialists/graphics-dev.yaml

专家定义

name: gameplay-dev
description: "Specialist for gameplay logic"

delegation:
  mode: spawned_by_generator
  contract_required: true

domain_scope:
  directories:
    - "Scripts/Gameplay/"
    - "Scripts/AI/"responsibilities:
  - Implement game mechanics
  - Create state machines
  - Implement AI behavior

anti_patterns:
  - "Don't put rendering code in gameplay scripts"

---

生成的 Harness 结构

<target-dir>/
├── .claude/
│   ├── settings.json
│   ├── agents/
│   │   ├── planner.md
│   │   ├── generator.md          # + Agent 工具
│   │   ├── evaluator.md
│   │   ├── architect-lead.md
│   │   └── [domain]-dev.md        # 领域 specialist
│   ├── skills/
│   │   ├── start/
│   │   ├── checkpoint/
│   │   ├── resume/
│   │   ├── sprint-contract/
│   │   └── [domain-specific]/     # 领域特定 skills
│   ├── hooks/
│   ├── rules/
│   ├── evaluation/
│   └── docs/
├── production/
│   ├── session-state/
│   └── session-logs/
└── CLAUDE.md

---

核心原则

1. Generator-Evaluator 分离：绝不使用同一个 Agent
2. 优先制定 Sprint Contract：构建前协商“完成”标准
3. 领域专家：由 Generator 委派，负责专业实现
4. Context Reset：长任务使用交接产物
5. 具体标准：将主观判断转化为可评分的标准

---

参考

设计基于 Anthropic：长时间运行的应用的 Harness 设计