用途:这是 Apache Airflow Steward 框架安全智能体环境的首次安装引导技能,是文档 docs/setup/secure-agent-setup.md 中标准安装流程的薄包装,让采用者在全新会话中说“设置安全智能体环境”即可进入正确步骤。
主要能力与机制:运行前读取采用者仓库中的 .apache-magpie-overrides/setup-isolated-setup-install.md 覆盖文件并应用其中智能体可读的覆盖;比对 .apache-magpie.local.lock 与提交的 .apache-magpie.lock 检测快照漂移并建议 /magpie-setup upgrade(非阻塞)。漂移分级:方法与 URL 不同需完整重装;ref 不同需同步;svn-zip 的 SHA-512 不匹配属安全警示,需先排查。
使用方式与限制:安装前确认操作系统与发行版(macOS 跳过 bubblewrap 与 socat,Linux 按发行版安装)、框架检出路径,以及是全新安装还是重装。技能不自动执行提权命令,需要 sudo 的命令只打印给用户自行粘贴;不擅自修改 shell rc 文件,也不静默覆盖已有的 .claude/settings.json,合并前需明确批准;遇到首个失败即停止并报告。
安装步骤含项目根目录沙箱白名单覆盖(Step P):因 harness 会静默丢弃 allowRead 中的字面量“.”,需把项目根作为绝对路径写入 .claude/settings.local.json,支持逐项目或整用户两种范围。逐项目范围运行 helper(--all-worktrees)写入各工作树本地设置;整用户范围需先明确告知全局 core.hooksPath 会使所有仓库的 .git/hooks/* 失效,可迁移或改选逐项目,之后安装 helper 与全局 post-checkout 钩子并执行 git config --global core.hooksPath "$HOME/.claude/git-hooks",可用 git config --global --unset core.hooksPath 还原。从智能体会话内调用 helper 需 dangerouslyDisableSandbox: true。验证交由 setup-isolated-setup-verify,后续可接 update 与 setup-shared-config-sync。具体安装命令、目录与文件内容以原文档为准,本资料未提供实际执行结果与效果数据。