用途：让代码仓库在 Amp orbs（Amp 的云沙箱）中正确运行，方法是为其创建或更新 orb 生命周期文件；权威参考见 https://ampcode.com/docs/orbs。
主要能力与文件：项目 pre-clone 脚本在 Amp 克隆或更新仓库前运行，只装克隆所需前置条件；项目 pre-setup 脚本在每次 setup 前立即运行；.agents/setup 对全新 orb 运行一次，安装工具链、依赖、数据库等；.agents/resume 在初始激活后及 orb 每次唤醒后运行，做快速幂等的认证、重连或修复。pre-clone 与 pre-setup 脚本存于项目设置（仓库之外），可用 amp projects get/update 读取和更新，改动会改变快照身份。
必要用法：仓库内方案需提交脚本并设置可执行位：chmod +x .agents/setup .agents/resume。若不想提交 Amp 专用文件，走项目设置路径：先调查仓库，用 amp projects list 找项目 ref，将完整幂等脚本写到仓库外临时文件，用 amp projects update <project> --pre-setup-script-file <path> 保存，不创建或提交仓库文件。
关键限制：setup 需非交互、幂等、快速，目标 2 分钟内，20 分钟为失败上限；不得在 setup 中认证用户，认证放在 resume；resume 最多等 10 秒且不得安装依赖；exact 快照会跳过 setup，陈旧快照会保留包并重跑 setup；setup 失败会阻止发布刷新快照。日志见 ~/.cache/amp/logs/setup.log。