Back to Details

ln-011-agent-installer

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese
Paths: File paths (
shared/
, 
references/
) are relative to skills repo root. Locate this SKILL.md directory and go up one level for repo root.
路径说明： 文件路径（
shared/
、
references/
）是相对于技能仓库根目录的。找到此SKILL.md所在目录，向上一级即为仓库根目录。

Agent Installer

Agent 安装器

Type: L3 Worker Category: 0XX Shared
Installs or updates CLI agents via npm and Claude CLI. Single pass per agent: install then immediately verify.
类型： L3 Worker 分类： 0XX Shared
通过npm和Claude CLI安装或更新CLI Agent。每个Agent单次执行：安装后立即验证。

Input / Output

输入/输出

DirectionContent
InputOS info, 
disabled
flags per agent, 
dry_run
flag
OutputPer-agent status: 
installed
/ 
updated
/ 
skipped
/ 
disabled
/ 
failed
方向内容
输入操作系统信息、各Agent的
disabled
标志、
dry_run
标志
输出各Agent状态：
installed
/ 
updated
/ 
skipped
/ 
disabled
/ 
failed

Agent Registry

Agent 注册表

AgentInstall CommandHealth Check
Codex
npm i -g @openai/codex
codex --version
Gemini
npm i -g @google/gemini-cli
gemini --version
Claude
claude update
claude --version
Agent安装命令健康检查
Codex
npm i -g @openai/codex
codex --version
Gemini
npm i -g @google/gemini-cli
gemini --version
Claude
claude update
claude --version

Workflow

工作流程

For each agent: Install → Verify → Record
For each agent: Install → Verify → Record

Phase 1: Install & Verify

阶段1：安装与验证

For each agent in registry, apply first matching rule:
ConditionActionReport
disabled: true
SKIP"disabled by user"
dry_run: true
Show planned command"dry run"
npm agent
npm install -g {pkg}
then 
{cmd} --version
version or error
Claude
claude update
then 
claude --version
version or error
Single pass: install and verify happen atomically per agent. No separate scan phase — the install result IS the state.
Error handling:
ErrorDetectionResponse
npm not in PATH
npm --version
fails		FAIL gracefully, report "npm not found in PATH"
Permission deniedstderr contains "EACCES"FAIL, suggest 
npm install -g --prefix ~/.local {pkg}
Network errorstderr contains "ETIMEDOUT" or "ENETUNREACH"FAIL, report "network error"
Unknown errorAny other non-zero exitFAIL, include stderr
Output table:
Agent Installation:
| Agent  | Action    | Version  | Status |
|--------|-----------|----------|--------|
| Codex  | installed | 0.1.2503 | ok     |
| Gemini | skipped   | -        | disabled by user |
| Claude | updated   | 1.0.30   | ok     |
对于注册表中的每个Agent，应用第一个匹配的规则：
条件操作报告
disabled: true
跳过"用户已禁用"
dry_run: true
显示计划执行的命令"模拟运行"
npm Agent执行
npm install -g {pkg}
然后
{cmd} --version
版本信息或错误信息
Claude执行
claude update
然后
claude --version
版本信息或错误信息
单次执行： 每个Agent的安装和验证是原子性操作。没有单独的扫描阶段——安装结果即为当前状态。
错误处理：
错误检测方式响应
npm不在PATH中
npm --version
执行失败		优雅失败，报告"npm未在PATH中找到"
权限不足标准错误输出包含"EACCES"失败，建议使用
npm install -g --prefix ~/.local {pkg}
网络错误标准错误输出包含"ETIMEDOUT"或"ENETUNREACH"失败，报告"网络错误"
未知错误其他非零退出码失败，包含标准错误输出内容
输出表格：
Agent Installation:
| Agent  | Action    | Version  | Status |
|--------|-----------|----------|--------|
| Codex  | installed | 0.1.2503 | ok     |
| Gemini | skipped   | -        | disabled by user |
| Claude | updated   | 1.0.30   | ok     |

Critical Rules

核心规则

  1. Never modify 
    disabled
    flags.     Respect them, never change them
  2. Fail gracefully. One agent failure does not block others
  3. Global install only. Always 
    npm install -g
    (CLI tools must be in PATH)
  4. No side effects. Only npm global packages touched. No config files modified
  5. Idempotent. Safe to run multiple times
  1. 绝不修改
    disabled
    标志    ：严格遵守，绝不更改
  2. 优雅失败：单个Agent失败不影响其他Agent执行
  3. 仅全局安装：始终使用
    npm install -g
    （CLI工具必须在PATH中）
  4. 无副作用：仅修改npm全局包，不修改任何配置文件
  5. 幂等性：可安全多次运行

Anti-Patterns

反模式

DON'TDO
Separate check/install/verify phasesSingle pass: install then verify
Retry failed installs automaticallyOne attempt, report failure
Use 
sudo npm install
Suggest 
--prefix
for permission issues
Install agents marked 
disabled
Skip with clear report
禁止操作正确操作
将检查/安装/验证阶段分开执行单次执行：安装后立即验证
自动重试失败的安装仅尝试一次，报告失败
使用
sudo npm install
遇到权限问题时建议使用
--prefix
参数
安装标记为
disabled
的Agent		跳过并给出明确报告

Definition of Done

完成标准

  • All agents processed in single pass (install + verify)
  • Disabled agents skipped with report
  • Version verified immediately after each install
  • Status table displayed
Version: 1.1.0 Last Updated: 2026-03-23
  • 所有Agent均以单次执行（安装+验证）处理完成
  • 已禁用的Agent被跳过并生成报告
  • 每个Agent安装后立即验证版本
  • 显示状态表格
版本： 1.1.0 最后更新时间： 2026-03-23