这是什么？

这是一个代理技能——通过有组织的指令和可执行代码为Claude提供新功能。代理技能采用渐进披露：Claude只在需要时加载所需内容，保持上下文使用效率。

这个POC包含了什么

核心组件

• SKILL.md：带有元数据、概述和能力描述的入口
• config.py：环境变量管理与验证
• postman_client.py：具有重试逻辑和错误处理的API客户端
• retry_handler.py：速率限制和误差的指数退换
• formatters.py：人类可读输出格式化
• list_collections.py：用于发现工作区资源的可执行脚本

工作流程

• list_collections.md：发现工作空间资源的逐步指南
• manage_specs.md：🆕在Spec Hub（OpenAPI 3.0，AsyncAPI 2.0）中创建和管理API规范
• validate_schema.md：验证API模式是否符合OpenAPI/Swagger标准
• version_comparison.md：比较API版本并识别变更
• manage_collections.md：创建、更新、删除和重复集合

Postman Agent Skill

What is This?

This is an Agent Skill - a structured way to give Claude new capabilities through organized instructions and executable code. Agent Skills use progressive disclosure: Claude loads only what it needs when it needs it, keeping context usage efficient.

What’s Included in This POC

Core Components

• SKILL.md: Entry point with metadata, overview, and capability descriptions
• config.py: Environment variable management and validation
• postman_client.py: API client with retry logic and error handling
• retry_handler.py: Exponential backoff for rate limits and errors
• formatters.py: Human-readable output formatting
• list_collections.py: Executable script to discover workspace resources

Workflows

• list_collections.md: Step-by-step guide for discovering workspace resources
• manage_specs.md: 🆕 Create and manage API specifications in Spec Hub (OpenAPI 3.0, AsyncAPI 2.0)
• validate_schema.md: Validate API schemas against OpenAPI/Swagger standards
• version_comparison.md: Compare API versions and identify changes
• manage_collections.md: Create, update, delete, and duplicate collections
• manage_environments.md: Create, update, delete, and duplicate environments
• check_auth.md: Review authentication configuration and security
• manage_mocks.md: Create and manage mock servers for prototyping
• run_collection.md: Execute collection tests with Newman and analyze results
• manage_monitors.md: Create, manage, and analyze monitors for continuous API monitoring
• view_documentation.md: Access and assess API documentation quality

Capabilities

✅ Discover Phase

• List collections, environments, monitors, and APIs
• Get detailed resource information
• Workspace resource discovery
• Error handling with retry logic

✅ Design Phase

• 🆕 Spec Hub: Create and manage API specifications (OpenAPI 3.0, AsyncAPI 2.0)
• 🆕 Multi-File Specs: Support for modular specifications with separate schema files
• 🆕 Bidirectional Generation: Generate collections from specs or specs from collections
• Validate API schemas (OpenAPI, Swagger, GraphQL)
• Get API versions and compare changes
• Manage API definitions and versions
• Create, update, and delete APIs (legacy - use Spec Hub instead)

✅ Build Phase

• Create new collections and environments
• Update existing collections and environments
• Delete collections and environments
• Duplicate collections and environments
• Add requests to collections
• Manage environment variables (including secrets)

✅ Test Phase

• Run collection tests with Newman integration
• Execute test suites with environment variables
• Parse and format test results