ln-011-agent-installer

路径： 文件路径（references/）相对于此技能目录。

Agent 安装程序

类型： L3 Worker 类别： 0XX 共享

安装或更新支持的两个 CLI Agent：Codex CLI 和 Claude Code。每个 Agent 执行一次：安装后立即验证。

必须阅读： 加载 references/coordinator_summary_contract.md、references/environment_worker_runtime_contract.md 和 references/worker_runtime_contract.md

---

输入 / 输出

方向	内容
输入	操作系统信息、每个 Agent 的 disabled 标志、dry_run 标志、可选的 runId、可选的 summaryArtifactPath
输出	结构化摘要封装，其中 payload.status 为 completed / skipped / error，并在 changes / detail 中提供每个 Agent 的安装结果

如果提供了 summaryArtifactPath，请将相同的摘要 JSON 写入该路径。如果未提供，则以内联方式返回摘要，并保持完全独立运行。如果未提供 runId，则在输出摘要封装前生成独立的 run_id。

运行时

运行时系列：environment-worker-runtime

阶段配置：

1. PHASE_0_CONFIG
2. PHASE_1_INSTALL_VERIFY
3. PHASE_2_POST_CODEX_SANITY_CHECK
4. PHASE_3_WRITE_SUMMARY
5. PHASE_4_SELF_CHECK

运行时规则：

• 输出 summary_kind=env-agent-install
• 独立运行时生成自己的 run_id，并写入默认的 Worker 系列产物路径
• 托管运行必须同时提供 runId 和 summaryArtifactPath，并将摘要写入指定的确切路径
• 在报告最终结果前，始终写入通过验证的摘要产物

输出契约

始终按照以下契约构建结构化的 env-agent-install 摘要封装：

• references/coordinator_summary_contract.md
• references/environment_worker_runtime_contract.md

Payload 字段：

• targets
• agents_processed
• agents_skipped
• versions
• codex_drift_detected
• status

---

Agent 注册表

Agent	安装命令	健康检查	交互式
Codex	npm i -g @openai/codex	codex --version	codex 或 codex "prompt"
Claude	npm i -g @anthropic-ai/claude-code 或 claude update	claude --version	claude 或 claude "prompt"

自动化使用：

• Codex：codex exec ...
• Claude：claude -p ...

注意：codex / codex "prompt" 是交互式 TTY 入口。非交互式验证和审查自动化必须使用 codex exec ...，因为当 stdin 不是终端时，Codex 会拒绝直接进入交互模式。

---

工作流

For each enabled agent: Install or Update -> Verify -> Record

阶段 1：安装与验证

对于注册表中的每个 Agent，应用第一个匹配的规则：

条件	操作	报告
disabled: true	跳过	disabled by user
dry_run: true	显示计划执行的命令	dry run
Codex	先运行 npm install -g @openai/codex，再运行 codex --version	版本或错误
已安装 Claude	先运行 claude update，再运行 claude --version	版本或错误
未安装 Claude	先运行 npm install -g @anthropic-ai/claude-code，再运行 claude --version	版本或错误

单次执行： 每个 Agent 的安装和验证作为一个原子操作执行。不单独进行扫描阶段；安装结果即为当前状态。

错误处理：

错误	检测方式	响应
npm 不在 PATH 中	npm --version 失败	优雅地失败，并报告 npm not found in PATH
权限被拒绝	stderr 包含 EACCES	失败，并建议使用 npm install -g --prefix ~/.local {pkg}
网络错误	stderr 包含 ETIMEDOUT 或 ENETUNREACH	失败，并报告 network error
未知错误	任何其他非零退出码	失败，并包含 stderr

输出表格：

Agent Installation:
| Agent  | Action    | Version  | Status |
|--------|-----------|----------|--------|
| Codex  | installed | 0.124.0  | ok     |
| Claude | updated   | 2.1.119  | ok     |

阶段 2：安装后 Codex 健全性检查

成功安装或更新 Codex 后：

1. 检查 ~/.codex/config.toml 顶层的 approval_policy 和 sandbox_mode。
2. 检查已配置的 Codex 市场中是否有指向此仓库的重复活动路径。
3. 如果发现偏差，报告 WARN，并将修复工作交由 ln-013-config-syncer 处理。

此安装程序不会安装市场插件、重写 Codex 市场布局，也不会管理 Codex 执行默认设置。它只报告偏差，以免将安装成功误认为双 Agent 环境运行正常。

---

关键规则

1. 绝不修改 disabled 标记。 尊重这些标记，绝不更改。
2. 优雅地处理失败。 一个 Agent 失败不会阻止另一个 Agent。
3. 仅限全局安装。 CLI 工具必须位于 PATH 中。
4. 报告所有变更。 在最终摘要表中包含配置观察结果。
5. 幂等。 可安全地多次运行。
6. 仅限 Claude 和 Codex。 不要添加无关的 Agent 分支。
7. Codex 市场/插件和执行默认设置的修复工作由 ln-013 负责。 此技能可以检测偏差，但不得自行重写市场/缓存布局或 Codex 顶层权限默认设置。

反模式

不要	应该
将检查、安装和验证分成多个阶段	一次完成：安装后立即验证
自动重试失败的安装	仅尝试一次，并报告失败
使用 sudo npm install	遇到权限问题时建议使用 --prefix
安装标记为 disabled 的 Agent	跳过并清楚地报告
在此处配置 MCP 设置或市场插件	将环境对齐工作交由 ln-013-config-syncer 处理

---

完成标准

• 在一次流程中处理 Codex 和 Claude（安装 + 验证）
• 跳过已禁用的 Agent 并报告
• 每次安装后立即验证版本
• 检查 Codex 市场/插件和执行默认设置，或明确报告需由 ln-013 后续处理
• 显示状态表
• 返回结构化摘要
• 将摘要产物写入受管理或独立的运行时路径

---

版本： 1.1.0 最后更新： 2026-03-23