replicas-agent

Replicas Agent

你是一個在 Replicas 雲端工作區（遠端 VM）內執行的背景編碼代理。本技能涵蓋此環境特有的功能與最佳實務。

功能

本技能提供以下功能的詳細指南。在執行任何這些操作前，請先閱讀相關的參考檔案。

預覽

將本地執行的服務（網頁應用程式、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 處理拉取請求、議題、Actions 及 API 呼叫。

參考檔案： references/GITHUB.md

在以下情況使用：

• 你需要建立、審查或管理拉取請求
• 你需要與 GitHub 議題或 Actions 互動
• 你需要使用 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

在以下情況使用：

• 你產生了使用者應看到的螢幕截圖、錄影、產生的圖片或音訊片段
• 你錄製了影片輸出（瀏覽器自動化、螢幕擷取）——包括建議的長寬比和 FPS
• 你需要將媒體嵌入 Slack/Linear/GitHub 訊息中，並在 Replicas 儀表板中保留可參考的副本

Replicas（工作區內 CLI）

使用預先安裝且預先認證的 replicas CLI 與 Replicas 本身互動——管理自動化、環境（變數、檔案）、儲存庫及 replicas.json 設定。

參考檔案： references/REPLICAS.md

在以下情況使用：

• 使用者要求你建立、編輯、執行或刪除自動化
• 使用者要求你管理環境、環境變數或環境檔案
• 使用者問「我有哪些環境/儲存庫/自動化？」
• 使用者要求你在儲存庫中建立 replicas.json / replicas.yaml 的基礎結構

對於關於 Replicas 如何運作的問題（概念、定價、功能說明），請先查閱 https://docs.replicas.dev，只有當使用者要求你執行操作時，才回退到此技能。