[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M756CX2AC3E4BK6T2YVY6610":3,"skill-same:01M756CX2AC3E4BK6T2YVY6610":57},{"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":26,"commitSha":27,"skillDirectory":28,"forksCount":14,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M756CX2AC3E4BK6T2YVY6610","api-consistency-checker",null,"API 一致性检查代理，确保 REST 接口遵循项目规范：URL 命名、返回值格式、错误码、Swagger 文档完整性。","Ikeu-1030\u002FiRun","Ikeu-1030","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F229719040?v=4","01M756CMM1YGXYJFY5C8ABR8Y1","ikeu","01M756CMMSQXPZW8JGYCRGYEK9",5,"MIT","https:\u002F\u002Fgithub.com\u002FIkeu-1030\u002FiRun\u002Fblob\u002Fmain\u002F.agent\u002Fapi-consistency-checker\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: \"api-consistency-checker\"\ndescription: \"API 一致性检查代理，确保 REST 接口遵循项目规范：URL 命名、返回值格式、错误码、Swagger 文档完整性。\"\nmodel: sonnet\nmemory: user\n---\n\n# API Consistency Checker\n\n## When to use this skill\n\n**触发场景：**\n- 新增 Controller 或 API 端点\n- 重构 API 路径或参数\n- PR 审查中需要验证 API 一致性\n- 发现多个接口格式不统一，需要排查\n- 文档与实现不一致\n\n**DO NOT use when:**\n- 纯后端业务逻辑审查 → `backend-code-reviewer`\n- 纯前端组件审查 → `frontend-code-reviewer`\n- 安全漏洞审查 → `security-auditor`\n- 只是修改已有接口的内部实现（不改签名） → 不需要\n\n## How to use this skill\n\n```\n\u002Fagent:api-consistency-checker --scope \u003Cfile|directory|branch>\n```\n\n1. 扫描目标范围中的所有 Controller 文件\n2. 逐接口检查 URL、参数、返回值、注解\n3. 输出不一致项列表 + 修复建议\n4. 如发现安全风险，标记并建议调用 `security-auditor`\n\n## General Review Rules\n\n### 自动修复（可直接应用）\n- 返回值包装不一致：`return data;` → `return Result.success(data);`\n- Swagger 注解缺失：补充 `@Operation(summary = \"...\")`\n- DTO 缺少校验注解：补充 `@Valid`\n- URL 风格不一致：修正复数\u002F单数\n\n### 必须人工确认\n- 接口路径重新设计（影响前端调用）\n- API 版本升级\n- 废弃旧接口\n\n## CheckList\n\n### URL 规范\n- [ ] 管理端接口：`\u002Fadmin\u002F\u003Cplural-resource>`（如 `\u002Fadmin\u002Forders`, `\u002Fadmin\u002Fusers`）\n- [ ] 用户端接口：`\u002Fuser\u002F\u003Cplural-resource>`（如 `\u002Fuser\u002Ftasks`, `\u002Fuser\u002Forders`）\n- [ ] 通用接口：`\u002Fcommon\u002F\u003Cresource>`（如 `\u002Fcommon\u002Fupload`）\n- [ ] 资源名使用复数小写，多单词用短横线（如 `notification-settings`）\n- [ ] RESTful 风格：GET 查询、POST 创建、PUT 更新、DELETE 删除\n- [ ] 路径无冗余前缀\u002F后缀（如 `\u002Fapi\u002Fadmin\u002Forders` → `\u002Fadmin\u002Forders`，因为 `server.servlet.context-path=\u002Fapi`）\n\n### 参数规范\n- [ ] 单个 ID 使用 `@PathVariable`：`GET \u002Fadmin\u002Forders\u002F{id}`\n- [ ] 列表查询使用 `@RequestParam`：`GET \u002Fadmin\u002Forders?status=1&page=1&size=10`\n- [ ] 创建\u002F更新使用 `@RequestBody` + DTO，DTO 有 `@Valid` 校验\n- [ ] 分页参数统一：`page`（默认 1）、`size`（默认 10）\n\n### 返回值规范\n- [ ] 所有接口返回 `Result\u003CT>` 或 `Result\u003CPageResult\u003CT>>`\n- [ ] 成功：`Result.success()` 或 `Result.success(data)`\n- [ ] 失败：由全局异常处理器统一返回 `Result.error(code, msg)`，不在 Controller 中手动构建\n- [ ] 分页查询返回 `PageResult\u003CT>` 包含 `total` 和 `records`\n\n### Swagger 文档\n- [ ] Controller 类有 `@Tag(name = \"管理端-XXX接口\")` 或 `@Tag(name = \"用户端-XXX接口\")`\n- [ ] 每个方法有 `@Operation(summary = \"xxx\")`\n- [ ] DTO\u002FVO 字段有 `@Schema(description = \"xxx\")`\n- [ ] 参数有 `@Parameter(description = \"xxx\")`（可选，但推荐）\n\n### 认证 & 权限\n- [ ] 管理端接口：`token` 请求头（非 `Authorization: Bearer`），由 `JwtTokenAdminInterceptor` 校验\n- [ ] 用户端接口：`authentication` 请求头，由 `JwtTokenUserInterceptor` 校验\n- [ ] 敏感操作有 `@RequireRole` 注解\n\n### 返回码规范\n- [ ] 成功统一返回 `code = 1`\n- [ ] 业务异常由全局异常处理器映射 HTTP 状态码 + 业务错误码\n- [ ] 不在 Controller 中 `return Result.error(...)`（除非有特殊需求）\n","# API Consistency Checker\n\n## When to use this skill\n\n**触发场景：**\n- 新增 Controller 或 API 端点\n- 重构 API 路径或参数\n- PR 审查中需要验证 API 一致性\n- 发现多个接口格式不统一，需要排查\n- 文档与实现不一致\n\n**DO NOT use when:**\n- 纯后端业务逻辑审查 → `backend-code-reviewer`\n- 纯前端组件审查 → `frontend-code-reviewer`\n- 安全漏洞审查 → `security-auditor`\n- 只是修改已有接口的内部实现（不改签名） → 不需要\n\n## How to use this skill\n\n```\n\u002Fagent:api-consistency-checker --scope \u003Cfile|directory|branch>\n```\n\n1. 扫描目标范围中的所有 Controller 文件\n2. 逐接口检查 URL、参数、返回值、注解\n3. 输出不一致项列表 + 修复建议\n4. 如发现安全风险，标记并建议调用 `security-auditor`\n\n## General Review Rules\n\n### 自动修复（可直接应用）\n- 返回值包装不一致：`return data;` → `return Result.success(data);`\n- Swagger 注解缺失：补充 `@Operation(summary = \"...\")`\n- DTO 缺少校验注解：补充 `@Valid`\n- URL 风格不一致：修正复数\u002F单数\n\n### 必须人工确认\n- 接口路径重新设计（影响前端调用）\n- API 版本升级\n- 废弃旧接口\n\n## CheckList\n\n### URL 规范\n- [ ] 管理端接口：`\u002Fadmin\u002F\u003Cplural-resource>`（如 `\u002Fadmin\u002Forders`, `\u002Fadmin\u002Fusers`）\n- [ ] 用户端接口：`\u002Fuser\u002F\u003Cplural-resource>`（如 `\u002Fuser\u002Ftasks`, `\u002Fuser\u002Forders`）\n- [ ] 通用接口：`\u002Fcommon\u002F\u003Cresource>`（如 `\u002Fcommon\u002Fupload`）\n- [ ] 资源名使用复数小写，多单词用短横线（如 `notification-settings`）\n- [ ] RESTful 风格：GET 查询、POST 创建、PUT 更新、DELETE 删除\n- [ ] 路径无冗余前缀\u002F后缀（如 `\u002Fapi\u002Fadmin\u002Forders` → `\u002Fadmin\u002Forders`，因为 `server.servlet.context-path=\u002Fapi`）\n\n### 参数规范\n- [ ] 单个 ID 使用 `@PathVariable`：`GET \u002Fadmin\u002Forders\u002F{id}`\n- [ ] 列表查询使用 `@RequestParam`：`GET \u002Fadmin\u002Forders?status=1&page=1&size=10`\n- [ ] 创建\u002F更新使用 `@RequestBody` + DTO，DTO 有 `@Valid` 校验\n- [ ] 分页参数统一：`page`（默认 1）、`size`（默认 10）\n\n### 返回值规范\n- [ ] 所有接口返回 `Result\u003CT>` 或 `Result\u003CPageResult\u003CT>>`\n- [ ] 成功：`Result.success()` 或 `Result.success(data)`\n- [ ] 失败：由全局异常处理器统一返回 `Result.error(code, msg)`，不在 Controller 中手动构建\n- [ ] 分页查询返回 `PageResult\u003CT>` 包含 `total` 和 `records`\n\n### Swagger 文档\n- [ ] Controller 类有 `@Tag(name = \"管理端-XXX接口\")` 或 `@Tag(name = \"用户端-XXX接口\")`\n- [ ] 每个方法有 `@Operation(summary = \"xxx\")`\n- [ ] DTO\u002FVO 字段有 `@Schema(description = \"xxx\")`\n- [ ] 参数有 `@Parameter(description = \"xxx\")`（可选，但推荐）\n\n### 认证 & 权限\n- [ ] 管理端接口：`token` 请求头（非 `Authorization: Bearer`），由 `JwtTokenAdminInterceptor` 校验\n- [ ] 用户端接口：`authentication` 请求头，由 `JwtTokenUserInterceptor` 校验\n- [ ] 敏感操作有 `@RequireRole` 注解\n\n### 返回码规范\n- [ ] 成功统一返回 `code = 1`\n- [ ] 业务异常由全局异常处理器映射 HTTP 状态码 + 业务错误码\n- [ ] 不在 Controller 中 `return Result.error(...)`（除非有特殊需求）\n",{"name":5,"model":24,"memory":25,"description":7},"sonnet","user","main","14d19341a5ae6e5a3c751328fcc273395da5bd21",".agent\u002Fapi-consistency-checker","https:\u002F\u002Fgithub.com\u002FIkeu-1030\u002FiRun","https:\u002F\u002Fgithub.com\u002FIkeu-1030","Action shatters illusion\u002F","2026-07-02 15:19:58",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add Ikeu-1030\u002FiRun --skill api-consistency-checker",{"tool":39,"command":40},"bunx","bunx skills add Ikeu-1030\u002FiRun --skill api-consistency-checker",{"tool":42,"command":43},"pnpm","pnpm dlx skills add Ikeu-1030\u002FiRun --skill api-consistency-checker","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FIkeu-1030\u002FiRun\u002Fblob\u002Fmain\u002F.agent\u002Fapi-consistency-checker\u002FSKILL.md",true,[47,53],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"references\u002Fresponse-format.md","REFERENCE","参考文档",2185,"https:\u002F\u002Fgithub.com\u002FIkeu-1030\u002FiRun\u002Fblob\u002Fmain\u002F.agent\u002Fapi-consistency-checker\u002Freferences\u002Fresponse-format.md",{"path":54,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":55,"sourceHtmlUrl":56},"references\u002Frest-conventions.md",1981,"https:\u002F\u002Fgithub.com\u002FIkeu-1030\u002FiRun\u002Fblob\u002Fmain\u002F.agent\u002Fapi-consistency-checker\u002Freferences\u002Frest-conventions.md",[58,65,72,79,86,93],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M756NR65N494G30JZP84MS7R","understand","Analyze a codebase to produce an interactive knowledge graph for understanding architecture, components, and relationships","https:\u002F\u002Fgithub.com\u002FIkeu-1030\u002FiRun\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Funderstand-anything\u002Funderstand-anything-plugin\u002Fskills\u002Funderstand\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":19},"01M756NPH7BMV8655NPXER0ZAS","understand-onboard","Use when you need to generate an onboarding guide for new team members joining a project","https:\u002F\u002Fgithub.com\u002FIkeu-1030\u002FiRun\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Funderstand-anything\u002Funderstand-anything-plugin\u002Fskills\u002Funderstand-onboard\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":19},"01M756NM7K2DP7KD475N4S3ZXD","understand-knowledge","Analyze a Karpathy-pattern LLM wiki knowledge base and generate an interactive knowledge graph with entity extraction, implicit relationships, and topic clustering.","https:\u002F\u002Fgithub.com\u002FIkeu-1030\u002FiRun\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Funderstand-anything\u002Funderstand-anything-plugin\u002Fskills\u002Funderstand-knowledge\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M756NJPJADZ13YRP1D9PEVEF","understand-explain","Use when you need a deep-dive explanation of a specific file, function, or module in the codebase","https:\u002F\u002Fgithub.com\u002FIkeu-1030\u002FiRun\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Funderstand-anything\u002Funderstand-anything-plugin\u002Fskills\u002Funderstand-explain\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M756NF79MR3DD69W7XJAT2PB","understand-domain","Extract business domain knowledge from a codebase and generate an interactive domain flow graph. Works standalone (lightweight scan) or derives from an existing \u002Funderstand knowledge graph.","https:\u002F\u002Fgithub.com\u002FIkeu-1030\u002FiRun\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Funderstand-anything\u002Funderstand-anything-plugin\u002Fskills\u002Funderstand-domain\u002FSKILL.md",[],[],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":19},"01M756NCF0HHCSJTMDV85G7KR2","understand-diff","Use when you need to analyze git diffs or pull requests to understand what changed, affected components, and risks","https:\u002F\u002Fgithub.com\u002FIkeu-1030\u002FiRun\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Funderstand-anything\u002Funderstand-anything-plugin\u002Fskills\u002Funderstand-diff\u002FSKILL.md",[],[]]