用途:为尚未启用安全设置的采用者提供首次安装引导,是 docs/setup/secure-agent-setup.md 中规范安装路径的轻量包装,让用户在新会话中直接说“设置安全智能体环境”即可进入正确流程。
主要能力:先做运行时路由,按会话元数据与可执行文件判断当前 harness;Codex 走 docs/adapters/codex.md,Gemini CLI 走 docs/adapters/gemini.md,Claude Code 才继续本技能流程,无法判断时只询问一次。运行前读取采用者仓库中的 .apache-magpie-local/setup-isolated-setup-install.md 与 .apache-magpie-overrides/setup-isolated-setup-install.md 应用覆盖;比较 .apache-magpie.local.lock 与 .apache-magpie.lock 检测快照漂移并提出升级。
使用方式:安装前确认操作系统与发行版、框架检出路径、全新安装还是重装、是否维护 ~/.claude-config 同步仓库。按文档步骤逐步执行,验证环节交给 setup-isolated-setup-verify。Claude Code 用 npm install -g --no-save @anthropic-ai/claude-code@latest 安装并检查 min_version 下限。
限制:不自动运行提权命令,sudo 命令仅打印供用户粘贴;不擅自修改 shell rc 文件;不静默覆盖已有设置文件;首个失败即停止。可选步骤 K、L、M 非必需。安装后页脚标签含义需正确理解,标签读取设置文件而非运行进程。