メニュー
Fixes Redocly lint errors and api-ref-structure.mdc inconsistencies on an OpenAPI JSON spec. Use when the user invokes /api-fix or asks to fix API lint or structure issues. Does not apply FFS style guide or copy fixes.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | api-fix |
| description | Fixes Redocly lint errors and api-ref-structure.mdc inconsistencies on an OpenAPI JSON spec. Use when the user invokes /api-fix or asks to fix API lint or structure issues. Does not apply FFS style guide or copy fixes. |
/api-fix — Fix lint and structureApply mechanical fixes from two sources:
npm run lint:openapi -- <path>Do not apply FFS style guide changes, copy edits, description punctuation, internal IDs, examples polish, or api-ref-schema / api-ref-copy findings unless Redocly flags them.
Resolve target spec — _shared/resolve-api-spec.md.
Run lint — Record all errors/warnings.
Structure pass — Load api-ref-structure.mdc. Fix:
openapi → info → servers → security → tags → paths → componentsinfo.license (Adobe Creative API License boilerplate)$ref, duplicate schema names (when clearly wrong)Lint pass — Fix each Redocly finding with minimal change. Cite rule/message.
Re-run lint until zero errors (warnings per reference.md).
Re-check structure — Confirm section order and license after lint edits.
Report — Separate what was fixed under Lint vs Structure. If clean but style/copy issues remain, say: Run /api-eval for style guide and documentation findings.
error_code alignment, tags, summaries, public-facing textanyOf/type-array cleanup unless Redocly flags itSee reference.md for Redocly rules and structure checklist.
Audits an OpenAPI JSON spec (Redocly lint, OpenAPI version, FFS style guide, copy rules). Read-only — no file edits. Use when the user invokes /api-eval or asks to evaluate or audit an API spec.
Catalogs user-readable OpenAPI text in ref-numbered tables with possible issues and proposed content. Read-only unless user asks to update specific refs. Use when the user invokes /api-review or asks to review API descriptions.
Stages all working-tree changes with git add -A, then commits with a message that follows the repository user’s Git commit rules (short imperative subject, blank line, body bullets with 📖/✏️). Use when the user invokes /gc or the gc skill, asks to “gc”, or asks to stage everything and commit with the project commit-message format.
Stages all changes with git add -A, drafts a commit message per the user’s Git commit rules, prints it for review, then waits for the user to edit the message and choose (1) commit or (2) reject. Use when the user invokes /gcam or the gcam skill, asks for stage-all with review before commit, or interactive commit with approve/reject.