技能简介
该技能用于向Perry工作区的OpenCode或Claude Code代理分发编码任务,支持开发工作、PR审查及需要隔离环境的各类编程任务。
业务背景
Perry代码代理调度让开发团队能安全地将编码任务分发至远程隔离环境。无论是日常开发、PR审查还是耗时计算,均可通过SSH直达目标工作区,借助Tailscale网络穿透容器壁垒。后台运行模式突破超时限制,会话上下文持久保留,支持多轮迭代修复,任务完成自动回调通知,实现异步协作与资源弹性利用。
落地案例:某团队需对遗留模块进行安全重构,但本地环境缺乏依赖。技术负责人通过该技能将任务派发至预配置好的Perry工作区:填写任务描述与项目路径,指定目标IP和分支,Wake服务接收Webhook回调。OpenCode代理在后台执行重构并跑通测试套件,全程无需人工盯守;若Claude Code介入复杂逻辑审查,则切换TTY交互模式逐轮确认,最终CI检查结果同步回传,确保交付质量。
能做什么
- 通过SSH向远程工作区发送代码任务
- 在后台运行无超时限制的长时间任务
- 利用Tailscale IP实现容器内网络通信
- 保持会话上下文,支持多轮迭代修复
- 任务完成后通过webhook回调通知
使用说明
安装要求:需具备Perry工作区访问权限、Tailscale网络连接、OpenCode或Claude Code已部署至目标工作区。
配置步骤:
- 获取本机Wake服务IP:
WAKE_IP=$(tailscale status --self --json | jq -r '.Self.TailscaleIPs[0]') - 创建dex任务记录(必须在分发前完成)
- 使用SSH命令分发任务,建议后台运行避免阻塞
OpenCode调用(推荐):
ssh -o StrictHostKeyChecking=no workspace@<IP> "cd ~/<project> && /home/workspace/.opencode/bin/opencode run '任务描述'" &
Claude Code调用(需TTY):
ssh -t workspace@<IP> "cd ~/<project> && /home/workspace/.local/bin/claude '任务描述'"
完整回调模式:在任务描述末尾附加curl命令,指向http://${WAKE_IP}:18789/hooks/wake,携带token和完成摘要。
输入与输出
见下方输入与输出表格。
| 项目 | 内容 |
|---|---|
| 输入 | 任务描述、目标IP、项目路径、Wake回调配置、分支信息、完成标准 |
| 输出 | 后台SSH进程、Webhook通知、任务追踪记录、CI状态反馈 |
| 适用人群 | 使用Perry工作区的开发人员、需要远程代码代理的团队、DevOps自动化维护者 |
| 不包含 | 本地开发环境配置、IDE插件、自动合并功能、实时监控面板 |
风险提示
- 必须先创建dex任务再分发,否则无法追踪
- MagicDNS在容器中不可用,必须使用IP地址
- Claude Code需要交互式终端,不支持纯后台模式
- Webhook回调依赖Wake服务正常运行
- 同一PR应复用会话,避免上下文丢失
来源信息
原始链接:https://github.com/openclaw/skills/tree/main/skills/gricha/perry-coding-agents/SKILL.md
来源类型:GitHub仓库
常见问题
Q1:Perry代码代理调度 适合哪些场景?
A:适合需要「该技能用于向Perry工作区的OpenCode或Claude Code代」的场景,尤其是希望快速验证并落地的团队与个人。
Q2:第一次使用应该先做什么?
A:先明确目标任务,再按照页面中的“能做什么”和“使用说明”完成最小可行流程。
Q3:如何判断是否值得长期使用?
A:建议连续使用 1-2 周,对比效率、稳定性和协作成本,再决定是否纳入长期工具栈。
