[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7B2ANRMF5ZQDF0ZSCZXR4WR":3,"skill-same:01M7B2ANRMF5ZQDF0ZSCZXR4WR":54},{"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":27,"commitSha":28,"skillDirectory":29,"forksCount":30,"repositoryHtmlUrl":31,"repositoryHomepageUrl":6,"ownerHtmlUrl":32,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":33,"install":34,"resources":47},"01M7B2ANRMF5ZQDF0ZSCZXR4WR","restful-api-standard",null,"企业级 RESTful API 设计准则","2428424081cn\u002FSkill-mcp","2428424081cn","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F211628073?v=4","01M7B248A88Y9AX8SMDNQXEGXP","Java-star","01M7B248B8AR86WG4JF94N28JZ",1,"MIT","https:\u002F\u002Fgithub.com\u002F2428424081cn\u002FSkill-mcp\u002Fblob\u002Fmain\u002Fskills\u002Fweb\u002Frestful-api-standard\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: restful-api-standard\nnamespace: web\nversion: 1.0.0\nskillType: rule\ndescription: 企业级 RESTful API 设计准则\n---\n\n# 企业级 RESTful API 设计准则\n\n在生成任何 API 接口、路由定义与控制器时，AI 必须严格执行以下设计标准。\n\n## 一、 URL 命名与路由层级\n1. **全名词复数**：使用资源复数名词，严禁在 URL 中出现动词（动词由 HTTP Method 表达）。\n   - ❌ `\u002Fapi\u002FgetUserInfo` \u002F `\u002Fapi\u002FdeleteOrder`\n   - ✅ `GET \u002Fapi\u002Fv1\u002Fusers\u002F{id}` \u002F `DELETE \u002Fapi\u002Fv1\u002Forders\u002F{id}`\n2. **层级从属表达**：子资源嵌套在父资源之后。\n   - ✅ `GET \u002Fapi\u002Fv1\u002Fusers\u002F{userId}\u002Forders`\n3. **Kebab-Case**：URL 路径全小写并用连字符连接（如 `\u002Fapi\u002Fv1\u002Fpayment-methods`）。\n\n## 二、 HTTP 谓词与状态码契约\n- **`GET`**：安全且幂等，查询资源。`200 OK`\n- **`POST`**：创建资源。成功返回 `201 Created` + `Location` 头。\n- **`PUT`**：全量替换（幂等）。`200 OK` 或 `204 No Content`\n- **`PATCH`**：局部更新。`200 OK`\n- **`DELETE`**：删除资源（幂等）。成功返回 `204 No Content` 或 `200 OK`\n- **错误状态码**：\n  - `400 Bad Request`（参数格式错误）\n  - `401 Unauthorized`（未认证\u002FToken 失效）\n  - `403 Forbidden`（已认证但无权限）\n  - `404 Not Found`（资源不存在）\n  - `409 Conflict`（唯一约束\u002F状态机冲突）\n  - `422 Unprocessable Entity`（业务逻辑校验失败）\n\n## 三、 统一响应体信封 (Envelope)\n```json\n{\n  \"code\": 0,\n  \"message\": \"success\",\n  \"data\": { ... },\n  \"meta\": {\n    \"page\": 1,\n    \"pageSize\": 20,\n    \"total\": 100\n  },\n  \"traceId\": \"c98a1f87-6e42-4b2a\"\n}\n```\n","# 企业级 RESTful API 设计准则\n\n在生成任何 API 接口、路由定义与控制器时，AI 必须严格执行以下设计标准。\n\n## 一、 URL 命名与路由层级\n1. **全名词复数**：使用资源复数名词，严禁在 URL 中出现动词（动词由 HTTP Method 表达）。\n   - ❌ `\u002Fapi\u002FgetUserInfo` \u002F `\u002Fapi\u002FdeleteOrder`\n   - ✅ `GET \u002Fapi\u002Fv1\u002Fusers\u002F{id}` \u002F `DELETE \u002Fapi\u002Fv1\u002Forders\u002F{id}`\n2. **层级从属表达**：子资源嵌套在父资源之后。\n   - ✅ `GET \u002Fapi\u002Fv1\u002Fusers\u002F{userId}\u002Forders`\n3. **Kebab-Case**：URL 路径全小写并用连字符连接（如 `\u002Fapi\u002Fv1\u002Fpayment-methods`）。\n\n## 二、 HTTP 谓词与状态码契约\n- **`GET`**：安全且幂等，查询资源。`200 OK`\n- **`POST`**：创建资源。成功返回 `201 Created` + `Location` 头。\n- **`PUT`**：全量替换（幂等）。`200 OK` 或 `204 No Content`\n- **`PATCH`**：局部更新。`200 OK`\n- **`DELETE`**：删除资源（幂等）。成功返回 `204 No Content` 或 `200 OK`\n- **错误状态码**：\n  - `400 Bad Request`（参数格式错误）\n  - `401 Unauthorized`（未认证\u002FToken 失效）\n  - `403 Forbidden`（已认证但无权限）\n  - `404 Not Found`（资源不存在）\n  - `409 Conflict`（唯一约束\u002F状态机冲突）\n  - `422 Unprocessable Entity`（业务逻辑校验失败）\n\n## 三、 统一响应体信封 (Envelope)\n```json\n{\n  \"code\": 0,\n  \"message\": \"success\",\n  \"data\": { ... },\n  \"meta\": {\n    \"page\": 1,\n    \"pageSize\": 20,\n    \"total\": 100\n  },\n  \"traceId\": \"c98a1f87-6e42-4b2a\"\n}\n```\n",{"name":5,"version":24,"namespace":25,"skillType":26,"description":7},"1.0.0","web","rule","main","dec8b35d55bf9c402bc2a6dd12660c86fabef2a9","skills\u002Fweb\u002Frestful-api-standard",0,"https:\u002F\u002Fgithub.com\u002F2428424081cn\u002FSkill-mcp","https:\u002F\u002Fgithub.com\u002F2428424081cn","2026-08-25 01:43:58",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add 2428424081cn\u002FSkill-mcp --skill restful-api-standard",{"tool":40,"command":41},"bunx","bunx skills add 2428424081cn\u002FSkill-mcp --skill restful-api-standard",{"tool":43,"command":44},"pnpm","pnpm dlx skills add 2428424081cn\u002FSkill-mcp --skill restful-api-standard","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002F2428424081cn\u002FSkill-mcp\u002Fblob\u002Fmain\u002Fskills\u002Fweb\u002Frestful-api-standard\u002FSKILL.md",true,[48],{"path":49,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":52,"sourceHtmlUrl":53},"skill.json","REFERENCE","参考文档",1652,"https:\u002F\u002Fgithub.com\u002F2428424081cn\u002FSkill-mcp\u002Fblob\u002Fmain\u002Fskills\u002Fweb\u002Frestful-api-standard\u002Fskill.json",[55,62,69,76,83,90],{"skillNo":56,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":19},"01M7B2ARPQ51SJ1F7J6M6ACH8Y","web-page-extractor","网页正文智能提纯与清洗工具。抓取网页并剔除 HTML 标签、脚本与样式，输出高信息密度的 Markdown。","https:\u002F\u002Fgithub.com\u002F2428424081cn\u002FSkill-mcp\u002Fblob\u002Fmain\u002Fskills\u002Fweb\u002Fweb-page-extractor\u002FSKILL.md",[],[],{"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},"01M7B2AJPJZGPP5JJ9ZHZ4PFS0","fetch-page","抓取网页并提取标题与正文长度，需要网络权限（默认策略为拒绝，须授权）。","https:\u002F\u002Fgithub.com\u002F2428424081cn\u002FSkill-mcp\u002Fblob\u002Fmain\u002Fskills\u002Fweb\u002Ffetch-page\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},"01M7B2AF7A8E436HPVQSP0G0J5","api-tester-toolkit","API 接口网络测试与耗时诊断工具包。发起 HTTP GET\u002FPOST 请求、统计响应耗时与状态码、检查响应数据。","https:\u002F\u002Fgithub.com\u002F2428424081cn\u002FSkill-mcp\u002Fblob\u002Fmain\u002Fskills\u002Fweb\u002Fapi-tester-toolkit\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},"01M7B2ADT9B0QE2X4A8J0H772S","semver-bump","语义化版本号升级：major \u002F minor \u002F patch。","https:\u002F\u002Fgithub.com\u002F2428424081cn\u002FSkill-mcp\u002Fblob\u002Fmain\u002Fskills\u002Futil\u002Fsemver-bump\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},"01M7B2ACMJ6T4AXWYP81T87AK1","translate","中英互译演示实现，内置小词典，用于演示翻译类 skill 的检索与调用。","https:\u002F\u002Fgithub.com\u002F2428424081cn\u002FSkill-mcp\u002Fblob\u002Fmain\u002Fskills\u002Ftext\u002Ftranslate\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},"01M7B2A9SFYBPAK0EB3X96YHJD","summarize","把长文本压缩成简短摘要，适合会议记录、文章、文档的快速概览。","https:\u002F\u002Fgithub.com\u002F2428424081cn\u002FSkill-mcp\u002Fblob\u002Fmain\u002Fskills\u002Ftext\u002Fsummarize\u002FSKILL.md",[],[]]