[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M753S867XAJH0PWF6DWMA2AB":3,"skill-same:01M753S867XAJH0PWF6DWMA2AB":61},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":33,"commitSha":34,"skillDirectory":35,"forksCount":36,"repositoryHtmlUrl":37,"repositoryHomepageUrl":6,"ownerHtmlUrl":38,"ownerBlogUrl":39,"ownerDescription":40,"updatedAt":41,"install":42,"resources":54},"01M753S867XAJH0PWF6DWMA2AB","x-review-api",null,"Validates REST API endpoints for RFC 7807 error responses, pagination, URL versioning, OpenAPI documentation, status codes, and DTO patterns.","review-bench\u002Federcnj_ia-dev-environment","review-bench","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F286778065?v=4","01M7517F9NTEPDZDAXJBR30FWT","ReviewBench","01M7517FAC9F4P7TGWCNJ8VYVW",0,"MIT","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Ftest\u002Fresources\u002Fgolden\u002Fjava-spring-elasticsearch\u002F.claude\u002Fskills\u002Fx-review-api\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: x-review-api\ndescription: \"Validates REST API endpoints for RFC 7807 error responses, pagination, URL versioning, OpenAPI documentation, status codes, and DTO patterns.\"\nuser-invocable: true\nallowed-tools: Read, Grep, Glob, Bash\nargument-hint: \"[endpoint-path or feature-name]\"\ncontext-budget: light\nrequires-capabilities: []\nfragment-slot: { slot: review-specialist, fragment-id: api, fragment-order: 50 }\n---\n\n## Global Output Policy\n\n- **Language**: English ONLY.\n- **Tone**: Technical, Direct, and Concise.\n- **Efficiency**: Remove all conversational fillers and greetings to save tokens.\n\n# Skill: REST API Design Review\n\n## Purpose\n\nReview REST API design for compliance with best practices: RFC 7807 error responses, pagination wrappers, URL versioning, OpenAPI annotations, proper HTTP status codes, and DTO separation from domain models.\n\n## Activation Condition\n\nInclude this skill when the project uses REST protocol.\n\n## Triggers\n\n- `\u002Fx-review-api merchants` -- review API endpoints for a specific feature\n- `\u002Fx-review-api \u002Fapi\u002Fv1\u002Ftransactions` -- review a specific endpoint path\n- `\u002Fx-review-api` -- review all REST endpoints\n\n## Parameters\n\n| Parameter | Type | Required | Default | Description |\n|-----------|------|----------|---------|-------------|\n| `endpoint-or-feature` | String | No | (all) | Endpoint path or feature name to review |\n\n## Knowledge Pack References\n\n| Pack | Files | Purpose |\n|------|-------|---------|\n| api-design | `skills\u002Fapi-design\u002Freferences\u002Fapi-design-principles.md` | URL structure, status codes, error format, pagination |\n| protocols | `skills\u002Fprotocols\u002Freferences\u002Frest-conventions.md` | REST resource naming, HTTP methods, versioning, RFC 7807 |\n\n## Prerequisites\n\n- REST API endpoints exist in the codebase\n- {{FRAMEWORK}} is configured with REST\u002FHTTP support\n- OpenAPI\u002FSwagger dependency is available\n\n## Workflow\n\n### Step 1 — Discover Endpoints\n\nSearch for REST controller\u002Fresource classes:\n- Scan for route annotations or decorators (e.g., `@Path`, `@RestController`, `@Get`, `@app.route`)\n- List all endpoints with their HTTP methods and paths\n\n### Step 2 — Validate URL Structure\n\nCheck each endpoint:\n- URLs use nouns, not verbs (`\u002Fapi\u002Fv1\u002Fresources`, not `\u002Fapi\u002Fv1\u002FcreateResource`)\n- Versioning in path (`\u002Fapi\u002Fv1\u002F`)\n- Sub-resources follow hierarchy (`\u002Fapi\u002Fv1\u002Fparents\u002F{id}\u002Fchildren`)\n- Collection endpoints use plural nouns\n\n### Step 3 — Validate Status Codes\n\nFor each endpoint:\n- GET list returns 200\n- GET item returns 200 (or 404)\n- POST returns 201 with Location header\n- PUT returns 200 (or 404)\n- DELETE returns 204 (or 404)\n- Validation errors return 400\n- Duplicates return 409\n\n### Step 4 — Validate Error Responses (RFC 7807)\n\nCheck for:\n- ProblemDetail record\u002Fclass with fields: type, title, status, detail, instance\n- Factory methods for each error type (notFound, conflict, badRequest, validationError, internalError)\n- ExceptionMapper\u002Fhandler that converts domain exceptions to ProblemDetail\n- No stack traces exposed in production responses\n\n### Step 5 — Validate Pagination\n\nCheck list endpoints:\n- Paginated wrapper with data + pagination metadata (page, limit, total, totalPages)\n- Query parameters for page, limit, sort\n- Default values for pagination parameters\n\n### Step 6 — Validate DTOs\n\nCheck request\u002Fresponse separation:\n- Request DTOs have input validation annotations\n- Response DTOs are immutable (records or final classes)\n- No domain entities exposed directly in REST responses\n- Sensitive data masked in responses (PAN, documents, etc.)\n\n### Step 7 — Validate OpenAPI Documentation\n\nCheck for:\n- Schema annotations on DTOs with descriptions and examples\n- OpenAPI spec auto-generated and accessible\n- Swagger UI available in dev profile\n\n### Step 8 — Generate Report\n\nSummarize findings as checklist:\n- List compliant items\n- List violations with file paths and line numbers\n- Suggest fixes for each violation\n\n## Error Handling\n\n| Scenario | Action |\n|----------|--------|\n| No REST endpoints found | Report INFO: no endpoints discovered in the codebase |\n| OpenAPI dependency missing | Warn about missing documentation support |\n| Endpoint missing error handling | Report violation with file path and remediation guidance |\n\n## Review Checklist\n\n- [ ] URLs follow RESTful pattern (nouns, no verbs)\n- [ ] Proper versioning in URL path (\u002Fapi\u002Fv1\u002F)\n- [ ] Correct HTTP status codes per operation\n- [ ] Request DTOs have validation annotations\n- [ ] Response DTOs are immutable, no domain entities exposed\n- [ ] Error responses follow RFC 7807 (ProblemDetail)\n- [ ] Pagination implemented for list endpoints\n- [ ] Sensitive data masked in responses\n- [ ] OpenAPI\u002FSwagger documentation generated\n- [ ] ExceptionMapper covers all domain exceptions\n- [ ] No stack traces in production error responses\n- [ ] Rate limit responses return 429 + Retry-After header\n","## Global Output Policy\n\n- **Language**: English ONLY.\n- **Tone**: Technical, Direct, and Concise.\n- **Efficiency**: Remove all conversational fillers and greetings to save tokens.\n\n# Skill: REST API Design Review\n\n## Purpose\n\nReview REST API design for compliance with best practices: RFC 7807 error responses, pagination wrappers, URL versioning, OpenAPI annotations, proper HTTP status codes, and DTO separation from domain models.\n\n## Activation Condition\n\nInclude this skill when the project uses REST protocol.\n\n## Triggers\n\n- `\u002Fx-review-api merchants` -- review API endpoints for a specific feature\n- `\u002Fx-review-api \u002Fapi\u002Fv1\u002Ftransactions` -- review a specific endpoint path\n- `\u002Fx-review-api` -- review all REST endpoints\n\n## Parameters\n\n| Parameter | Type | Required | Default | Description |\n|-----------|------|----------|---------|-------------|\n| `endpoint-or-feature` | String | No | (all) | Endpoint path or feature name to review |\n\n## Knowledge Pack References\n\n| Pack | Files | Purpose |\n|------|-------|---------|\n| api-design | `skills\u002Fapi-design\u002Freferences\u002Fapi-design-principles.md` | URL structure, status codes, error format, pagination |\n| protocols | `skills\u002Fprotocols\u002Freferences\u002Frest-conventions.md` | REST resource naming, HTTP methods, versioning, RFC 7807 |\n\n## Prerequisites\n\n- REST API endpoints exist in the codebase\n- {{FRAMEWORK}} is configured with REST\u002FHTTP support\n- OpenAPI\u002FSwagger dependency is available\n\n## Workflow\n\n### Step 1 — Discover Endpoints\n\nSearch for REST controller\u002Fresource classes:\n- Scan for route annotations or decorators (e.g., `@Path`, `@RestController`, `@Get`, `@app.route`)\n- List all endpoints with their HTTP methods and paths\n\n### Step 2 — Validate URL Structure\n\nCheck each endpoint:\n- URLs use nouns, not verbs (`\u002Fapi\u002Fv1\u002Fresources`, not `\u002Fapi\u002Fv1\u002FcreateResource`)\n- Versioning in path (`\u002Fapi\u002Fv1\u002F`)\n- Sub-resources follow hierarchy (`\u002Fapi\u002Fv1\u002Fparents\u002F{id}\u002Fchildren`)\n- Collection endpoints use plural nouns\n\n### Step 3 — Validate Status Codes\n\nFor each endpoint:\n- GET list returns 200\n- GET item returns 200 (or 404)\n- POST returns 201 with Location header\n- PUT returns 200 (or 404)\n- DELETE returns 204 (or 404)\n- Validation errors return 400\n- Duplicates return 409\n\n### Step 4 — Validate Error Responses (RFC 7807)\n\nCheck for:\n- ProblemDetail record\u002Fclass with fields: type, title, status, detail, instance\n- Factory methods for each error type (notFound, conflict, badRequest, validationError, internalError)\n- ExceptionMapper\u002Fhandler that converts domain exceptions to ProblemDetail\n- No stack traces exposed in production responses\n\n### Step 5 — Validate Pagination\n\nCheck list endpoints:\n- Paginated wrapper with data + pagination metadata (page, limit, total, totalPages)\n- Query parameters for page, limit, sort\n- Default values for pagination parameters\n\n### Step 6 — Validate DTOs\n\nCheck request\u002Fresponse separation:\n- Request DTOs have input validation annotations\n- Response DTOs are immutable (records or final classes)\n- No domain entities exposed directly in REST responses\n- Sensitive data masked in responses (PAN, documents, etc.)\n\n### Step 7 — Validate OpenAPI Documentation\n\nCheck for:\n- Schema annotations on DTOs with descriptions and examples\n- OpenAPI spec auto-generated and accessible\n- Swagger UI available in dev profile\n\n### Step 8 — Generate Report\n\nSummarize findings as checklist:\n- List compliant items\n- List violations with file paths and line numbers\n- Suggest fixes for each violation\n\n## Error Handling\n\n| Scenario | Action |\n|----------|--------|\n| No REST endpoints found | Report INFO: no endpoints discovered in the codebase |\n| OpenAPI dependency missing | Warn about missing documentation support |\n| Endpoint missing error handling | Report violation with file path and remediation guidance |\n\n## Review Checklist\n\n- [ ] URLs follow RESTful pattern (nouns, no verbs)\n- [ ] Proper versioning in URL path (\u002Fapi\u002Fv1\u002F)\n- [ ] Correct HTTP status codes per operation\n- [ ] Request DTOs have validation annotations\n- [ ] Response DTOs are immutable, no domain entities exposed\n- [ ] Error responses follow RFC 7807 (ProblemDetail)\n- [ ] Pagination implemented for list endpoints\n- [ ] Sensitive data masked in responses\n- [ ] OpenAPI\u002FSwagger documentation generated\n- [ ] ExceptionMapper covers all domain exceptions\n- [ ] No stack traces in production error responses\n- [ ] Rate limit responses return 429 + Retry-After header\n",{"name":5,"description":7,"allowed-tools":24,"argument-hint":25,"fragment-slot":26,"context-budget":30,"user-invocable":31,"requires-capabilities":32},"Read, Grep, Glob, Bash","[endpoint-path or feature-name]",{"slot":27,"fragment-id":28,"fragment-order":29},"review-specialist","api",50,"light",true,[],"main","952a630c6f38d193a349d86fa18db1de8843e837","src\u002Ftest\u002Fresources\u002Fgolden\u002Fjava-spring-elasticsearch\u002F.claude\u002Fskills\u002Fx-review-api",1,"https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment","https:\u002F\u002Fgithub.com\u002Freview-bench","https:\u002F\u002Freview-bench.ai","An open benchmark for AI code review.","2026-10-27 06:56:37",{"source":8,"skillName":5,"commands":43,"prompt":53,"zipAvailable":31},[44,47,50],{"tool":45,"command":46},"npx","npx skills add review-bench\u002Federcnj_ia-dev-environment --skill x-review-api",{"tool":48,"command":49},"bunx","bunx skills add review-bench\u002Federcnj_ia-dev-environment --skill x-review-api",{"tool":51,"command":52},"pnpm","pnpm dlx skills add review-bench\u002Federcnj_ia-dev-environment --skill x-review-api","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Ftest\u002Fresources\u002Fgolden\u002Fjava-spring-elasticsearch\u002F.claude\u002Fskills\u002Fx-review-api\u002FSKILL.md",[55],{"path":56,"resourceType":57,"resourceTypeDesc":58,"sizeBytes":59,"sourceHtmlUrl":60},"README.md","REFERENCE","参考文档",1543,"https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Ftest\u002Fresources\u002Fgolden\u002Fjava-spring-elasticsearch\u002F.claude\u002Fskills\u002Fx-review-api\u002FREADME.md",[62,69,76,83,90,97],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M757M8J48TQ1Y3X25GSJBXAS","x-parallel-eval","Detects and classifies file-collision risks between work units (tasks, stories, or epic phases) before parallel execution. Reads ## File Footprint blocks produced by x-task-plan \u002F x-story-plan, applies the parallelism-heuristics knowledge pack (hard \u002F regen \u002F soft categories + hotspot overrides), and emits a collision matrix + serialization recommendation in Markdown (default) or JSON.","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Ftest\u002Fresources\u002Fgolden\u002Fx-parallel-eval\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M757M57XMR9546S69466HDWT","parallelism-heuristics","Canonical catalog of file-collision heuristics for parallel task, story, and epic execution. Defines the File Footprint block format, the three Conflict Categories (hard \u002F regen \u002F soft), a hotspot list of high-contention paths, and the degrade-with-warning policy. Consumed by x-task-plan, x-story-plan, x-epic-map, x-parallel-eval, and x-dev-*-implement.","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Ftest\u002Fresources\u002Fgolden\u002Fparallelism-heuristics\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M757M11SZ8P1VCQABT08QVYA","x-watch-pr-ci","Polls a PR's CI checks and Copilot review status, blocking until checks complete or timeout. Returns one of 8 stable exit codes (SUCCESS=0, CI_PENDING_PROCEED=10, CI_FAILED=20, TIMEOUT=30, PR_ALREADY_MERGED=40, NO_CI_CONFIGURED=50, PR_CLOSED=60, PR_NOT_FOUND=70). Writes a versioned state-file for session resume.","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Ftest\u002Fresources\u002Fgolden\u002Fjava-spring\u002Fplatform-claude-code\u002F.claude\u002Fskills\u002Fx-watch-pr-ci\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M757KW53K8KFPGADFB4PH949","x-validate-docs","Documentation freshness gate: validates 6 dimensions (readme, api-specs, grpc-proto, adr, skill-docs, system-architecture) against code changes in a PR. Stack-aware — only validates targets declared\u002Fauto-detected from ProjectConfig.documentation.targets. Returns exit non-zero on staleness; produces structured report.","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Ftest\u002Fresources\u002Fgolden\u002Fjava-spring\u002Fplatform-claude-code\u002F.claude\u002Fskills\u002Fx-validate-docs\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":19},"01M757KQZHSA10MKC0CR571D60","x-update-system-architecture","Incrementally updates docs\u002Farchitecture\u002Fsystem.md after an epic completes. Appends new entries to the Decision Log (§11) using x-internal-write-report --append (dedup by ## ID: marker) and surgically inserts component\u002Fintegration changes into sections 1-10 via Edit. Idempotent: re-running with the same epic produces a byte-identical system.md.","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Ftest\u002Fresources\u002Fgolden\u002Fjava-spring\u002Fplatform-claude-code\u002F.claude\u002Fskills\u002Fx-update-system-architecture\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":19},"01M757KKBT5Q1SVF8DMJBVF46M","x-update-architecture","Incrementally updates the service architecture document with changes from architecture plans. Adds new components, integrations, flows, and ADR references without rewriting existing content. Use after implementation to keep architecture documentation current.","https:\u002F\u002Fgithub.com\u002Freview-bench\u002Federcnj_ia-dev-environment\u002Fblob\u002Fmain\u002Fsrc\u002Ftest\u002Fresources\u002Fgolden\u002Fjava-spring\u002Fplatform-claude-code\u002F.claude\u002Fskills\u002Fx-update-architecture\u002FSKILL.md",[],[]]