Update Docs

Perbarui dokumentasi untuk sebuah repositori menggunakan Cursor CLI di GitHub Actions

Perbarui dokumentasi menggunakan Cursor CLI di GitHub Actions. Ada dua pendekatan: otonomi agen penuh atau alur kerja deterministik dengan modifikasi file hanya oleh agen.

auto-update-docs.yml

name: Update Docs

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: Install Cursor CLI
        run: |
          curl https://cursor.com/install -fsS | bash
          echo "$HOME/.cursor/bin" >> $GITHUB_PATH

      - name: Configure git
        run: |
          git config user.name "Cursor Agent"
          git config user.email "[e-mail]"

      - name: Update docs
        env:
          MODEL: gpt-5
          CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          BRANCH_PREFIX: docs
        run: |
          cursor-agent -p "Kamu sedang berjalan di runner GitHub Actions.

          GitHub CLI tersedia sebagai `gh` dan sudah diautentikasi via `GH_TOKEN`. Git tersedia. Kamu punya akses tulis ke konten repositori dan bisa berkomentar di pull request, tapi kamu tidak boleh membuat atau mengedit PR.

          # Konteks:
          - Repo: ${{ github.repository }}
          - Owner: ${{ github.repository_owner }}
          - Nomor PR: ${{ github.event.pull_request.number }}
          - Base Ref: ${{ github.base_ref }}
          - Head Ref: ${{ github.head_ref }}
          - Prefix Cabang Docs: ${{ env.BRANCH_PREFIX }}

          # Tujuan:
          - Implementasikan alur pembaruan dokumentasi end-to-end yang dipicu oleh perubahan inkremental pada PR asli.

          # Persyaratan:
          1) Tentukan apa yang berubah di PR asli dan, jika ada beberapa push, hitung diff inkremental sejak pembaruan docs terakhir yang berhasil.
          2) Perbarui hanya dokumentasi yang relevan berdasarkan perubahan inkremental tersebut.
          3) Pertahankan cabang docs persisten untuk head PR ini menggunakan Prefix Cabang Docs dari Konteks. Buat jika belum ada, perbarui jika sudah ada, lalu push perubahan ke origin.
          4) Kamu TIDAK punya izin untuk membuat PR. Sebagai gantinya, buat atau perbarui satu komentar PR berbahasa natural (1–2 kalimat) yang secara singkat menjelaskan pembaruan docs dan menyertakan tautan compare inline untuk cepat membuat PR.

          # Input dan konvensi:
          - Gunakan `gh pr diff` dan riwayat git untuk mendeteksi perubahan dan menurunkan rentang inkremental sejak pembaruan docs terakhir.
          - Jangan mencoba membuat atau mengedit PR secara langsung. Gunakan format tautan compare di atas.
          - Jaga perubahan seminimal mungkin dan konsisten dengan gaya repo. Jika tidak ada pembaruan docs yang diperlukan, jangan lakukan perubahan dan jangan posting komentar.

          # Deliverable saat pembaruan terjadi:
          - Commit yang dipush ke cabang docs persisten untuk head PR ini.
          - Satu komentar PR berbahasa natural pada PR asli yang menyertakan tautan compare inline seperti di atas. Hindari duplikasi; perbarui komentar bot sebelumnya jika ada.
          " --force --model "$MODEL" --output-format=text