更新文件

name: 更新文件

on:
  pull_request:
    types: [opened, synchronize, reopened, ready_for_review]

permissions:
  contents: write
  pull-requests: write

jobs:
  auto-docs:
    if: ${{ !startsWith(github.head_ref, 'docs/') }}
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: 安裝 Cursor CLI
        run: |
          curl https://cursor.com/install -fsS | bash
          echo "$HOME/.cursor/bin" >> $GITHUB_PATH

      - name: 設定 git
        run: |
          git config user.name "Cursor Agent"
          git config user.email "cursoragent@cursor.com"

      - name: 更新文件
        env:
          MODEL: gpt-5
          CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          BRANCH_PREFIX: docs
        run: |
          cursor-agent -p "你正在 GitHub Actions 執行環境中運作。

          GitHub CLI 以 \`gh\` 提供，並透過 \`GH_TOKEN\` 已完成驗證。可使用 Git。你擁有對版本庫內容的寫入權限，也能在拉取請求上留言，但不能建立或編輯 PR。

          # 背景：
          - Repo: ${{ github.repository }}
          - Owner: ${{ github.repository_owner }}
          - PR Number: ${{ github.event.pull_request.number }}
          - Base Ref: ${{ github.base_ref }}
          - Head Ref: ${{ github.head_ref }}
          - Docs Branch Prefix: ${{ env.BRANCH_PREFIX }}

          # 目標：
          - 依原始 PR 的增量變更，實作端到端的文件更新流程。

          # 要求：
          1) 判斷原始 PR 的變更內容；若有多次推送，計算自上次成功文件更新以來的增量差異。
          2) 僅依據這些增量變更更新相應的文件。
          3) 使用背景中的 Docs Branch Prefix 維護此 PR head 的常駐文件分支；若不存在則建立，否則更新，並將變更推送到 origin。
          4) 你無權建立 PR。改為發佈或更新一則自然語言的 PR 註解（1–2 句），簡要說明文件更新，並包含一個內嵌的比較連結以快速建立 PR。

          # 輸入與慣例：
          - 使用 \`gh pr diff\` 與 git 歷史來偵測變更，並推導自上次文件更新以來的增量範圍。
          - 不要嘗試直接建立或編輯 PR。請使用上述的比較連結格式。
          - 讓變更最小化並符合版本庫風格。若不需更新文件，就不要做任何變更也不要留言。

          # 更新發生時的交付內容：
          - 已推送到此 PR head 的常駐文件分支的提交。
          - 在原始 PR 上的一則自然語言註解，包含上述的內嵌比較連結。避免重複留言；若已有機器人留言則更新之。
          " --force --model "$MODEL" --output-format=text