核心用法
该技能实现 Perry 工作空间 + 编码代理 的异步开发工作流,将编码任务分派至隔离的 Tailscale 容器环境,由 OpenCode 或 Claude Code 自主执行。
关键操作模式:
- 创建/SSH 进入 Perry 工作空间,通过
git clone初始化代码库 - 使用
opencode run或claude命令分派背景任务,禁止设置超时,依赖 wake callback 通知完成 - 强制使用 IP 地址连接(MagicDNS 在容器内失效),SSH 采用非登录 shell,需使用完整路径调用代理
- 任务追踪系统记录 workspace、branch、goal,同一任务复用会话上下文直至完成
显著优点
- 完全隔离:Perry 工作空间提供独立开发环境,避免本地环境冲突
- 异步非阻塞:背景执行 + wake callback 机制,适合长时间 CI/测试流程
- 会话连续性:OpenCode 在
~/.opencode/持久化历史,后续指令无需重复背景说明 - 自动迭代:CI 失败时可直接追加指令,代理基于已有上下文修复,无需重启任务
潜在局限与风险
- 网络依赖:Tailscale 连接故障将阻断全部工作流
- MagicDNS 限制:必须使用 IP 地址,增加脚本编写复杂度
- 无超时机制:僵尸任务需人工通过
ps aux/tail排查 - Token 管理:wake callback 的认证令牌需外部配置注入
适合人群
- 需要并行处理多个开发任务的技术团队
- 追求"fire and forget"异步工作流的高级开发者
- 已部署 Perry + Tailscale 基础设施的组织
常规风险
- 网络分区导致任务状态不可知
- 代理在复杂重构中可能偏离原始目标(需明确 done criteria)
- 多任务并发时的资源竞争(Perry 工作空间资源限制)