harness-optimizer

Use when用户提供会话 ID，想复盘会话或基于该会话优化指定的项目、workflow、skill 或 harness。

설치로 이동

저장소: evanfang0054/agent-harness
최근 소스 활동: 2026년 7월 27일 05:40
감지된 SKILL.md 언어: 중국어
스타: 0
포크: 0

설치 방법

기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.

npx skills add https://github.com/evanfang0054/agent-harness --skill harness-optimizer

명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.

로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.

소스 파일 검토

설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.

파일 탐색기

2 개 파일

SKILL.md

소스 지침 · 읽기 전용 미리보기

검색으로 돌아가기 설치로 돌아가기

brainstorming

You MUST use this before any creative work — features, components, behavior changes. Explores intent, requirements, and design before implementation.

2026-08-01

finishing-a-development-branch

Use when implementation is done and tests pass, and the user must choose how to integrate or retain completed branch work.

2026-08-01

receiving-code-review

Use when receiving code review feedback. Verify before implementing; technical correctness over blind agreement.

2026-08-01

이 저장소의 모든 Skills 보기

name	harness-optimizer
description	Use when用户提供会话 ID，想复盘会话或基于该会话优化指定的项目、workflow、skill 或 harness。
disable-model-invocation	true

Skill Self-Optimizer

Overview

从 Claude Code 历史会话中提取证据，由子 agent基于 JSON 样本生成分析报告，再由主 agent把建议优先对齐到用户明确指定的优化对象并实施优化。

核心原则： session 是分析样本，不等于优化对象。除非证据明确指向分析器或 harness-optimizer 本身，否则默认应先优化用户指定的项目、workflow、skill 体系或 harness。

核心流程： Session 提取 → 子 agent 分析并生成报告 → 识别真实优化对象 → 主 agent 基于报告优化目标对象 → 必要时再回收为自优化项

启动时宣布： "我正在使用 harness-optimizer 分析会话数据..."

When to Use

触发场景：

用户想分析某个 session 的效果
用户提供 session id，并要求“根据这个会话优化某个项目/仓库/skill/workflow”
需要基于历史数据优化 skill
想了解 skill 的实际使用情况
调试 skill 不工作的原因
实现 harness 自我闭环

目标对象判定：

如果用户明确说“优化这个项目 / 这个仓库 / 这套 agent-harness”，优先输出该对象的优化建议并在该对象上落地修改
如果用户明确说“优化这个 skill”或“优化分析器本身”，才把 harness-optimizer 当成主要优化对象
如果 session 命中了别的项目目录，要在分析报告里显式标注跨项目风险，避免把样本项目的问题误写成当前项目的问题

Session 数据位置

Claude Code 会话存储在：

~/.claude/projects/<encoded-project-path>/<session-id>.jsonl

每个项目路径会被编码（斜杠变连字符），例如：

/Users/user/Desktop/project → -Users-user-Desktop-project

Step 1: 获取 Session ID

方法1：当前会话

# 环境变量（在 skill 中可用）
echo $CLAUDE_SESSION_ID

方法2：列出项目会话

