企业级ai自动化需标准化skill部署流程，包括环境检查（node.js≥18、cli与认证配置）、在线安装（skillstore/github/克隆）、本地部署（目录结构、skill.md、校验）及生效验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
企业级AI自动化实践需要稳定、可审计、可复用的Skill部署流程，不能依赖临时粘贴提示词或手动复制脚本——必须通过标准化目录结构、明确生效范围和校验机制完成部署。
前置环境检查与准备
先确认 Node.js 版本不低于 18：node -v。若输出 v16.20.2 或更低，升级后再继续。
执行 codex --version 验证 CLI 是否可用。无响应或报错 command not found，说明未全局安装：npm install -g @openai/codex。
检查认证文件路径是否正确：cat ~/.codex/auth.json。该文件必须存在且仅含合法 JSON：{"OPENAI_API_KEY":"sk-..."}，【多出逗号、中文引号、空格都会导致401错误】。
确认技能根目录权限正常：ls -ld ~/.codex/skills。若提示 No such file or directory，手动创建：mkdir -p ~/.codex/skills。
在线安装社区 Skill（推荐生产环境）
方法一：使用 skillstore 命令（最轻量，无需 Git）
运行：npx skillstore add yunshuo909/writing-assistant。该命令会自动下载、解压、校验 SKILL.md 并放入用户级目录 ~/.codex/skills/writing-assistant/。
方法二：GitHub 仓库整仓安装（适合团队统一拉取）
执行：npx skills add ComposioHQ/awesome-codex-skills -g。-g 参数表示全局安装，所有子目录下 Skill 均被加载；不加则只装到当前项目 .codex/skills/。
方法三：直接克隆指定 Skill（精准可控，适合审计）
进入用户技能目录：cd ~/.codex/skills → 克隆单个仓库：git clone https://github.com/ComposioHQ/awesome-codex-skills.git temp && mv temp/meeting-notes ./meeting-notes && rm -rf temp。
【注意：克隆后必须确保 SKILL.md 在一级目录内，不能嵌套在子文件夹里】
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
本地手动部署自研 Skill
第一步：建立标准目录结构
在 ~/.codex/skills/ 下新建文件夹，名称即 Skill ID：mkdir my-api-tool。
第二步：编写必填文件 SKILL.md
该文件必须以 YAML Front Matter 开头，且包含 name 和 description 字段；正文需明确写出触发规则与执行步骤。缺失任一字段将导致 Codex 完全忽略该 Skill。
第三步：添加可选资源
按需创建 scripts/（存放 Python/Shell 脚本）、references/（放 Swagger JSON、OpenAPI 规范）、assets/（存 config.yaml、证书等）。Codex 仅读取 SKILL.md 元数据决定是否启用，其余内容仅在触发后按需加载。
第四步：校验目录完整性
运行：codex skill validate my-api-tool。返回 ✅ Valid 表示可通过加载；若报 missing SKILL.md 或 invalid YAML，立即修正。
验证 Skill 是否生效
重启 Codex CLI 或 Desktop 客户端（旧进程不自动重载新 Skill）。
在任意项目目录下执行：codex "列出当前可用的 Skill"。输出中应包含你刚安装的 Skill 名称，如 writing-assistant。
测试触发逻辑：codex "帮我写一篇关于碳中和的技术报告，要求包含政策背景、技术路径、三个案例"。若自动调用 writing-assistant 并分节输出，说明部署成功。
查看加载日志：codex log --level debug | grep "loaded skill"。每行末尾显示路径，确认加载的是你预期的目录（例如 ~/.codex/skills/writing-assistant 而非系统级路径）。
