菜单
Compare two FlashBlade swagger.json files to produce a structured diff of endpoint and schema changes, annotate items as real_change/swagger_artifact/needs_verification, and generate a migration plan cross-referenced with ROADMAP.md.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | api-diff |
| description | Compare two FlashBlade swagger.json files to produce a structured diff of endpoint and schema changes, annotate items as real_change/swagger_artifact/needs_verification, and generate a migration plan cross-referenced with ROADMAP.md. |
Detects breaking changes, new endpoints, and schema field additions between two FlashBlade API versions. Produces a structured JSON diff consumed by the api-upgrade skill. Annotates each diff item with confidence: real_change (confirmed), swagger_artifact (doc error), needs_verification (unknown).
PYTHONPATH=.claude/skills python3 .claude/skills/api-diff/scripts/diff_swagger.py \
swagger-2.22.json swagger-2.23.json \
--format json \
--output /tmp/diff-2.22-2.23.json
Note: Path prefix normalization is automatic — /api/2.22/buckets and /api/2.23/buckets are treated as the same endpoint.
Edit .claude/skills/api-diff/references/known_discrepancies.json to add annotation overrides for known swagger inaccuracies. Then re-run with the --discrepancies flag:
PYTHONPATH=.claude/skills python3 .claude/skills/api-diff/scripts/diff_swagger.py \
swagger-2.22.json swagger-2.23.json \
--format json \
--discrepancies .claude/skills/api-diff/references/known_discrepancies.json \
--output /tmp/diff-annotated.json
python3 .claude/skills/api-diff/scripts/generate_migration_plan.py \
/tmp/diff-annotated.json \
ROADMAP.md \
--format markdown \
--output /tmp/migration-plan.md
Note: roadmap_gaps entries are new API endpoints that match existing ROADMAP.md Candidate entries — these should be prioritized for scheduling.
annotation field set to real_change, swagger_artifact, or needs_verification.update_models, new_resources, deprecated, roadmap_gaps.| Problem | Cause | Fix |
|---|---|---|
| All paths appear as new+removed | Version prefix not stripped | Use current diff_swagger.py — normalize_path() is called automatically |
| ROADMAP.md parse error | File not found in working directory | Run from project root or pass absolute path |
| ImportError: No module named swagger_utils | Missing PYTHONPATH | Prefix command with PYTHONPATH=.claude/skills |
Orchestrate a FlashBlade Terraform provider upgrade to a new REST API version through 6 review-gated phases: infrastructure version bump, schema updates, new resources, deprecations, documentation, and Pulumi bridge alignment. Consumes api-diff migration plan output and delegates new resource implementation to flashblade-resource-builder.
Guide for implementing new Terraform resources and data sources for the Pure Storage FlashBlade provider. Covers the full lifecycle from API discovery to tested, documented resources. Enforces strict code quality conventions including generic helper usage, test naming, plan modifier rules, and drift detection patterns. This skill should be used when adding a new FlashBlade API resource, modifying an existing resource, or planning provider work.
Convert a FlashBlade swagger.json (OpenAPI 3.0) into the AI-optimized markdown reference format matching FLASHBLADE_API.md. Handles allOf/$ref resolution, groups endpoints by tag, and emits a compact Data Models section. Use this skill when a new API version swagger file is available and needs to be converted into the project standard reference format.
Multi-language codebase health scanner. Use when the user explicitly asks to run desloppify, scan for technical debt, get a health score, or create a cleanup plan. Do NOT trigger for general code review, renaming, or fixing individual bugs.