# SKILL.md > 为 Codex、Claude Code、Cursor 和 Copilot 安装 Proxyman 官方智能体技能（SKILL.md），用于检查、重放和调试 HTTP/HTTPS 流量。 ## Proxyman 智能体技能 {#proxyman-agent-skills} 以下是 [Proxyman](https://proxyman.com) 的官方智能体技能。Proxyman 是一款 Web 调试代理，可用于检查、重放和调试 HTTP、HTTPS、WebSocket、设备及应用流量。 这套技能涵盖安装、macOS App Settings 的每个标签页、证书的生命周期管理与恢复、MCP 连接及当前全部 MCP 操作、实时文档查询、调试工具工作流、许可、`proxyman-cli`，以及跨设备和运行时的 HTTPS 抓包。Proxyman MCP 通过其随附的 stdio 桥接程序控制正在运行的本地应用，它不是云端 API。 另请参阅 GitHub 仓库，了解各项技能的覆盖范围和维护说明。 * GitHub 仓库：[https://github.com/ProxymanApp/proxyman-SKILL.md](https://github.com/ProxymanApp/proxyman-SKILL.md) ### 插件 {#plugin} * ✅ 在 [OpenAI Marketplace](https://chatgpt.com/plugins/plugins_6a88afab118c8191970bbc714223ff14) 安装 Proxyman 插件。 ### 安装 {#installation} 安装全部技能： ```bash npx skills add ProxymanApp/proxyman-SKILL.md/skills ``` 安装单个技能： ```bash npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-download-setup npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-app-settings npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-certificates-recovery npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-mcp-setup npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-traffic-debugging npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-debugging-tools npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-license-management npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-cli npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-https-capture ``` 如需手动安装，请克隆仓库，并将 `skills/` 下所需的文件夹复制到智能体的技能目录中： ```bash git clone https://github.com/ProxymanApp/proxyman-SKILL.md.git ``` 完成后，请重启或重新加载智能体。 | 智能体 | 技能目录 | | -------------------------- | -------------------- | | OpenAI Codex CLI | `~/.codex/skills/` | | Claude Code/Desktop | `~/.claude/skills/` | | Cursor | `~/.cursor/skills/` | | GitHub Copilot CLI/VS Code | `~/.copilot/skills/` | ### 技能 {#skills} | 技能 | 用途 | | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `proxyman-download-setup` | 在 macOS、Windows 或 Linux 上下载、安装、启动并准备 Proxyman。 | | `proxyman-app-settings` | 审计、说明并安全修改当前 macOS App Settings 的每个标签页，包括构建版本与许可限制，以及仅限图形界面的操作边界。 | | `proxyman-certificates-recovery` | 安装并信任生成的或自定义的根证书，管理自定义服务端/客户端身份，采集诊断信息，并安全使用“帮助”菜单中的恢复操作（包括 Factory Reset）。 | | `proxyman-mcp-setup` | 将智能体连接到随附的 stdio MCP 桥接程序，并排查握手与工具发现问题。 | | `proxyman-traffic-debugging` | 检查流量，并操作当前完整的 MCP 接口：全部 70 项经过审查的操作、资源和提示词。 | | `proxyman-debugging-tools` | 获取最新官方文档，并结合准确的界面边界，深入指导 Breakpoint、Map Local/Remote、Scripting、Compose/Repeat、Protobuf、Network Conditions、Reverse Proxy 和 TLS Key Logging 的使用。 | | `proxyman-license-management` | 安全地激活或解绑当前设备，并管理远程设备、席位、转移和续订。 | | `proxyman-cli` | 查询已安装的 CLI 语法，并自动化处理代理、MCP、配置、日志、证书和规则。 | | `proxyman-https-capture` | 为设备、运行时和容器配置并验证 HTTPS 抓包，并为受控应用选择或集成 Atlantis。 | ### 技能路由 {#routing} * 未安装 Proxyman：使用 `proxyman-download-setup`。 * 用户想了解某个 App Setting 位于何处、会改变什么、为何被锁定，或希望审计或修改设置：使用 `proxyman-app-settings`。 * 用户需要信任生成的或自定义的根证书、自定义服务端/客户端证书、Debug Mode、Reset Network Proxy 或 Factory Reset：使用 `proxyman-certificates-recovery`。 * Proxyman 已安装，但缺少 MCP 工具：使用 `proxyman-mcp-setup`。 * 用户希望智能体通过 MCP 检查或修改 Proxyman：使用 `proxyman-traffic-debugging`。 * 用户想了解某个 Proxyman 工具的工作方式，或需要最新的官方指南：使用 `proxyman-debugging-tools`。 * 用户需要激活或解绑许可证、远程撤销，或使用 License Manager：使用 `proxyman-license-management`。 * 用户需要 Shell 命令或脚本化操作：使用 `proxyman-cli`。 * 用户需要让设备、模拟器、应用、运行时或容器中的流量显示并完成解密：使用 `proxyman-https-capture`。 技能之间可以协同工作。例如，先用 HTTPS Capture 配置 Android 模拟器，再用 Traffic Debugging 验证其流量记录（flows），并创建一条 Map Local 规则。 ### 要求与安全 {#requirements-and-safety} * 在 [MCP](https://proxyman.com/docs/zh-cn/mcp) 工具可以正常操作之前，必须先安装并运行 Proxyman。 * 在 Settings > MCP 中开启 **Enable MCP Server**，或在查阅所用版本的帮助后，使用已安装的 [`proxyman-cli mcp`](https://proxyman.com/docs/zh-cn/command-line) 命令。 * 请使用 Proxyman 随附的 stdio 桥接程序配置智能体，而不是固定的 HTTP URL 或主应用可执行文件。 * 数据结构和语法请以实时的 `tools/list`、资源/提示词发现结果以及已安装 CLI 的帮助信息为准。 * 偏好设置请以已安装的设置界面为准；经过审查的 MCP 服务器并非通用的 App Settings API。 * 证书/私钥导入、信任变更、Debug Mode 输出和 Factory Reset 均属于敏感操作。在进行破坏性恢复之前，请将所需的源文件和备份保存在 Proxyman 托管的文件夹之外。 * 除非明确需要原始数据并已获得批准，否则请保持 **Redact Sensitive Data Before Sending to AI** 处于开启状态。 * MCP 预览中的脱敏功能不会清理原始 HAR 或 Proxyman 日志导出文件。 * 需要确认当前产品行为时，请获取 `https://proxyman.com/docs/llms.txt` 及其链接的 Markdown 页面。 * 许可证密钥、TLS 会话密钥日志、门户访问链接、代理凭据、证书密码以及抓取到的机密信息，均不得存储在技能、命令、日志或报告中。 ### 插件打包 {#plugin-packaging} 该技能包是自包含的，可以放入 Codex 插件的 `skills/` 目录中。插件仍需单独配置或说明本地 Proxyman MCP 桥接程序。打包这些技能并不会包含 Proxyman 应用、桥接可执行文件、许可证，也不会包含正在运行的 MCP 连接。 正式版 Proxyman 插件可在 [ChatGPT](https://chatgpt.com/plugins/plugins_6a88afab118c8191970bbc714223ff14) 上获取。 可发布的插件源码位于 GitHub 仓库的 `plugins/proxyman` 中。它是仅包含技能的软件包，附带可直接发布的清单文件和 Proxyman 品牌资源。有关市场列表、入门提示词、审核测试、发布说明以及 OpenAI Platform 提交的剩余检查项，请参阅仓库中的 `SUBMISSION.md`。 ## 了解更多 {#learn-more} * [如何在 Codex 和 Claude Code 中使用 Proxyman MCP](https://proxyman.com/posts/how-to-use-proxyman-mcp-with-codex-and-claude-code)