Menu
合并子代理结果到主项目，更新功能清单，清理子代理目录
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
EnjoyHarness 唯一强制入口，初始化全局状态、文件体系、技能注册表
配置文件读取和验证技能，确保用户配置正确且完整
全流程自动执行超级组合技能，编排所有16个基础技能，从用户需求到完整交付的全自动化流程
头脑风暴技能，在实现前探索用户意图、需求和设计，防止返工
实施计划执行技能，逐任务执行实施计划，支持检查点、错误恢复和进度跟踪
10倍产能提效超级组合技能，通过并行执行、智能调度、优化策略实现10倍开发效率提升
| name | harness-merge-agent-results |
| description | 合并子代理结果到主项目，更新功能清单，清理子代理目录 |
| trigger_words | ["harness-merge-agent-results","合并子代理结果","merge agent results"] |
| priority | MEDIUM |
| dependencies | ["harness-monitor-agent-batch"] |
| version | v1.0.0 |
合并子代理结果到主项目，更新 feature_list.json，清理子代理目录。
核心职责：
RESULT.md）feature_list.json（passes: false → true）EVENT_LOG.md（FEATURE_COMPLETE 事件）GLOBAL_STATE.md 的 active_subagents 条目工具: Read
文件: .subharness/{feature-id}/RESULT.md
Token 消耗: ~200 tokens
失败处理:
- 如果文件不存在 → 记录错误，触发自动失败处理
- 如果文件损坏 → 记录错误，触发自动失败处理
验证项:
1. 功能开发完成（RESULT.md 包含 "功能开发完成" 标记）
2. 测试通过（RESULT.md 包含 "测试通过" 标记）
3. 清洁状态检查通过（RESULT.md 包含 "清洁状态: CLEAN" 标记）
处理逻辑:
- 所有验证项通过 → 继续执行
- 任一验证项失败 → 记录错误，触发自动失败处理
Token 消耗: ~100 tokens
工具: Bash
命令: git merge {feature-branch}
前置检查:
- 检查是否有 Git worktree（.subharness/{feature-id}/WORK_TREE）
- 检查是否有未提交更改
Token 消耗: ~500 tokens
失败处理:
- 如果 Git merge 冲突 → 记录到 EVENT_LOG.md，先尝试自动冲突处理
- 如果合并失败 → 记录错误，触发自动失败处理；仅真实阻塞时升级人工介入
工具: Read + Edit
文件: .EnjoyHarness/feature_list.json
修改字段: passes: false → true（对应功能）
验证:
- 使用 Python jsonschema 验证 JSON 格式
- 确保仅修改 passes 字段
Token 消耗: ~100 tokens
失败处理:
- 如果 JSON 格式错误 → 记录错误，拒绝写入
- 如果功能ID不存在 → 记录错误，退出执行
工具: Edit
文件: .EnjoyHarness/EVENT_LOG.md
追加内容:
- 时间戳：2026-03-28T14:00:00
- 事件类型：FEATURE_COMPLETE
- 功能ID：{feature-id}
- 合并状态：成功/失败
- 清理状态：已清理/未清理
Token 消耗: ~100 tokens
工具: Edit
文件: .EnjoyHarness/GLOBAL_STATE.md
修改字段: active_subagents: [FEAT-001, FEAT-002] → [FEAT-002]（移除已完成的子代理）
Token 消耗: ~50 tokens
工具: Bash
命令: rm -rf .subharness/{feature-id}
前置确认:
- 功能已标记为完成（feature_list.json passes: true）
- EVENT_LOG.md 已更新
- GLOBAL_STATE.md 已更新
Token 消耗: ~50 tokens
失败处理:
- 如果清理失败 → 记录警告，继续执行（不阻塞流程）
- 记录待清理项并交给后续自动清理链路
输出格式:
🎉 子代理结果合并完成
功能ID: {feature-id}
功能描述: {description}
合并状态: 成功
清理状态: 已清理
更新文件:
- feature_list.json (passes: true)
- EVENT_LOG.md (FEATURE_COMPLETE)
- GLOBAL_STATE.md (active_subagents 已移除)
下一步: 继续监控其他子代理
Token 消耗: ~200 tokens
必须满足：
RESULT.md）GLOBAL_STATE.md 的 active_subagents 包含该功能ID如果前置条件不满足：
成功标准：
feature_list.json（passes: true）EVENT_LOG.md（FEATURE_COMPLETE 事件）GLOBAL_STATE.md（移除 active_subagents）失败情况：
检测: Read 失败
处理:
1. 记录到 EVENT_LOG.md（ERROR | RESULT_FILE_NOT_FOUND）
2. 触发 harness-handle-failure
3. 退出执行
检测: RESULT.md 缺少必要标记（功能完成、测试通过、清洁状态）
处理:
1. 记录到 EVENT_LOG.md（ERROR | RESULT_VALIDATION_FAILED）
2. 列出缺失的验证项
3. 触发 harness-handle-failure
4. 退出执行
检测: git merge 返回冲突
处理:
1. 记录到 EVENT_LOG.md（ERROR | GIT_MERGE_CONFLICT）
2. 输出冲突文件列表
3. 触发 harness-handle-failure 或自动冲突修复
4. 仅在真实阻塞时升级 harness-escalate-to-human
检测: Python jsonschema 验证失败
处理:
1. 记录到 EVENT_LOG.md（ERROR | JSON_VALIDATION_FAILED）
2. 输出验证错误详情
3. 拒绝写入 feature_list.json
4. 触发 harness-handle-failure
检测: rm -rf 返回错误
处理:
1. 记录到 EVENT_LOG.md（WARNING | CLEANUP_FAILED）
2. 记录到自动清理待办列表
3. 继续执行（不阻塞流程）
合并成功:
- 触发 harness-track-feature-progress（标记完成，选择下一个功能）
合并失败:
- 先触发 harness-handle-failure
- 仅真实阻塞时触发 harness-escalate-to-human
触发时机:
- harness-monitor-agent-batch 检测到子代理完成（status: COMPLETED, clean_state: true）
- 用户显式调用："合并子代理结果 {feature-id}"
必须依赖:
- harness-monitor-agent-batch（子代理完成检测）
- harness-handle-failure（默认失败处理）
- harness-escalate-to-human（真实阻塞升级）
单个子代理合并:
- Read RESULT.md: ~200 tokens
- 验证结果: ~100 tokens
- Git merge: ~500 tokens
- 更新 feature_list.json: ~100 tokens
- 更新 EVENT_LOG.md: ~100 tokens
- 更新 GLOBAL_STATE.md: ~50 tokens
- 清理子代理目录: ~50 tokens
- 输出报告: ~200 tokens
总计: ~1300 tokens
批量合并（3个子代理）:
- 顺序执行: 3 * 1300 = 3900 tokens
- 优化空间: 可批量更新文件，降低重复读写
性能对比:
- v1.0（手动合并）: ~5000 tokens per 子代理
- v2.0（自动合并）: ~1300 tokens per 子代理
- 性能提升: 降低 74% ✅
输入:
feature_id: FEAT-001
子代理状态: COMPLETED
清洁状态: true
RESULT.md:
- 功能开发完成: ✅
- 测试通过: ✅
- 清洁状态: CLEAN ✅
处理:
1. Read .subharness/FEAT-001/RESULT.md
2. 验证结果完整性（全部通过）
3. Git merge FEAT-001-branch → 成功
4. Edit feature_list.json（FEAT-001 passes: false → true）
5. Edit EVENT_LOG.md（FEATURE_COMPLETE | FEAT-001）
6. Edit GLOBAL_STATE.md（active_subagents: [FEAT-002, FEAT-003]）
7. Bash rm -rf .subharness/FEAT-001
8. 输出合并报告
输出:
🎉 子代理结果合并完成
功能ID: FEAT-001
功能描述: 实现用户注册接口
合并状态: 成功
清理状态: 已清理
更新文件:
- feature_list.json (passes: true)
- EVENT_LOG.md (FEATURE_COMPLETE)
- GLOBAL_STATE.md (active_subagents 已移除)
下一步: 继续监控 FEAT-002, FEAT-003
输入:
feature_id: FEAT-002
子代理状态: COMPLETED
清洁状态: true
Git merge 冲突: 有
处理:
1. Read .subharness/FEAT-002/RESULT.md
2. 验证结果完整性（通过）
3. Git merge FEAT-002-branch → 冲突
4. 记录到 EVENT_LOG.md（ERROR | GIT_MERGE_CONFLICT）
5. 输出冲突文件列表
6. 先触发 harness-handle-failure；仅真实阻塞时再升级 harness-escalate-to-human
输出:
⚠️ Git merge 冲突
功能ID: FEAT-002
冲突文件:
- src/api/auth/login.go
- src/api/auth/register.go
处理: 进入自动冲突恢复；仅真实阻塞时升级 harness-escalate-to-human
下一步: 自动尝试冲突诊断、回滚或重新调度
输入:
feature_id: FEAT-003
子代理状态: COMPLETED
清洁状态: false
RESULT.md:
- 功能开发完成: ✅
- 测试通过: ❌（测试失败）
- 清洁状态: NOT_CLEAN ❌
处理:
1. Read .subharness/FEAT-003/RESULT.md
2. 验证结果完整性（失败）
3. 列出缺失的验证项:
- 测试通过: ❌
- 清洁状态: ❌
4. 记录到 EVENT_LOG.md（ERROR | RESULT_VALIDATION_FAILED）
5. 触发 harness-handle-failure；真实阻塞时再升级
输出:
❌ 结果验证失败
功能ID: FEAT-003
缺失验证项:
- 测试通过: ❌
- 清洁状态: ❌
处理: 先触发 harness-handle-failure；真实阻塞时再升级 harness-escalate-to-human
下一步: 进入自动恢复或阻塞升级流程
输入:
feature_id: FEAT-001
合并状态: 成功
清理状态: 失败（权限问题）
处理:
1. Read .subharness/FEAT-001/RESULT.md ✅
2. 验证结果完整性 ✅
3. Git merge FEAT-001-branch ✅
4. 更新 feature_list.json ✅
5. 更新 EVENT_LOG.md ✅
6. 更新 GLOBAL_STATE.md ✅
7. Bash rm -rf .subharness/FEAT-001 ❌（权限被拒绝）
8. 记录到 EVENT_LOG.md（WARNING | CLEANUP_FAILED）
9. 记录自动清理待办项
输出:
⚠️ 清理子代理目录失败
功能ID: FEAT-001
错误: 权限被拒绝
提示: 请手动清理子代理目录:
rm -rf .subharness/FEAT-001
合并状态: 部分成功（代码已合并，目录未清理）
Token 优化:
- 批量更新文件（减少重复读取）
- 增量式更新 GLOBAL_STATE.md（仅修改 active_subagents）
- 使用 Bash rm -rf（而非逐文件删除）
执行优化:
- 顺序合并（避免并发冲突）
- 清理失败不阻塞（继续执行）
- 错误快速响应（先触发自动失败处理）
总体优化:
- Token 降低 74%（相比手动合并）
- 执行时长缩短 50%（自动化流程）