Recoup Sandbox Setup

核心用法

setup-sandbox 是沙箱生命周期的初始化技能，专用于全新创建、尚无文件系统的 Recoup 沙箱环境。执行流程高度结构化：首先检测 RECOUP_ACCOUNT_ID 环境变量以决定 CLI 认证方式，随后通过 recoup orgs list 和 recoup artists list 两条命令拉取账户下的完整组织架构数据。基于返回数据，自动创建 orgs/{org}/artists/{artist-slug} 层级目录，并在每个艺人文件夹内写入 RECOUP.md 身份标记文件，最后执行 Git 提交与推送。

显著优点

• 开箱即用的规范性：强制推行统一的目录命名约定（kebab-case slug）和元数据标准，消除团队间的手动配置差异
• 平台身份绑定：RECOUP.md 作为永久身份文件，建立本地工作区与 Recoupable 云端平台的双向映射，支持后续技能的状态追踪
• 幂等性设计：执行前自动检测 orgs/ 目录是否存在，避免重复初始化
• 自动化工作流：完整的 CLI → 文件生成 → Git 提交流水线，减少人工干预

潜在缺点与局限性

• 强依赖外部 CLI：必须预装 recoup CLI 工具并配置有效 API Key，网络中断或认证过期将阻断执行
• 账户级数据拉取：无法选择性初始化部分组织，大型账户可能生成大量空目录结构
• Git 操作侵入性：强制 push origin main，若分支策略非标准或需代码审查可能冲突
• 状态文件静态化：status: not-setup 需人工或后续技能更新，无自动监听机制

适合人群

• Recoupable 平台新用户首次配置沙箱
• 需要为多个艺人项目快速搭建隔离工作区的 A&R 或运营团队
• 遵循"约定优于配置"理念、希望减少目录结构决策成本的开发协作场景

常规风险

• 凭证泄露风险：RECOUP_ACCOUNT_ID 和 API Key 需妥善管理，避免写入日志或提交至仓库
• 目录覆盖误操作：虽设计有存在性检测，但并发执行或手动删除检测标记后可能意外重建
• 平台耦合加深：目录结构与 Recoup 数据模型强绑定，迁移至其他平台需重构文件系统