replicas-agent

Replicas Agent

你是一个在 Replicas 云工作区（远程虚拟机）内运行的后台编码代理。本技能涵盖此环境特有的功能和最佳实践。

功能

本技能为以下功能提供详细指南。在执行任何这些操作之前，请先阅读相关的参考文件。

预览

将本地运行的服务（Web 应用、API、数据库）暴露为公开预览 URL，以便人类直接与之交互。

参考文件： references/PREVIEWS.md

在以下情况下使用：

• 你需要启动一个供人类查看或交互的服务
• 任务涉及需要人工审查的 UI 工作
• 你正在视觉上验证前端/后端集成

Slack

通过 Slack Web API 发送消息、阅读线程、搜索对话和上传文件。

参考文件： references/SLACK.md

在以下情况下使用：

• 你需要向 Slack 频道或线程发送消息
• 你需要读取或获取 Slack 对话
• 你遇到 Slack 消息链接并需要检索其内容
• 任务要求你通过 Slack 进行通知、更新或沟通

Linear

通过 Linear GraphQL API 获取问题、更新状态、添加评论和搜索。

参考文件： references/LINEAR.md

在以下情况下使用：

• 你遇到 Linear 问题链接并需要理解任务
• 你需要更新问题的状态（例如标记为已完成）
• 你需要评论或搜索 Linear 问题

GitHub

使用预认证的 gh CLI 处理拉取请求、问题、操作和 API 调用。

参考文件： references/GITHUB.md

在以下情况下使用：

• 你需要创建、审查或管理拉取请求
• 你需要与 GitHub 问题或操作交互
• 你需要使用 GitHub API 进行高级操作
• 你需要在 PR 描述中包含图片

Google Workspace（文档、表格、表单、云端硬盘）

通过 Replicas 网关创建和编辑 Google 文档、表格和表单。文件归 Replicas 所有——集成无法访问之前在此之外创建的 Google 内容。

参考文件： references/GOOGLE.md

在以下情况下使用：

• 你需要创建或编辑 Google 文档、表格或表单
• 你需要共享、重命名、移动或删除 Replicas 创建的 Google 文件
• 你需要读取 Replicas 创建的 Google 表单的回复

Docker

在 Replicas 工作区中启动并使用 Docker 守护进程。Docker 已预装，但守护进程不会自动启动。

参考文件： references/DOCKER.md

在以下情况下使用：

• 你需要运行 docker 或 docker compose 命令
• 你需要构建或运行 Docker 容器
• 你的任务涉及容器化服务或基于 Docker 的工作流程

媒体

在 Replicas 聊天中内联分享截图、屏幕录制、生成的图表和音频片段（并作为外部消息中的引用）。

参考文件： references/MEDIA.md

在以下情况下使用：

• 你生成了用户应看到的截图、录制、生成的图像或音频片段
• 你录制了视频输出（浏览器自动化、屏幕捕获）——包括推荐的宽高比和帧率
• 你需要在 Slack/Linear/GitHub 消息中嵌入媒体，并在 Replicas 仪表板中保留可引用的副本

Replicas（工作区内 CLI）

使用预安装、预认证的 replicas CLI 与 Replicas 本身交互——管理自动化、环境（变量、文件）、仓库和 replicas.json 配置。

参考文件： references/REPLICAS.md

在以下情况下使用：

• 用户要求你创建、编辑、运行或删除自动化
• 用户要求你管理环境、环境变量或环境文件
• 用户问“我有哪些环境/仓库/自动化？”
• 用户要求你在仓库中搭建 replicas.json / replicas.yaml

对于 关于 Replicas 如何工作的问题（概念、定价、功能作用），请先查看 https://docs.replicas.dev，仅当用户要求你执行操作时才回退到此技能。