curl-http

核心用法

curl-http 是一个纯文档型 Skill，系统性地整理了 curl 命令行工具在 HTTP 请求、API 测试和文件传输场景下的完整用法。内容涵盖 GET/POST/PUT/DELETE/PATCH 等全量 HTTP 方法、自定义请求头与多种认证方式（Basic Auth、Bearer Token、API Key）、超时重试机制、Cookie 与代理配置、SSL/TLS 安全选项，以及响应处理与性能测试技巧。所有示例均为可直接执行的 Bash 命令片段，支持从简单请求到复杂调试场景的全覆盖。

显著优点

1. 权威性与完整性：基于 curl 官方文档（curl.se）构建，覆盖 20+ 年工业级 HTTP 工具的核心能力，示例经过生产环境验证。
2. 场景化组织：按"基础请求-认证授权-高级特性-文件操作-测试调试"递进式编排，新手可快速上手，专家能直接定位高级用法。
3. 即查即用：每个代码块均为独立可执行单元，配合 -s、-w、-v 等调试标志的详细说明，大幅降低 API 调试和自动化脚本编写成本。
4. 零依赖风险：纯 Markdown 文档，无隐藏代码逻辑，完全依赖系统预装的 curl 二进制文件，行为透明可预期。

潜在缺点与局限性

1. 静态文档限制：仅提供命令参考，无交互式参数构建或自动补全功能，复杂请求仍需用户手动拼接。
2. 平台差异未标注：部分选项（如 --socks5 代理、TLS 版本控制）在不同 curl 版本或操作系统中存在行为差异，文档未逐一说明。
3. 安全风险示例：包含 -k（忽略 SSL 证书）和明文密码认证示例，虽有合理性，但缺乏醒目的环境适用性警告，新手可能误用于生产环境。
4. 输出处理依赖外部工具：JSON 美化示例依赖 jq，但 Skill 未说明该工具的安装要求，可能导致命令执行失败。

适合的目标群体

• 后端/全栈开发者：日常 REST API 调试、接口联调与自动化测试
• DevOps/SRE 工程师：服务健康检查、性能基准测试、CI/CD 流水线 HTTP 探针编写
• 安全测试人员：HTTP 请求构造、认证绕过测试、SSL/TLS 配置验证
• 技术写作者与 API 设计者：生成可复现的接口调用示例文档

使用风险

1. 凭证泄露风险：命令行历史（.bash_history）可能记录含密码或 Token 的 curl 命令，建议配合 HISTCONTROL=ignorespace 或从文件读取敏感数据。
2. SSL 降级误用：-k//--insecure` 参数若用于生产环境，将完全丧失 HTTPS 的防中间人保护能力。
3. 大文件传输性能：curl 默认单线程下载，GB 级文件传输无断点续传保护时可能因网络抖动导致重复流量消耗。
4. 版本兼容性：旧系统 curl 版本（如 <7.50）可能不支持 --retry-all-errors 等新特性，脚本跨环境部署前需验证版本。