메뉴
在用户需要查询 YAPI 接口文档、确认请求参数、查看响应结构、按路径或标题定位接口定义、核对某个接口的 body schema、或希望从 YAPI 拉取最新文档时使用。只要用户提到"查 YAPI""接口文档""请求参数""响应体""某个 path 的定义""YAPI 上这个接口怎么写"，即使没有明确点名这个 skill，也应优先使用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
使用 ImageMagick 压缩本地图片文件，使用 ffmpeg 压缩本地视频文件。当 Codex 需要缩小 JPEG、PNG、WebP、HEIC、TIFF、MP4、MOV、MKV 或其他本地媒体体积时使用；适用于批量压缩文件夹、分享前缩放图片、将照片或截图默认转换为同目录同名 WebP、将视频默认压缩为同路径 MP4/H.265，保留源文件时输出到 compressed 压缩目录并镜像源目录结构，并在压缩成功后检查输出尺寸、重试 0KB 输出、默认删除或替换原文件并汇报压缩前后体积变化。
根据 git diff 分析变更并生成符合 Conventional Commits 规范的提交信息。当用户提到"写commit"、"提交信息"、"commit message"、"帮我提交"、"整理改动"、"拆分提交"、暂存区代码变更、或需要按约定式提交规范撰写消息时使用此技能。生成后展示给用户确认，不主动执行 git commit。
对前端代码进行全面的代码审查，包括代码规范、性能优化、可访问性、安全性、TypeScript类型检查、React/Vue等框架最佳实践。在以下场景使用：(1) 审查前端代码质量，(2) 检查性能问题，(3) 验证可访问性，(4) 发现安全漏洞，(5) TypeScript类型检查，(6) 框架特定最佳实践检查
自动生成周报。当用户说"写周报"、"生成本周总结"时触发。
蓝湖应用开发技能，用于构建和管理蓝湖相关的应用功能
| name | yapi-document |
| description | 在用户需要查询 YAPI 接口文档、确认请求参数、查看响应结构、按路径或标题定位接口定义、核对某个接口的 body schema、或希望从 YAPI 拉取最新文档时使用。只要用户提到"查 YAPI""接口文档""请求参数""响应体""某个 path 的定义""YAPI 上这个接口怎么写"，即使没有明确点名这个 skill，也应优先使用。 |
这个 skill 用于从 YAPI 平台导出的项目 JSON 中查询接口定义，并以精简、可阅读的方式返回请求与响应摘要。
skill 的核心目标不是把整份 YAPI 导出原样贴回上下文，而是：
在当前 git 仓库根目录范围内，从工作目录向上查找以下 env 文件（优先级从高到低）：
| 优先级 | 文件名 | 说明 |
|---|---|---|
| 1 | .env.local | 本地覆盖，不进 git |
| 2 | .env.development | 开发环境配置 |
| 3 | .env | 全局基础配置 |
文件中的变量会按优先级合并，高优先级的值不会被低优先级覆盖。如果都找不到，回退读取 shell 环境变量。
YAPI_BASE_URL=https://你的YAPI域名
YAPI_PROJECT_ID=29
YAPI_TOKEN=你的YAPI导出token
如需同时管理多个 YAPI 项目，使用逗号分隔多个项目 ID 和对应的 token：
YAPI_BASE_URL=https://你的YAPI域名
YAPI_PROJECT_ID=29,35,42
YAPI_TOKEN=token1,token2,token3
配置规则：
YAPI_PROJECT_ID 和 YAPI_TOKEN 中的值数量必须一一对应project-{id}.json约束如下：
YAPI_BASE_URL 配置，由用户指定（如 https://yapi.hrttest.cn）.env.local、.env.development、.env--tokenfindshowcat 或等价方式把全量 JSON 回填到回答中--out，只返回摘要并提示如何导出完整内容refreshfind/show 添加 --offline在这些场景先刷新：
命令：
node skills/yapi-document/scripts/yapi-document.mjs refresh
如需查看命令帮助，可使用：
node skills/yapi-document/scripts/yapi-document.mjs --help
当用户提供的是模糊条件时，先运行：
node skills/yapi-document/scripts/yapi-document.mjs find --method PATCH --path /plan/update
或：
node skills/yapi-document/scripts/yapi-document.mjs find --keyword 患者
如果用户要看“当前项目有哪些接口”，运行：
node skills/yapi-document/scripts/yapi-document.mjs find --all --group-by category --max-results 50
注意：
--all 只表示允许在“没有过滤条件”时列出接口清单--category、--keyword、--path 等条件，仍然必须只返回过滤后的结果返回多个候选时，只列候选项并请用户确认要看哪一个。
唯一命中后再运行：
node skills/yapi-document/scripts/yapi-document.mjs show --method PATCH --path /plan/update
如果只看某一部分，使用 --section：
node skills/yapi-document/scripts/yapi-document.mjs show --method PATCH --path /plan/update --section req-body
可选 section：
overviewparamsqueryheadersreq-bodyres-bodymarkdownall如果当前查询结果还要继续交给其他 skill 或脚本处理，优先加上 --json：
node skills/yapi-document/scripts/yapi-document.mjs show \
--method POST \
--path /api/about-us/agreement \
--section all \
--json
适用场景：
api-wrapper、vue-api-client-wrapper 或自定义生成脚本method、path、参数列表、body schema、缓存状态输出约定：
refresh --json：返回拉取时间、分类数、接口总数、缓存文件信息find --json：返回查询条件、总命中数、当前展示数、候选接口列表、缓存状态show --json：返回匹配接口、请求参数、响应 schema、缓存状态stats --json：返回分类数量、接口总数、方法分布、Top 分类、缓存状态推荐串联方式：
find --json 缩小候选范围show --jsonshow --json 的结果直接交给下游 skill 生成类型或请求封装如果用户是想先了解“这个 YAPI 项目里有哪些接口”，使用：
node skills/yapi-document/scripts/yapi-document.mjs find --all --group-by category --max-results 50
规则：
--group-by category 一起使用，便于先按分类浏览如果用户想看当前项目的接口规模、方法分布、Top 分类，使用：
node skills/yapi-document/scripts/yapi-document.mjs stats
可选参数：
node skills/yapi-document/scripts/yapi-document.mjs stats --top-categories 15
默认按下面结构整理回答：
## 匹配接口
## 请求定义
## 响应定义
## 备注
要求如下：
匹配接口：给出标题、method、path、分类、接口 ID请求定义：拆成 Path 参数、Query 参数、Header、Body Schema 摘要响应定义：只保留关键字段、对象层级、必填项和必要说明备注：补充分类说明、文档摘要、缓存时间、是否来自缓存、缓存状态--out，备注中必须明确提示“未自动落盘”当显式传入 --json 时，不再输出 Markdown，而是输出结构化 JSON，供其他 skill、脚本或自动化流程继续消费。
按下面顺序定位接口：
method + path 精确命中path 精确命中title 精确或包含命中category 包含命中keyword 在 title/path/desc/markdown 中模糊命中如果 show 返回内容较大：
--out 时，才把完整结果写入文件--out，明确提示如何导出完整结果当在项目根目录的 env 文件中配置了多个项目时：
YAPI_PROJECT_ID=29,35,42
YAPI_TOKEN=token1,token2,token3
刷新所有项目：
node skills/yapi-document/scripts/yapi-document.mjs refresh
刷新特定项目：
node skills/yapi-document/scripts/yapi-document.mjs refresh --project-id 35
在所有项目中查找：
node skills/yapi-document/scripts/yapi-document.mjs find --keyword 患者
在特定项目中查找：
node skills/yapi-document/scripts/yapi-document.mjs find --project-id 35 --keyword 患者
如果 method + path 在多个项目中都存在，会列出所有匹配的项目供选择：
node skills/yapi-document/scripts/yapi-document.mjs show --method GET --path /api/user
直接指定项目查看：
node skills/yapi-document/scripts/yapi-document.mjs show --project-id 35 --method GET --path /api/user
统计所有项目：
node skills/yapi-document/scripts/yapi-document.mjs stats
统计特定项目：
node skills/yapi-document/scripts/yapi-document.mjs stats --project-id 35
示例 1：按 path 查请求体
用户：
帮我查一下 PATCH /plan/update 的请求体定义
处理：
find --method PATCH --path /plan/updateshow --section req-body示例 2：按关键字查接口
用户：
查一下标题里包含患者的接口
处理：
find --keyword 患者示例 3：先刷新再查看详情
用户：
先刷新 YAPI，再告诉我 /user/updateHospitalReport/{userId} 需要哪些参数
处理：
refreshshow --method PATCH --path /user/updateHospitalReport/{userId}示例 4：查完接口后交给 API 封装 skill
用户：
先用 yapi-document 查“获取协议”的接口定义，再把结果交给 api-wrapper 生成 TS 类型和请求封装。
处理：
find --keyword 获取协议 --jsonshow --method POST --path /api/about-us/agreement --section all --json--token，除非明确是在本地调试project-{id}.json