---
title: "設定 App 自動化任務"
description: "基於官方 Codex App Automations 教程，講清 automations 適合什麼重複任務、worktree 怎麼選、許可權怎麼控。"
verifiedAt: "2026-05-06"
---

import { Cards, Card } from 'fumadocs-ui/components/card';

Codex App Automations 用來在後臺定期執行重複任務。有發現時進入 inbox；沒有需要報告的內容時自動歸檔。複雜任務可以和 skills 結合。

> [!WARNING]
> Automation 是無人值守執行，不是“省一個點選”。建立前必須寫清許可權、範圍、停止條件和結果審查方式。

<Cards>
  <Card title="Automations" href="https://developers.openai.com/codex/app/automations">
    官方 App 自動化任務說明。
  </Card>
  <Card title="Worktrees" href="/zh-Hant/docs/codex/official/01-products/43-worktrees">
    寫入型自動化優先隔離到後臺 worktree。
  </Card>
  <Card title="Skills" href="/zh-Hant/docs/codex/official/03-extensions/09-skills-reuse">
    重複流程先沉澱成 skill，再交給 automation 反覆執行。
  </Card>
</Cards>

## 它解決什麼

```mermaid
flowchart LR
    Schedule["schedule"] --> Run["background run"]
    Run --> Finding["findings"]
    Finding --> Inbox["inbox"]
    Run --> Silent["nothing to report"]
    Silent --> Archive["auto archive"]
```

適合 automation 的任務，通常有固定頻率、固定範圍、固定判斷標準：

- 定期檢查 PR 狀態。
- 掃描最近提交風險。
- 彙總某個目錄變化。
- 跟進長期命令是否完成。
- 提醒某個 review loop 繼續推進。

不適合 automation 的任務：

- 目標模糊。
- 需要頻繁人工判斷。
- 會改大範圍檔案。
- 會觸碰憑據或生產配置。
- 沒有停止條件。

## Thread 還是 standalone

Thread automation 掛在當前 thread 上，適合需要保留同一段上下文的任務。比如持續跟進一個部署、一個 PR review、一個正在排查的問題。

Standalone automation 每次按 schedule 啟動 fresh run，適合彼此獨立的週期任務。比如每天看某個目錄最近變化、每週生成文件過期報告。

判斷原則很簡單：

- 每次 run 都應該從乾淨上下文開始：standalone。
- 必須記住這段對話裡的歷史：thread automation。
- 任務範圍還沒穩定：先別自動化。

## Local project 還是 worktree

Git 儲存庫裡，automation 可以在本地專案中執行，也可以在後臺 worktree 中執行。

Local project 會直接碰當前 checkout，可能改到你正在編輯的檔案。只適合只讀任務，或你明確希望它處理當前工作區。

Worktree 會把 automation 的改動和你正在做的工作隔離開。涉及寫檔案、生成 patch、長期後臺執行時，新手優先選 worktree。

未使用版本控制的專案沒有這種隔離，automation 會直接在專案目錄中執行。風險更高，只建議做只讀任務。

## 許可權怎麼給

Automations 使用你的預設 sandbox settings。

- read-only：適合檢查、總結、提醒。
- workspace-write：適合在明確範圍內寫入檔案。
- full access：後臺任務風險最高，除非在可重建環境裡，不要預設啟用。

需要特殊命令時，優先用 rules 選擇性 allowlist，而不是把整個 automation 放到 full access。企業環境裡，管理員還可以用 managed configuration 限制 approval policy 和 sandbox modes。

## Prompt 怎麼寫

Automation prompt 要能在未來反覆執行，不能依賴“剛才我們說的那個”。

必須寫清：

- 任務範圍。
- 檢查頻率。
- 什麼時候報告。
- 什麼時候歸檔。
- 什麼時候停止。
- 什麼時候向使用者要輸入。

如果它會改檔案，還要寫清：

- 允許目錄。
- 禁止目錄。
- 驗證命令。
- 輸出格式。
- 失敗時如何處理。

如果任務複雜，先做 skill。用 skill 定義穩定流程，再在 automation 中顯式呼叫它，比把長 prompt 直接塞進 automation 更可維護。

## 常見坑

- 沒手動測試 prompt 就設 schedule。
- 讓 automation 在本地 checkout 寫檔案，干擾自己正在開發的改動。
- 把一次性模糊任務做成長期自動化。
- full access 後臺執行，事後才發現改了不該改的檔案。
- 沒有停止條件，automation 一直報告低價值結果。
- 使用 worktree 後不清理歷史 runs。
- 結果進 inbox 後不審查，以為自動化等於完成。

## 驗收清單

- 普通 thread 手動跑過一次 prompt。
- scope、工具、模型和輸出符合預期。
- 前幾次 run 都逐條審查 inbox。
- 寫入發生在 worktree 或允許範圍內。
- 驗證命令真實執行。
- 沒有發現內容時能安靜歸檔。
- 任務完成後能停止 automation 並清理不再需要的 worktree。

## 官方資料

- [Automations](https://developers.openai.com/codex/app/automations)
- [Codex App worktrees](https://developers.openai.com/codex/app/worktrees)
- [Rules](https://developers.openai.com/codex/rules)
- [Skills](https://developers.openai.com/codex/skills)
