القائمة
帮助用户安装或更新 Agency Agents。主路径：运行支持包内的一键脚本；脚本不可用时回退到 repo_readme_summary.md 第 2 部分。范围：CLI agent 安装、更新、选择工具/division/agent、dry-run 和验证入口；不含卸载、删除配置或桌面应用安装。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Fix npm global install failures for @openai/codex when ENOTEMPTY rename conflicts occur in the global node_modules path.
Write skill_for_setup/SKILL.md and skill_for_setup/README.md for any open-source library in the open_supports/ system. Use after scripts_for_install/ is complete. Implements the script-first pattern: primary path runs the install script; fallback follows repo_readme_summary.md Part 2.
Use when creating or updating an open_supports support package end-to-end, especially when coordinating repo summary, install script, setup skill, clarification, resume, or optional install verification.
帮助用户安装并配置 OpenSpec。主路径：运行支持包内的一键脚本；脚本不可用时回退到 repo_readme_summary.md 第 2 部分。范围：安装/更新 CLI、验证版本、可选初始化或更新项目；不含卸载、删除生成文件或详细使用教程。
Write scripts_for_install/install.sh for any open-source library in the open_supports/ system. Use when adding a new support package that needs a one-click installation script. Produces a POSIX sh script with platform detection, flag-driven interface, and idempotent behavior.
Write repo_readme_summary.md for any open-source library in the open_supports/ system. Use when adding a new support package or updating an existing summary. Produces a concise 5-part structured document distilled from the official README.
| name | ost-msitarzewski-agency-agents-install |
| description | 帮助用户安装或更新 Agency Agents。主路径：运行支持包内的一键脚本；脚本不可用时回退到 repo_readme_summary.md 第 2 部分。范围：CLI agent 安装、更新、选择工具/division/agent、dry-run 和验证入口；不含卸载、删除配置或桌面应用安装。 |
| argument-hint | [--tool=claude-code|codex|all] [--division=engineering] [--agent=frontend-developer] [--project-dir=/path/to/project] [--dry-run] [--verify-only] |
参考：
repo_readme_summary.md
脚本：scripts_for_install/install.sh
官方仓库：msitarzewski/agency-agents
当用户想通过自然语言为 Claude Code、Codex CLI 或脚本支持的其他 AI 工具安装、更新、预览或列出 Agency Agents 时使用本 Skill。
优先覆盖：
--tool=codex 转换并安装 Agency Agents。../../repo_readme_summary.md — 安装方式、手动兜底路径、验证方式和注意事项../../scripts_for_install/install.sh — wrapper 实际支持的平台、参数和验证行为../../.ost-refs/ 目录（如存在）— 本地约定从对话上下文中确认；用户没有明确说明时使用默认值，不额外追问：
| 信息 | 默认值 | 说明 |
|---|---|---|
| 操作系统 | 当前 shell 平台 | 主路径支持 macOS、Linux、WSL、Windows Git Bash/MSYS |
| 目标工具 | 脚本默认检测 | 可显式传 --tool=claude-code 或 --tool=codex |
| 安装范围 | 上游 installer 默认 | 可用 --division=LIST、--agent=LIST 或 --agents-file=PATH 缩小范围 |
| 项目目录 | 当前目录 | 项目级工具用 --project-dir=PATH 指定 |
| 是否先预览 | 否 | 不确定写入位置时先加 --dry-run |
| 官方 checkout 缓存 | ~/.cache/agency-agents/agency-agents | 可用 --repo-dir=PATH 隔离缓存 |
从支持包根目录（本 SKILL.md 向上两级）执行：
sh scripts_for_install/install.sh [flags]
脚本要求当前环境有 git 和 bash。它会克隆或快进官方 msitarzewski/agency-agents checkout，然后以非交互方式调用官方 Bash installer。已有 checkout 若存在本地未提交变更，脚本会停止并要求换 --repo-dir=PATH 或先处理该 checkout。
常用示例：
sh scripts_for_install/install.sh --tool=claude-code --division=engineering --project-dir=/path/to/project
sh scripts_for_install/install.sh --tool=codex --division=engineering --project-dir=/path/to/project
sh scripts_for_install/install.sh --tool=codex --agent=frontend-developer,backend-developer --dry-run
sh scripts_for_install/install.sh --tool=all --parallel
sh scripts_for_install/install.sh --list=teams
sh scripts_for_install/install.sh --verify-only
注意：本 wrapper 的 --tool 白名单为 all、claude-code、copilot、antigravity、gemini-cli、opencode、openclaw、cursor、aider、windsurf、qwen、kimi、codex、osaurus、hermes。不要把 repo_readme_summary.md 中其他历史或官方 README 示例里的工具名直接传给 wrapper，除非脚本已支持。
| 用户意图 | 使用参数 |
|---|---|
| 安装到 Claude Code | --tool=claude-code |
| 安装到 Codex CLI | --tool=codex |
| 安装 engineering division | --division=engineering |
| 安装单个或多个 agent | --agent=frontend-developer,backend-developer |
| 从文件读取 agent 列表 | --agents-file=/path/to/agents.txt |
| 指定项目目录 | --project-dir=/path/to/project |
| 指定官方 checkout 缓存 | --repo-dir=/path/to/cache/agency-agents |
| 覆盖单工具安装目录 | --path=/path/to/tool/config |
| 使用 symlink | --link |
| 不自动转换 | --no-convert |
| 并行安装 | --parallel --jobs=N |
| 只预览 | --dry-run |
| 只验证 wrapper 和上游 installer | --verify-only |
| 列出工具、teams/divisions 或 agents | --list=tools、--list=teams、--list=agents、--list=all |
遇到以下情况时，转为按 repo_readme_summary.md 第 2 部分（安装与更新） 逐步执行：
git 或 bash，且不希望安装这些依赖。--tool 白名单内，但官方摘要提供了对应手动命令。将兜底路径中的安装命令发给用户确认后逐条运行。不要在本 Skill 中默认执行卸载或删除配置。
Wrapper 自检：
sh scripts_for_install/install.sh --verify-only
该命令会确认官方 checkout 存在 scripts/install.sh 和 scripts/convert.sh，并运行上游 installer 的 --list tools 响应检查。
安装前预览：
sh scripts_for_install/install.sh --tool=codex --division=engineering --dry-run
安装后验证方式取决于目标工具；官方摘要没有提供统一的命令行验证。可使用以下事实来源中的检查：
codex --help
opencode agent list
Claude Code 没有在摘要中给出专用 CLI 验证命令；安装完成后重启 Claude Code，并用自然语言提到已安装 agent 名称进行检查，例如 Frontend Developer。
Agency Agents install/update completed.
Next steps:
1. Restart the target AI tool so it reloads agent files.
2. Reference an installed agent by name, for example Frontend Developer.
3. Re-run this script later to fast-forward the official checkout and update files.
For the desktop app instead, use the official release page:
https://github.com/msitarzewski/agency-agents-app/releases/latest
| 现象 | 原因 | 处理 |
|---|---|---|
missing required command: git | wrapper 需要 Git 克隆或更新官方仓库 | 安装 Git 后重试，或改走摘要第 2 部分的手动路径 |
missing required command: bash | 上游官方 installer 是 Bash 脚本 | 安装 Bash 3.2 或更新版本后重试，或改走手动路径 |
unsupported platform | 当前平台不在 macOS、Linux、WSL、Windows Git Bash/MSYS 内 | Windows 用户可使用 Git Bash/MSYS，或安装官方桌面应用 |
checkout has local changes | --repo-dir 指向的官方 checkout 有本地修改 | 处理该 checkout 的修改，或指定新的 --repo-dir=PATH |
--tool must be ... | 传入的工具名不在 wrapper 白名单 | 改用白名单工具名；若官方摘要有手动命令，走兜底路径 |
| 不确定会写入哪些文件 | 多工具安装涉及多个目标目录 | 先运行同参数加 --dry-run |
| 安装后目标工具没有显示 agents | 工具可能需要重新加载配置，或目标目录不符合预期 | 重启目标 AI 工具；必要时用 --dry-run 或 --path=PATH 检查目标目录 |