메뉴
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 직업 분류 기준
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.
| 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 |