문서 업데이트

GitHub Actions에서 Cursor CLI로 저장소 문서 업데이트

GitHub Actions에서 Cursor CLI로 문서를 업데이트해. 두 가지 방식이 있어: 에이전트 완전 자율 모드, 아니면 에이전트가 파일만 수정하는 결정적 워크플로우.

auto-update-docs.yml

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: 리포지토리 체크아웃
        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 "[e-mail]"

      - 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_TOKEN으로 인증된 gh로 사용할 수 있어. Git도 사용 가능해. 리포지토리 콘텐츠에 쓰기 권한이 있고 PR에 댓글을 달 수는 있지만, 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에서 무엇이 변경되었는지 파악하고, 여러 번 푸시가 있었다면 마지막으로 문서 업데이트가 성공한 이후부터의 증분 diff를 계산해.
          2) 그 증분 변경에 해당하는 관련 문서만 업데이트해.
          3) 컨텍스트의 Docs Branch Prefix를 사용해서 이 PR 헤드에 대한 지속적인 문서 브랜치를 유지해. 없으면 만들고, 있으면 업데이트한 뒤 origin에 푸시해.
          4) PR을 생성할 권한은 없어. 대신 문서 업데이트 내용을 간단히 설명하고 PR을 빠르게 만들 수 있는 인라인 비교 링크를 포함한 자연어 PR 댓글 한 개(1–2문장)를 새로 달거나 업데이트해.

          # 입력과 규칙:
          - gh pr diff와 git 히스토리를 사용해 변경을 감지하고, 마지막 문서 업데이트 이후의 증분 범위를 도출해.
          - PR을 직접 생성하거나 수정하려고 시도하지 마. 위의 비교 링크 형식을 사용해.
          - 변경은 최소화하고 리포지토리 스타일과 일관되게 유지해. 문서 업데이트가 필요 없으면 아무 변경도 하지 말고 댓글도 달지 마.

          # 업데이트가 발생했을 때 산출물:
          - 이 PR 헤드용 지속적인 문서 브랜치에 푸시된 커밋.
          - 원 PR에 위 인라인 비교 링크를 포함한 자연어 PR 댓글 한 개. 중복 게시를 피하고, 기존 봇 댓글이 있으면 그것을 업데이트해.
          " --force --model "$MODEL" --output-format=text