用途：在用户仓库中完成 Symphony 的安装与配置。Symphony 是 OpenAI 的编排器，可将 Linear 工单转成由自主 Codex 智能体提交的 PR。
预检：需 codex 已安装并认证、mise 已安装、gh 已安装且认证（智能体用其创建和关闭 PR）、LINEAR_API_KEY 持久化、Linear MCP 可用（Claude Code 用 claude mcp add --transport http linear https://mcp.linear.app/mcp；Codex 用 codex mcp add linear --url https://mcp.linear.app/mcp）、仓库克隆 URL 可非交互克隆（HTTPS 密码提示会静默失败，建议无口令 SSH 或凭据助手）。
构建：git clone https://github.com/odysseus0/symphony 后 cd symphony/elixir，执行 mise trust && mise install、mise exec -- mix setup、mise exec -- mix build。若平台无预编译 Erlang/Elixir，需从源码编译，可能耗时 10-20 分钟，应提前告知用户。
准备仓库：自动探测仓库路径、克隆 URL、安装命令，并由用户确认；用 Linear MCP 列出项目让用户选择 slugId；检查并创建三个必需的自定义工作流状态（Rework #db6e1f、Human Review #da8b0d、Merging #0f783c），创建前需用户确认；自动探测是否有可启动 UI，如无则跳过。
安装：在用户仓库执行 npx skills add odysseus0/symphony -a codex -s linear land commit push pull debug --copy -y（--copy 必需，-s 排除 symphony-setup 元技能），并复制 elixir/WORKFLOW.md 全文。随后修改其 frontmatter 的 tracker.project_slug 和 after_create 钩子（替换为克隆用户仓库及安装命令），其余保持默认。若有 UI 则创建 .agents/skills/launch-app/SKILL.md，之后提交并推送到远程，未推送的更改对工作进程不可见。
运行前：用 Linear MCP 列出活跃状态工单，Symphony 会立即为所有活跃工单派发智能体，需用户确认。运行：cd <symphony-path>/elixir 后 mise exec -- ./bin/symphony <repo-path>/WORKFLOW.md --i-understand-that-this-will-be-running-without-the-usual-guardrails；该标志必需，因 Symphony 以 danger-full-access 沙箱运行 Codex；加 --port <port> 可启用 Phoenix 网页仪表板。
验证与限制：推送测试工单到 Todo 观察首个工作进程；失败时检查 LINEATE_API_KEY、codex 认证、gh 认证、克隆 URL、技能与 WORKFLOW.md 是否已推送、自定义状态是否已创建。WORKFLOW.md 约 1 秒热重载，可调整 max_concurrent_agents、max_turns、polling.interval_ms。具体费用、性能数据暂未提供。