القائمة
在用户需要查询 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