Menu
合并 master 前检查 swagger-repo.json 是否残留 feat 分支，半自动逐条切回并重跑 gen:api。**触发场景**：准备合并到 master 之前（由 git-ship skill 自动调用）/ 修改过 swagger-repo.json 的 branch 字段 / 拉到陌生分支后想确认 API 类型来源 / 用户输入 /check-api-branch。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
在任意空目录中从零创建数字人智能体应用。自动识别场景（业务流/纯对话/能力展示），从内置模板复制项目文件，引导用户改配置、本地调通。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>"