القائمة
合并 master 前检查 swagger-repo.json 是否残留 feat 分支，半自动逐条切回并重跑 gen:api。**触发场景**：准备合并到 master 之前（由 git-ship skill 自动调用）/ 修改过 swagger-repo.json 的 branch 字段 / 拉到陌生分支后想确认 API 类型来源 / 用户输入 /check-api-branch。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
在任意空目录中从零创建数字人智能体应用。自动识别场景（业务流/纯对话/能力展示），从内置模板复制项目文件，引导用户改配置、本地调通。Use when 用户说"新建数字人应用""开发智能体""做 XX 场景的 Demo""搭一个数字人""创建一个数字人项目"。
接到"加 Biz 类型 / 加新消息类型 / 加新消息样式 / 发某某卡片 / 想发个表单让用户填 / 消息发出去对端没收到"等需求时触发。引导决策：基础类型 vs 已有 BIZ vs 新增 BIZ；新增 BIZ 必须走后端专属接口 + 前后端共同约定 4 步流程；前端职责仅"调发送接口 + 写展示卡片"。
多模型并行 Code Review。**自动触发场景**：用户拍板 plan 后改完代码（中等 / 复杂任务），AI 主动询问「需要 code review 吗？」**手动触发**：用户输入 `/code-review` 或说「review 一下这次改动 / 帮我看看这次提交」。按改动复杂度分级派 SubAgent，**轻量改动只派 1 个 sonnet 兜底，复杂任务才派 3 个含 opus 架构师**——不浪费最强模型在简单任务上。
公司前端通用编码规范（从 11 个项目 + 飞书知识库抽取）。当用户开始编写/修改前端 TS/TSX/Vue/SCSS 代码，或者需要 code review / 检查规范一致性时，**必须**加载本 skill 作为硬性规则基础。
启动开发环境 + 调试。触发场景："看一下效果 / 跑起来看看 / 启动一下 / 打开看看 / 启动 dev / 跑 dev"。本 skill 读 profile.devServer 配置 → 校验前置 → 后台 spawn dev server → 等 ready → 拼带 token 的真实域名 URL → open 浏览器。同时含项目特定的"关键调试场景"片段（按 profile 加载）。
检查本地开发环境（node / pnpm / lark-cli / figma-to-code / Figma MCP / npm registry / glab / 代理 等 15 项）是否就绪。新会话开始时由主 Agent 调用一次；只检测 + 给安装命令，不自动跑。如有 ERR 级缺失 -> 告知用户并停止后续动作；只有 WARN/INFO -> 简短提示后继续。glab 缺失 → 用 `glab-setup` skill 引导。
| name | check-api-branch |
| description | 合并 master 前检查 swagger-repo.json 是否残留 feat 分支，半自动逐条切回并重跑 gen:api。**触发场景**：准备合并到 master 之前（由 git-ship skill 自动调用）/ 修改过 swagger-repo.json 的 branch 字段 / 拉到陌生分支后想确认 API 类型来源 / 用户输入 /check-api-branch。 |
| argument-hint | ["可选 flag，如 --strict --target-branch main"] |
| allowed-tools | Bash(git *), Bash(node *), Bash(npm *), Read |
合并 master 前检查 swagger-repo.json 是否还残留 feat 分支，半自动逐条切回并重跑 gen:api。
git-ship 合并到 master 之前swagger-repo.json 的某条 branch 后$ARGUMENTS — 可选，传给底层脚本（如 --strict、--target-branch main）
如果当前 PR/MR 的目标分支不是 master（比如要合到一个长期分支），跳过本检查，提示用户："本次合并目标非 master，跳过 swagger 分支检查。"
# 当前所在分支（参考，最终目标分支可能不同）
git branch --show-current
# 当前 upstream（如果设置了）
git rev-parse --abbrev-ref HEAD@{upstream} 2>/dev/null || echo "(no upstream)"
如果用户的合并目标不是 master/main，提示并返回，不跑后续步骤。
node ./scripts/check-swagger-branch.mjs --fix-interactive $ARGUMENTS
脚本会：
branch !== 'master' 的条目swagger-repo.json -> 自动跑 npm run gen:api注意：feat 分支可能确实未合到 master（后端在做的功能），让用户按实际情况决策。禁止强制切回。
如果脚本跑了 gen:api，立即查看 src/__generated__/（或 src/api/__generated__/ 等本项目实际目录）的 diff：
git status --short src/__generated__/ src/api/__generated__/ 2>/dev/null
git diff src/__generated__/ src/api/__generated__/ 2>/dev/null | head -200
提示用户：
## check-api-branch 完成
| 检查项 | 状态 |
|--------|------|
| 目标分支 | master |
| 非 master 条目 | <数量> |
| 切回 | <数量> |
| gen:api | <成功 / 跳过> |
| __generated__ diff | <有 / 无> |
下一步建议：<根据 diff 提示用户>
$ARGUMENTS 加 --config <path>$ARGUMENTS 加 --target-branch main$ARGUMENTS 加 --gen-cmd "<custom>"