replicate-issue

用途

该技能面向 Archon 项目，用于系统化地复现并验证 GitHub issue。其目标是判断所报告的行为是否真实存在，确定精确的复现步骤，发现相关问题，并提供可执行的修复建议。

主要能力

在最新的 main 分支代码上准备测试环境，包括切换分支、拉取最新代码、清理本地改动。
关闭已有的 Archon 进程并释放后端 3090 与前端 5173 端口，然后通过 bun run dev 启动后端与前端。
读取指定 GitHub issue（标题、正文、标签、评论、状态），解析问题摘要、复现步骤、预期行为、实际行为、环境细节、标签优先级与评论补充信息，并据此构建测试计划。
使用 agent-browser CLI（而非 Playwright）进行浏览器交互，包括打开页面、获取可交互元素快照、点击、填写表单、重新快照、截图等。
支持通过 REST API 触发后台工作流与聊天消息，以便复现工作流相关的问题。
记录每个症状是否复现及其证据，进行分类：已确认可复现、部分确认、未复现、发现相关 issue。
在复现后做针对性代码分析，定位受影响组件、阅读源码、追踪数据流并识别根因，检查是否存在类似模式。
提供多个修复选项及其取舍，包含实现方式、需要改动的文件、优缺点、复杂度与风险等级。
完成后关闭浏览器并可选择停止 Archon，最后输出复现报告。

使用方式

调用时传入 issue 编号作为参数（$ARGUMENTS）。若参数为空，需先向用户询问 issue 编号。执行流程分为以下阶段：

阶段 0：准备环境（切换 main 分支并拉取最新代码、关闭已有 Archon 进程、启动后端与前端）。
阶段 1：分析 issue（读取 issue 内容并构建测试清单）。
阶段 2：使用浏览器自动化复现（核心命令示例：agent-browser open http://localhost:5173、agent-browser snapshot -i、agent-browser click @e1、agent-browser fill @e2 "text"、agent-browser screenshot /tmp/issue-$ARGUMENTS-{step-name}.png）。
阶段 3：记录发现（逐症状填写表格并分类）。
阶段 4：调查根因（若复现成功）。
阶段 5：给出修复建议（至少 2 至 3 个选项）。
阶段 6：清理（agent-browser close）。
阶段 7：输出总结报告。

若需要触发工作流，可使用 REST API，例如先创建会话再运行工作流：

CONV_ID=$(curl -s -X POST http://localhost:3090/api/conversations \
  -H "Content-Type: application/json" -d '{}' | jq -r '.conversationId')

curl -s -X POST http://localhost:3090/api/workflows/archon-assist/run \
  -H "Content-Type: application/json" \
  -d "{\"conversationId\":\"$CONV_ID\",\"message\":\"Your test message here\"}"

如需触发聊天消息：

curl -s -X POST "http://localhost:3090/api/conversations/$CONV_ID/message" \
  -H "Content-Type: application/json" \
  -d '{"message":"Your test message"}'

适用场景

需要判断某个 GitHub issue 中报告的行为是否真实可复现时。
需要为一组症状确定精确复现步骤并收集截图证据时。
需要区分 UI 层问题与后端问题时（可结合 curl 交叉验证）。
需要针对已复现问题定位根因并提出多种修复方案时。
需要测试 SSE/实时功能在页面刷新或跨会话场景下的表现时。

限制与注意事项

必须使用 agent-browser（Vercel Agent Browser CLI），不要使用 Playwright。
若需要命令参考，可加载 /agent-browser 技能。
若 5173 端口被占用，Vite 会自动递增端口（5174、5175 等），应查看 bun run dev 输出并使用实际前端端口。
应在每个重要测试点截图，并使用 Read 工具查看截图以进行视觉验证。
若复现涉及长时操作，应耐心等待工作流完成。
若无法复现，应记录尝试过的内容并给出可能原因。
该技能依赖 Archon 项目环境（后端 3090、前端 5173 等），且需要 GitHub CLI（gh）与 jq 等工具支持。

暂未提供的信息

技能的具体安装命令与依赖安装步骤暂未提供。
收费、价格与平台支持范围暂未提供。