perry-coding-agents

🛠️ 远程 AI 编码代理调度中枢

🥥5总安装量 2评分人数 2
100% 的用户推荐

基于 Perry 工作空间的远程 AI 编码代理调度方案,通过 SSH 连接 OpenCode/Claude Code 实现隔离环境开发,支持 PR 全流程自动化与任务追踪。

B

存在边界风险,建议在隔离环境中验证

  • 来自可信组织或认证账号,需要结合权限范围判断
  • ✅ 纯文档型 skill,无可执行代码,无动态代码执行风险
  • ✅ 无硬编码密钥,使用 `<hooks-token>>` 占位符,安全实践良好
  • ⚠️ SSH 配置使用 `StrictHostKeyChecking=no`,存在理论 MITM 风险,建议在受控 Tailscale 网络中使用
  • ⚠️ 依赖外部 webhook 回调机制,需确保 token 通过安全方式配置
  • ✅ 依赖工具链均为知名开源/商业产品(OpenCode、Claude Code、Tailscale、gh CLI)

使用说明

核心用法

Perry Coding Agents 是一套面向远程开发场景的 AI 编码任务调度方案。用户通过 SSH 连接到 Perry 工作空间,调用 OpenCode 或 Claude Code 执行开发任务。核心工作流遵循"先创建任务、后调度执行"的原则:首先创建 dex 任务记录工作空间 IP、分支、目标与完成标准,然后通过 SSH 在后台无超时地派发任务,任务完成后通过 webhook 回调通知。支持单 PR 单任务、会话复用以保持上下文,直至 CI 通过方可标记完成。

显著优点

该方案的最大优势在于环境隔离与安全性。通过 Perry 工作空间实现开发环境隔离,避免本地环境污染;结合 Tailscale 组网确保网络层安全。其次,会话持久化设计让 OpenCode 在 ~/.opencode// 中保持上下文,支持多轮迭代修复。后台无超时运行模式适合长时间任务,配合 webhook 回调实现异步协作。此外,文档提供了完整的 PR 流程示例,从任务创建、代码开发、CI 检查到最终完成,形成闭环管理。

潜在缺点与局限性

作为纯文档型 skill,其执行依赖外部工具链:必须预先配置 Tailscale、SSH 密钥、OpenCode/Claude Code 安装及 webhook 服务端,上手门槛较高。StrictHostKeyChecking=no 的 SSH 配置虽在 Tailscale 内网相对安全,但仍存在理论 MITM 风险。MagicDNS 在容器中不可用,强制使用 IP 地址增加了配置复杂度。此外,Claude Code 需要 TTY 支持,无法像 OpenCode 那样完全后台化运行。

适合的目标群体

该 skill 主要面向拥有 Perry 工作空间基础设施的技术团队,特别是需要隔离开发环境、进行代码审查或处理敏感代码库的场景。适合已采用 Tailscale 组网、使用 GitHub 进行版本控制、并希望将 AI 编码助手集成到现有工作流的开发团队。对于个人开发者或缺乏远程工作空间资源的用户,该方案难以直接落地。

使用风险

配置风险:SSH 凭证、webhook token 若配置不当可能导致未授权访问,需通过环境变量注入而非硬编码。网络依赖:Tailscale 网络故障将阻断全部功能。工具链版本:OpenCode/Claude Code 的更新可能破坏命令兼容性。性能考量:远程 SSH 执行相比本地运行存在延迟,大文件传输可能成为瓶颈。监控缺失:后台任务失败时缺乏自动重试机制,需依赖 webhook 或主动轮询检查状态。

perry-coding-agents 内容

手动下载zip · 1.8 kB
SKILL.mdtext/markdown
请选择文件