mcpField
S
steel-session-debugging

steel-session-debugging

github.com/steel-dev开发4445 次安装21 周前更新
代码仓库

关于 steel-session-debugging

steel-session-debugging 是用于分析失败 Steel 会话的技能，面向需要定位问题并确定后续改动的用户。它以日志、轨迹和时间线等证据为依据，并在问题涉及可靠性策略时转交 steel-reliability。

主要功能

  1. 01收集会话元数据、日志与轨迹
  2. 02脱敏调试材料
  3. 03构建事件时间线
  4. 04按故障分类诊断
  5. 05提供验证步骤并按需转交

适用场景

  1. 01调查 Steel 浏览器会话失败
  2. 02整理日志与请求失败证据
  3. 03验证诊断建议的改动
  4. 04识别需要交由 steel-reliability 处理的问题

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/steel-dev/skills --skill steel-session-debugging

安装后在 Claude Code 中输入/steel-session-debugging确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
evals/
evals.json
references/
agent-traces.md
failure-taxonomy.md
investigation-workflow.md
log-event-types.md
network-forensics.md
reliability-handoff.md
replay-and-screenshots.md
scripts/
collect-session-debug.mjs
redact-session-debug.mjs
summarize-session-debug.mjs

详细介绍

Steel 会话调试

技能边界

使用此技能说明 Steel 会话失败的原因，以及接下来需要做哪些更改。以证据为依据，不要猜测。

不要将此技能作为处理机器人检测缓解、代理策略、CAPTCHA 策略、登录信誉或重试策略的主要途径。如果证据指向这些问题，请收集足够的证据并移交给 steel-reliability。

设置检查

  1. 确认用户提供了 Steel 会话 ID，或提供了足以识别会话的上下文。
  2. 如果 CLI 身份验证或 API 访问情况不确定，请运行 steel doctor --preflight。
  3. 优先使用 Steel CLI 诊断，而不是直接调用 API。
  4. 在 .steel-debug/ 下创建本地文件；除非用户要求，否则不要在聊天中粘贴原始日志。

调查工作流

  1. 收集会话元数据、浏览器日志、原始 Agent 日志、语义 Agent 跟踪记录以及查看器／回放链接。
  2. 在总结前，隐去 Cookie、Bearer 令牌、API 密钥、密码、表单值及明显的个人身份信息（PII）。
  3. 建立时间线：会话创建、导航、操作、等待、控制台错误、失败的请求、CAPTCHA／代理信号以及最终状态。
  4. 使用 references/failure-taxonomy.md 中的分类法对失败进行分类。
  5. 提供有证据支持的诊断，并给出最小且有效的验证步骤。
  6. 如果修复涉及机器人检测、代理、CAPTCHA、身份、操作节奏或登录持久性，请转交给 steel-reliability。

输出格式

Diagnosis:
- What happened:
- Most likely cause:
- Evidence:
- What to change:
- Verification step:
- Confidence:

实用命令

steel --json sessions get <session-id>
steel --json sessions logs <session-id>
steel --json sessions agent-logs <session-id>
steel --json sessions traces <session-id>
node scripts/collect-session-debug.mjs <session-id>
node scripts/redact-session-debug.mjs .steel-debug/<session-id>/bundle.json
node scripts/summarize-session-debug.mjs .steel-debug/<session-id>/redacted-bundle.json

参考资料

  • references/investigation-workflow.md：详细的收集与时间线整理流程。
  • references/log-event-types.md：如何区分元数据、浏览器日志、原始 Agent 日志和跟踪记录。
  • references/agent-traces.md：如何解读语义 Agent 跟踪事件。
  • references/network-forensics.md：请求失败、重定向和拦截页面证据。
  • references/replay-and-screenshots.md：查看器、播放器、HLS 和截图的用法。
  • references/failure-taxonomy.md：标准失败类别。
  • references/reliability-handoff.md：何时加载 steel-reliability。

评论

支持 Markdown