harness-coding-http

name	harness-coding-http
description	H5 上线修复技能。通过 HTTP 调用独立的 harness-coding AnyAI 项目，提交审核问题修复任务并轮询 run 完成，返回修复和验证摘要。
tags	["h5","online","上线","修复","coding","http","microservice"]

Harness Coding HTTP Skill

使用本技能时，把 examples/harness-coding/ 当作独立微服务项目。不要修改该目录内容。

服务地址

默认服务地址：http://127.0.0.1:2332

默认 agent：

• tech-lead

h5-online 只调用已存在的 HTTP 网关，不负责启动、停止、重启或杀死 harness-coding 进程。如果该地址不可达，直接报告外部依赖阻塞，让用户或外部编排系统处理服务生命周期。

什么时候使用

每次审核服务返回仍有问题、结论不明确或材料不足时使用本技能。主 agent 只负责传入目标 URL、源码路径、审核问题清单、审核报告路径或 artifact root；本技能负责把这些信息转成正式 HTTP 调度脚本调用。

调用方式

⚠️ 重要：必须使用 python 工具执行

由于修复任务可能需要较长运行时间（超过2分钟），必须使用 python 工具而不是 bash 工具来执行 anyai_http_run.py 脚本。

Python 工具调用

{
  "tool": "python",
  "input": {
    "file": "common/skills/scripts/anyai_http_run.py",
    "args": [
      "--base-url", "$H5_CODING_BASE_URL",
      "--agent-id", "tech-lead",
      "--session-id", "h5-online-coding-<site-slug>-r<round>",
      "--timeout", "3600",
      "--text", "修复任务内容"
    ],
    "timeout": 3600
  }
}

超时配置说明

• 脚本超时 (--timeout): 至少 3600秒（60分钟），控制脚本等待远端 run 完成的最大时间
• Python 超时 (timeout): 至少 3600秒（60分钟），必须与脚本超时保持一致
• 重要: 两个超时参数必须都设置且至少为 3600 秒，避免提前超时导致长时间运行的修复任务中断

Session 复用机制

自动复用：

• 你只负责给脚本传入稳定的 session_id
• run_id 恢复、状态文件位置、活动 run 复用、failed/aborted 后的新 run 创建，都由 anyai_http_run.py 内部保证
• 同一轮次（rN）的前 3 次重试必须使用完全相同的 session_id，以复用远端 session 和已有进度
• 只有同一个 session_id 连续 3 次仍未成功时，才允许切换到新的 session_id 脱困；新 session_id 必须追加 -retry<N> 后缀，例如 h5-online-coding-<site-slug>-r<round>-retry1
• 不要向脚本传递 run_id，也不要读取、删除或依赖脚本内部状态文件

执行步骤

1. 生成稳定的 session_id

   • 使用 site_slug 和 round 生成：h5-online-coding-<site-slug>-r<round>
   • 确保同一轮次的前 3 次调用都使用相同的 session_id
   • 如果 3 次仍失败，第 4 次才使用 h5-online-coding-<site-slug>-r<round>-retry1

2. 使用 python file 模式执行

   • 必须使用 python 工具的 file 参数执行脚本，不能用 bash 模式，不能用 heredoc/inline script 包装
   • 设置适当的超时时间（建议3600秒）
   • 传递修复任务内容

3. 解析结果

   • 无论 Python 工具退出码是 0、1 还是 2，都先解析 stdout JSON
   • 脚本固定返回 ok、error_message、error_type、output
   • ok=false 表示本次调用出错；读取 error_message、error_type 和 output.run_id 判断错误原因
   • ok=true 表示远端 run 已完成；从 output.text 解析修复结论 JSON

重试和错误处理

• 只要 ok=false、output.text 为空，或无法解析结构化结论，就按本 skill 的同一轮次重试规则继续重试
• 同一轮次前 3 次重试必须使用完全相同的 session-id
• 普通重试不修改 session-id，让 anyai_http_run.py 在脚本内部复用或恢复 run
• 同一个 session-id 连续 3 次仍失败后，第 4 次才换成带 -retry<N> 后缀的新 session-id
• 每次重试先确认本 skill 的调用方式，保持默认 agent、base URL、任务正文和输出要求正确
• 连接失败、远端失败、脚本超时、run failed/aborted、调度参数错误都按上述规则处理；不要自行编造修复结果
• 必须使用 python 工具的 file 模式，不要使用 bash 模式

修复任务正文模板

每次提交给 tech-lead 的文本必须包含：

请根据 H5 预审问题完成一次受控修复，并按 harness-coding 的正式工程流程推进。

目标 URL: <url>
源码路径: <source_path>
修复轮次: r<N>
审核报告路径: <report_path 或 未提供>
审核 artifact_root: <artifact_root 或 未提供>

问题清单：
<粘贴 review 服务返回的 issues JSON 或文本列表>

约束：
1. 只修复审核指出的问题，不做无关重构。
2. 如果源码路径缺失或不可访问，先让 context-analyst 明确阻塞原因，不要编造改动。
3. 需要经过方案、实现、UI/测试、审查和对齐门禁。
4. 最终回复必须包含一个 JSON 代码块，字段如下：
   - fixed: boolean
   - changed_files: array
   - verification: array
   - remaining_risks: array
   - summary: string
5. 如果没有完成真实修复或验证，fixed 必须为 false。

返回结果处理

读取脚本输出中的：

• ok
• error_message
• error_type
• output.run_id
• output.text（结构化结论所在文本）

判定：

• ok=false：本次修复调用失败，按重试规则继续
• output.text 为空：本次修复未完成，按重试规则继续
• fixed: true：进入下一轮 review 复审
• fixed: false 或没有结构化结论：视为修复未完成，按重试规则继续；仍失败则报告阻塞

返回给主控的摘要

每次完成后，把结果整理成下面形态供 h5-online 进入下一轮复审：

{
  "service": "harness-coding",
  "session_id": "h5-online-coding-<site-slug>-r<round>",
  "status": "completed|failed|aborted|blocked",
  "fixed": true,
  "changed_files": [],
  "verification": [],
  "remaining_risks": [],
  "summary": "",
  "raw_output_excerpt": ""
}

不要把完整 HTTP JSON 原样展示给用户；主控需要的是上述摘要。

失败处理

• HTTP 连接失败：按同一轮次规则重试；连续失败后报告 harness-coding 网关不可达，提示用户或外部编排系统检查 H5_CODING_BASE_URL 和服务状态；不要尝试启动、重启或杀死进程
• 其他 ok=false 或超时：按同一轮次规则重试；仍失败则报告阻塞，不要自行编造修复结果