# 列出项目的所有会话（按时间排序）
ls -lt ~/.claude/projects/<project-path>/*.jsonl | head -20

方法3：用户直接提供 用户可以从 Claude Code 的 /resume 命令或 Ctrl+R 界面获取 session ID。

Step 2: 提取会话数据

使用提取脚本（路径必须锚定到插件根，不要用未定义的 ${SKILL_PATH}）：

python "${CLAUDE_PLUGIN_ROOT}/skills/harness-optimizer/scripts/extract-session.py" \
  --session-id <session-id> \
  --project-path=<encoded-project-path> \
  --output .agent-harness/session-analysis/<session-id>.json

注意： 当 project-path 本身以 - 开头（Claude 编码路径通常如此）时，必须使用 --project-path=<value> 这种等号写法，避免被 argparse 误识别为新选项。

输出格式：

{
  "session_id": "xxx",
  "start_time": "2024-01-01T10:00:00Z",
  "end_time": "2024-01-01T11:00:00Z",
  "duration_minutes": 60,
  "messages": [
    {"role": "user", "content": "...", "timestamp": "..."},
    {"role": "assistant", "content": "...", "timestamp": "..."}
  ],
  "tool_calls": [
    {"tool": "Read", "input": ...    
       ...      
  
    ...

当 session ID 已知但项目目录不确定时：

可以先照常传 --project-path=<encoded-project-path>
如果精确匹配失败，提取脚本会先尝试请求目录中的前缀匹配，再回退到 ~/.claude/projects/* 中全局查找
如果只有一个前缀候选，会自动命中并继续分析
如果前缀候选不止一个，脚本会列出候选并要求补全 session id
后续分析报告必须注明真实命中的 file_path / actual_project_dir

Step 3: 启动子 agent 分析 JSON 并生成报告

不要使用 analyze-session.py。提取完 JSON 后，直接启动一个只做分析、不写代码的子 agent，读取 JSON 并输出 markdown 报告。

要求：

子 agent 只负责分析和写报告，不负责改代码
报告必须基于提取出的 JSON 证据，不要虚构结论
报告必须区分：样本 session 来自哪里、用户真正要优化的对象是什么
如果命中了跨项目 session，要明确提醒这是样本来源，不等于当前要修改的项目
如果证据不足，要明确写 insufficient evidence
如果发现重复失败主要是无效 tool 参数、命令 shape 不稳定或重复重跑，优先把它们归类为 workflow / skill orchestration 问题，除非证据明确只属于样本项目

推荐子 agent 任务描述：

读取 .agent-harness/session-analysis/<session-id>.json，生成 .agent-harness/session-analysis/<session-id>-report.md。

目标：基于该 session 样本总结问题模式、关键证据、风险和优化建议。
限制：只做分析，不写代码，不修改目标项目。
必须包含：
1. Summary
2. Session Provenance
3. Issues Found
4. Optimization Recommendations
5. 明确说明建议应作用于哪个目标对象（用户指定项目 / workflow / skill / harness）

报告建议结构：

# Session Analysis Report

## Summary
- Duration: ...
- Tool Success Signals: ...
- Skills Used: ...
- Primary Optimization Target: ...

## Session Provenance
- Requested Project: ...
- Actual Session File: ...
- Actual Project Directory: ...
- Session Source: ...

## Issues Found
1. ...
   - Evidence: ...
   - Impact: ...
   - Confidence: high / medium / low

## Optimization Recommendations
- [ ] ...
- [ ] ...

## Targeting Decision
- Why these recommendations should apply to `<user-target>` instead of the sampled session project / harness itself

Step 4: 主 agent 基于报告优化用户指定对象

主 agent 读取报告后，先判断优化对象，再实施修改。

执行规则：

默认优先优化用户明确指定的项目 / 仓库 / workflow / skill
不要因为分析样本来自别的目录，就直接改样本目录
不要把 harness-optimizer 默认当成修复目标
只有当报告证据明确指出问题就在 harness-optimizer 自身时，才回收为自优化
如果重复失败主要表现为无效 tool 参数、重复命令重跑、路径或 package-root 判断错误，优先在当前项目的 workflow / skill 文案中做最小纠偏，而不是把下游 repo 当主修复对象

主 agent 的职责：

读取子 agent 报告
提炼与用户目标对象最相关的建议
在用户指定项目中搜索对应实现位置
进行最小必要修改
验证修改是否匹配报告结论

Step 5: 验证优化

修改 skill 或项目后，验证改进效果：

# 使用 skill-creator 的 eval 系统
# 创建测试用例
mkdir -p .agent-harness/skill-evals/<skill-name>/

# 运行测试
python -m skill_creator.scripts.run_eval \
  --skill-path skills/<skill-name> \
  --eval-set .agent-harness/skill-evals/<skill-name>/evals.json

完整闭环流程

┌─────────────────────────────────────────────────────────────┐
│                     Skill Harness-Optimizer                    │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  1. INPUT: Session ID                                       │
│     └─► extract-session.py                                 │
│                                                             │
│  2. EXTRACT: 会话数据                                       │
│     └─► messages, tool_calls, skills_used                  │
│                                                             │
│  3. ANALYZE: 子 agent 读取 JSON 生成报告                    │
│     └─► issues, evidence, targeting decision               │
│                                                             │
│  4. OPTIMIZE: 主 agent 基于报告优化用户指定目标             │
│     └─► project / workflow / skill / harness               │
│                                                             │
│  5. VERIFY: 验证测试                                        │
│     └─► skill-creator eval 系统                            │
│                                                             │
│  6. LOOP: 记录学习                                          │
│     └─► session-learnings 存储                             │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Quick Reference

# 列出项目会话
ls -lt ~/.claude/projects/<project-path>/*.jsonl | head -10

# 提取特定会话
python "${CLAUDE_PLUGIN_ROOT}/skills/harness-optimizer/scripts/extract-session.py" --session-id <id>

Integration

与其他 skill 协作：

session-learnings: 将分析发现存储为学习记录
skill-creator: 使用其 eval 系统验证优化
retrospective: 纳入定期回顾

Red Flags

立即分析当：

Skill 完全没有触发（应该触发时）
同一任务重试 3+ 次
用户明确表示不满
Token 消耗异常高

不要分析：

正常成功的会话（除非要学习成功模式）
非常短的测试会话
与 skill 无关的纯对话

harness-optimizer

소스 정보

설치 방법

소스 파일 검토

이 저장소의 다른 Skills

이 저장소의 다른 Skills

Skill Self-Optimizer

Overview

When to Use

Session 数据位置

Step 1: 获取 Session ID

Step 2: 提取会话数据

Step 3: 启动子 agent 分析 JSON 并生成报告

Step 4: 主 agent 基于报告优化用户指定对象

Step 5: 验证优化

完整闭环流程

Quick Reference

Integration

Red Flags

Skill Self-Optimizer

Overview

When to Use

Session 数据位置

Step 1: 获取 Session ID

Step 2: 提取会话数据

Step 3: 启动子 agent 分析 JSON 并生成报告

Step 4: 主 agent 基于报告优化用户指定对象

Step 5: 验证优化

完整闭环流程

Quick Reference

Integration

Red Flags