Perry Coding Agents

核心用法

Perry Coding Agents 是一套将编码任务委派给远程AI代理的执行框架，支持 OpenCode 和 Claude Code 两款编程助手。通过SSH连接到隔离的Perry工作空间，用户可将开发任务、PR审查、CI修复等工作完全托管给AI代理异步执行。

关键操作流程：
1. 前置任务创建：任何调度前必须先创建dex任务，用于跟踪工作空间IP、分支、目标与完成标准
2. 后台无阻塞调度：通过SSH后台启动代理，不设硬超时，让代理持续运行直至完成
3. IP直连通信：因容器内MagicDNS故障，必须使用 tailscale status 获取实际IP地址
4. 会话上下文复用：OpenCode在 ~/.opencode/ 中保持上下文，同一会话可持续处理关联任务直至CI通过
5. Webhook唤醒机制：代理完成后通过curl回调通知，触发后续检查或新任务调度

显著优点

• 完全异步架构：任务后台运行，不阻塞主工作流，适合长时编译、测试场景
• 环境隔离安全：Perry工作空间提供独立的开发与运行环境，降低本地系统风险
• 上下文持续保持：单会话多轮交互，代理理解代码库历史，减少重复沟通成本
• 双引擎灵活选择：OpenCode适合无TTY自动化任务，Claude Code适合需要交互式会话的场景
• CI闭环管理：从任务创建→代理执行→结果通知→CI检查→修复迭代，形成完整DevOps链条

潜在缺点与局限性

• 网络依赖严苛：依赖Tailscale组网，IP变动或网络波动会中断任务；MagicDNS失效增加运维复杂度
• 缺乏实时可视性：后台运行模式下，任务执行过程黑盒化，仅依赖最终Webhook通知
• SSH密钥/Token管理负担：需维护workspace账号、hooks-token等多凭证，存在泄露与轮换成本
• 错误恢复机制弱：文档未明确代理崩溃或SSH断连后的自动重试策略
• 资源竞争隐患：同一工作空间多任务并发可能导致资源冲突（虽未明禁，但建议"One task per PR"）

适合人群

• 需要批量处理PR审查、单元测试补全的Tech Lead
• 希望将重复性开发任务自动化的全栈工程师
• 构建内部DevOps平台的平台工程团队
• 有多项目并行开发需求，需要隔离环境的开发者

常规风险

• 权限扩散风险：SSH免密配置 (StrictHostKeyChecking=no) 降低中间人攻击防护，需确保Tailscale网络可信
• 代码注入可能：任务描述直接拼接进shell命令，若输入未过滤可能引发命令注入
• Token泄露：hooks-token通过命令行传递，可能在进程列表中被窥探
• 代理行为不可控：AI代理直接操作代码库、创建PR，存在生成不安全代码或误删文件的风险，建议配合代码审查流程

核心用法

Perry Coding Agents 是一款面向开发者的远程任务调度工具，通过 SSH 连接到 Perry workspaces，在隔离环境中运行 OpenCode 或 Claude Code 智能体完成编码任务。其核心工作流遵循"创建任务→后台派发→Webhook 唤醒→CI 验证→迭代修复"的闭环模式。

关键特性：

• 双智能体支持：OpenCode 作为首选（支持后台无 TTY 运行），Claude Code 作为备选（需交互式 TTY）
• 会话持久化：OpenCode 在 ~/.opencode/ 中保持上下文，支持同一 PR 的多轮迭代
• 后台异步执行：通过 & 将任务置于后台，无硬超时限制，配合 Webhook 回调实现" fire-and-forget "
• Tailscale 网络集成：使用 Tailscale IP 替代 MagicDNS（容器内 DNS 受限），通过 tailscale status 获取连接信息

显著优点：
1. 环境隔离：任务在独立 workspace 执行，避免污染本地开发环境
2. 流程闭环：从任务创建、代码开发、PR 提交到 CI 检查形成完整自动化链路
3. 状态保持：同一会话复用机制让智能体理解历史上下文，减少重复沟通成本
4. 零依赖侵入：仅使用系统标准命令（ssh、curl、jq、tailscale），无第三方库引入

潜在局限与风险：

• SSH 安全降级：示例代码使用 StrictHostKeyChecking=no，禁用主机密钥验证，存在中间人攻击风险（RISK-001，medium）
• HTTP 明文传输：Webhook 回调使用未加密的 HTTP 协议（RISK-002，low），存在嗅探风险
• T3 来源可信度：由个人开发者维护，无企业级 SLA 保障，需自行审查更新
• 网络依赖重：依赖 Tailscale 网络连通性，离线或网络波动时无法使用
• Token 管理：Webhook 授权令牌需用户自行安全保管，泄露可能导致未授权唤醒

适合人群：

• 需要并行处理多个编码任务的高级开发者
• 追求"异步开发"、希望减少上下文切换的技术团队
• 已部署 Tailscale 网络基础设施的组织
• 熟悉 SSH、CI/CD 流程的 DevOps 工程师

常规风险提示：
该工具本质是远程命令执行框架，虽然 Skill 本身无危险函数，但派发给智能体的任务内容具有完全执行权限。建议在沙箱环境中充分测试，对生产代码仓库启用分支保护规则，并定期审计 workspace 的访问日志。对于关键基础设施代码，建议结合人工 Code Review 再合并。