name: request-debugger description: HTTP请求/响应调试与检查工具 allowed-tools:
- Read
- Write
- Edit
- Glob
- Grep
- Bash
请求调试器技能
概述
此技能为SDK实现了全面的HTTP请求/响应调试与检查工具,帮助开发者理解和排查API交互问题。
功能
- 格式化记录请求/响应详细信息
- 自动脱敏敏感数据
- 通过请求ID关联日志
- 支持curl命令导出以复现问题
- 实现请求时间细分分析
- 捕获重试尝试和失败情况
- 支持HAR(HTTP存档)导出
- 启用请求/响应拦截
目标流程
- 错误处理与调试支持
- 日志记录与诊断
- 开发者体验优化
集成点
- HTTP客户端拦截器
- 日志记录框架
- 调试代理(Charles、mitmproxy)
- 浏览器开发者工具协议
- IDE调试集成
输入要求
- 敏感数据脱敏规则
- 日志级别配置
- 时间细分分析要求
- 导出格式偏好
- 拦截能力
输出产物
- 调试拦截器中间件
- 请求记录器实现
- 敏感数据脱敏器
- Curl命令生成器
- HAR导出器
- 时间细分分析工具
使用示例
skill:
name: request-debugger
context:
logging:
enabled: true
level: debug
prettyPrint: true
redaction:
headers: ["Authorization", "X-Api-Key"]
body: ["password", "secret", "token"]
features:
curlExport: true
harExport: true
timingBreakdown: true
retryLogging: true
requestIdHeader: "X-Request-ID"
最佳实践
- 始终脱敏敏感数据
- 包含时间细分分析
- 支持可复现的curl导出
- 记录重试尝试及原因
- 使用结构化日志格式
- 启用选择性调试激活