核心用法
本技能提供在 Perry 工作区上调度 OpenCode 和 Claude Code 两大 AI 编码代理的完整工作流,核心模式为「调度 → 设置回调 → 完成通知」。主要流程:
1. 工作区管理:通过 perry start 创建隔离工作区(支持 Git 仓库克隆),任务完成后 perry remove 清理
2. 任务调度:支持 OpenCode(带 Web UI)和 Claude Code(需 TTY)两种代理,可交互式或后台运行
3. 智能通知:通过 Tailscale IP + 网关端口配置 wake 回调,任务完成自动通知;同时强制设置 20 分钟后 cron 兜底检查
4. 批量能力:支持「Army Mode」并行创建多个工作区处理 PR 审查或 issue 修复
显著优点
- 隔离安全:每个任务独立工作区,避免环境污染和代码冲突
- 弹性并行:可同时派发多个代理处理不同 PR/issue,提升吞吐
- 自动化闭环:wake 回调 + cron 兜底双保险,减少人工盯盘
- 双代理选择:OpenCode 适合标准开发任务(有 Web UI),Claude Code 适合特定场景
潜在局限
- 网络依赖:依赖 Tailscale 网络连通性,MagicDNS 在工作区内不生效,需使用 IP 地址
- 配置复杂度:需动态获取 tailnet IP、网关 token,wake 回调拼接易出错
- 资源开销:每个工作区独立容器,大批量任务需考虑宿主机资源
- 调试门槛:代理失败时需手动 SSH 检查日志,对使用者 CLI 熟练度有要求
适合人群
- 需要并行处理多 PR/多 issue 的开发团队
- 追求「fire and forget」自动化工作流的工程师
- 已部署 Perry + Tailscale 基础架构的用户
常规风险
- token 泄露:wake 回调需明文传递 Authorization token,存在日志泄露风险
- 任务失控:后台任务可能无限挂起,必须依赖 cron 兜底机制
- 权限边界:代理在隔离工作区内拥有完整文件系统权限,需确保代码仓库可信
- 网络单点:wake 回调依赖单一网关端口,网络分区时通知失效