SKILL.md
为 Codex、Claude Code、Cursor 和 Copilot 安装 Proxyman 官方智能体技能（SKILL.md），用于检查、重放和调试 HTTP/HTTPS 流量。
Proxyman 智能体技能
以下是 Proxyman 的官方智能体技能。Proxyman 是一款 Web 调试代理，可用于检查、重放和调试 HTTP、HTTPS、WebSocket、设备及应用流量。
这套技能涵盖安装、macOS App Settings 的每个标签页、证书的生命周期管理与恢复、MCP 连接及当前全部 MCP 操作、实时文档查询、调试工具工作流、许可、proxyman-cli，以及跨设备和运行时的 HTTPS 抓包。Proxyman MCP 通过其随附的 stdio 桥接程序控制正在运行的本地应用，它不是云端 API。
另请参阅 GitHub 仓库，了解各项技能的覆盖范围和维护说明。
插件
- ✅ 在 OpenAI Marketplace 安装 Proxyman 插件。
安装
安装全部技能：
npx skills add ProxymanApp/proxyman-SKILL.md/skills
安装单个技能：
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/ 下所需的文件夹复制到智能体的技能目录中：
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/ |
技能
| 技能 | 用途 |
|---|---|
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。 |
技能路由
- 未安装 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 规则。
要求与安全
- 在 MCP 工具可以正常操作之前，必须先安装并运行 Proxyman。
- 在 Settings > MCP 中开启 Enable MCP Server，或在查阅所用版本的帮助后，使用已安装的
proxyman-cli mcp命令。 - 请使用 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 会话密钥日志、门户访问链接、代理凭据、证书密码以及抓取到的机密信息，均不得存储在技能、命令、日志或报告中。
插件打包
该技能包是自包含的，可以放入 Codex 插件的 skills/ 目录中。插件仍需单独配置或说明本地 Proxyman MCP 桥接程序。打包这些技能并不会包含 Proxyman 应用、桥接可执行文件、许可证，也不会包含正在运行的 MCP 连接。
正式版 Proxyman 插件可在 ChatGPT 上获取。
可发布的插件源码位于 GitHub 仓库的 plugins/proxyman 中。它是仅包含技能的软件包，附带可直接发布的清单文件和 Proxyman 品牌资源。有关市场列表、入门提示词、审核测试、发布说明以及 OpenAI Platform 提交的剩余检查项，请参阅仓库中的 SUBMISSION.md。