메뉴
检查本地开发环境（node / pnpm / lark-cli / figma-to-code / Figma MCP / npm registry / glab / 代理 等 15 项）是否就绪。新会话开始时由主 Agent 调用一次；只检测 + 给安装命令，不自动跑。如有 ERR 级缺失 -> 告知用户并停止后续动作；只有 WARN/INFO -> 简短提示后继续。glab 缺失 → 用 `glab-setup` skill 引导。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | env-check |
| description | 检查本地开发环境（node / pnpm / lark-cli / figma-to-code / Figma MCP / npm registry / glab / 代理 等 15 项）是否就绪。新会话开始时由主 Agent 调用一次；只检测 + 给安装命令，不自动跑。如有 ERR 级缺失 -> 告知用户并停止后续动作；只有 WARN/INFO -> 简短提示后继续。glab 缺失 → 用 `glab-setup` skill 引导。 |
每次新会话先检测一遍开发环境，按级别决定是否阻断后续工作。
node .claude/hooks/env-check.mjs 2>/dev/null
输出 stdout 一行 JSON：
{
"checkedAt": "...",
"cwd": "...",
"findings": [
{ "level": "ERR" | "WARN" | "INFO", "name": "node", "ok": true|false, "message": "...", "fix": "..." }
]
}
副作用：写 ~/.imagi/env-check.json 缓存（与 SessionStart hook 后台刷新共用同一份）。
为什么不直接
npm view/which一通：env-check.mjs 内部对每个命令带 3s 超时，避免 lark-cli 之类交互式命令卡死。统一走脚本能拿到一致的 JSON 结果。
把 findings 按 level 分桶：
| level | 含义 | 行动 |
|---|---|---|
| ERR | 阻断性缺失（node 版本不够 / npm 全局 bin 不可写） | 告知用户 + 给 fix 命令 + 停止后续工作，等用户处理 |
| WARN | 影响功能但不致命（lark-cli 没装、figma-context 没初始化） | 一行简短提示 + 给 fix 命令；不阻断，继续主任务 |
| INFO | 仅提示（代理设置情况、pnpm 不需要等） | 不输出，除非用户特意问 |
全部通过：完全不提，直接进入用户的真实任务。
只有 WARN/INFO：用一段话总结：
环境检查：N 项 WARN（lark-cli 未装 / figma-context 未初始化 / ...）。先回答你的问题，遇到具体场景需要这些工具时再装。
有 ERR：
环境检查发现阻断项：
- [ERR] node 20.18 不满足 >= 20.19 -> brew upgrade node
- [ERR] npm 全局 bin 不可写 -> 改用 nvm 安装 node
修完再继续。
npm i -g @larksuite/cli 这种命令带网络副作用，不能擅自跑）。~/.imagi/env-check.json在任意空目录中从零创建数字人智能体应用。自动识别场景（业务流/纯对话/能力展示），从内置模板复制项目文件，引导用户改配置、本地调通。Use when 用户说"新建数字人应用""开发智能体""做 XX 场景的 Demo""搭一个数字人""创建一个数字人项目"。
接到"加 Biz 类型 / 加新消息类型 / 加新消息样式 / 发某某卡片 / 想发个表单让用户填 / 消息发出去对端没收到"等需求时触发。引导决策：基础类型 vs 已有 BIZ vs 新增 BIZ；新增 BIZ 必须走后端专属接口 + 前后端共同约定 4 步流程；前端职责仅"调发送接口 + 写展示卡片"。
合并 master 前检查 swagger-repo.json 是否残留 feat 分支，半自动逐条切回并重跑 gen:api。**触发场景**：准备合并到 master 之前（由 git-ship skill 自动调用）/ 修改过 swagger-repo.json 的 branch 字段 / 拉到陌生分支后想确认 API 类型来源 / 用户输入 /check-api-branch。
多模型并行 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 加载）。