GitHub Action

이 페이지는 GitHub Pull Request 안에 표시되는 PR Report 설정입니다. local CLI setup 만 끝내고 싶다면 먼저 설치 를 읽고, reviewer 에게 Agent Note summary 를 보여줄 때 다시 돌아오세요.

Quick Setup

리포지토리에서 아래 명령을 한 번 실행합니다:

npx agent-note init --agent claude

이렇게 하면 PR 리포트 workflow 가 생성됩니다:

name: Agent Note PR Report
on:
  pull_request:
    types: [opened, reopened, synchronize]
permissions:
  contents: read
  pull-requests: write
jobs:
  report:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 0
      - uses: wasabeef/AgentNote@v1
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

이제 모든 PR 에 AI 세션 리포트가 추가됩니다.

Inputs

Input	Default	설명
`base`	PR base branch	비교 기준 branch
`pr_output`	`description`	PR 리포트의 출력 위치: `description`, `comment`, `none`
`prompt_detail`	`compact`	PR 리포트에 표시할 prompt 기록의 상세도: `compact` 는 리포트를 핵심 중심으로 유지하고, `full` 은 저장된 모든 prompt 를 표시합니다
`dashboard`	`false`	PR Report Mode 대신 Dashboard Mode 를 실행합니다. 보통 `agent-note init --dashboard` 가 생성합니다

Dashboard

npx agent-note init --agent claude --dashboard

Outputs

Output	타입	설명
`overall_ai_ratio`	number	PR 전체 AI Ratio (0-100)
`overall_method`	string	`line`, `file`, `mixed`, `none`
`tracked_commits`	number	agent-note 데이터가 있는 commit 수
`total_commits`	number	PR 안의 전체 commit 수
`total_prompts`	number	모든 commit 의 전체 prompt 수
`json`	string	전체 구조화 리포트
`markdown`	string	렌더링된 Markdown 리포트
`should_deploy`	boolean string	Dashboard Mode 에서 Pages 공개 여부를 caller workflow 에 알려주는 출력

리포트 구성

PR 리포트에는 다음이 들어갑니다.

Header — Total AI Ratio 와 bar, 그리고 그 아래 Model
Reviewer Context — AI Review tool 을 위한 숨겨진 Markdown comment 입니다. 범용 changed area 그룹, review focus, 최신 관련 intent signals 로 만듭니다
Table — commit 별 AI Ratio, prompt 수, file 목록
Prompts — commit 별 📝 Context, 🧑 Prompt, 🤖 Response 를 접어서 보여주는 섹션

AI Review tool

Reviewer Context 는 PR body 안에 숨겨진 Markdown comment 로 저장됩니다. 사람 reviewer 는 일반 report 만 보고, raw PR description 을 읽는 tool 은 추가 context 를 사용할 수 있습니다.

이 context 는 Agent Note data 에서 deterministic 하게 만들어집니다. changed area, review focus, 최신 관련 intent signals 를 요약하므로 Copilot, CodeRabbit, Devin, Greptile 같은 tool 이 diff 를 보기 전에 PR 의 의도를 이해하는 데 도움이 됩니다.

다만 proof 는 아닙니다. review tool 은 실제 diff, test, code 와 반드시 비교해야 합니다.

다음 단계

Open / Merged PR 기록을 Pages 에서 함께 보고 싶다면 Dashboard 로 이어서 보세요.