Qwen Code 0.21.1: AI 리뷰 에이전트 내부의 CI 폴링 (Polling) 중단

빠른 답변

Qwen Code 0.21.1은 분류 (triage) 워크플로우를 변경합니다. AI 리뷰어는 더 이상 자신의 턴 (turn) 중 일부를 CI 폴링 (polling)에 소비하지 않으며, 필수 결과가 아직 대기 중인 상태에서 승인하지 않습니다. 대신 리뷰된 커밋과 현재 증거 (evidence)를 한 번 기록한 뒤, CI가 완료되면 결정론적인 (deterministic) GitHub Actions 파이널라이저 (finalizer)가 깨어나 사실 관계를 새로 고침하고 결정을 해결합니다.

재사용 가능한 패턴은 다음과 같습니다:

1. 에이전트가 변경 사항을 분석하고 잠정적인 판결 (provisional verdict)을 내리도록 합니다.
2. 해당 판결과 그 증거를 하나의 헤드 커밋 (head commit)에 바인딩합니다.
3. 필수 체크 항목이 대기 중인 경우, 승인하는 대신 좁은 범위의 "통과 시 승인 (approve on green)" 의도를 방출합니다.
4. workflow_run으로부터 비모델 (non-model) 파이널라이저 (finalizer)를 깨웁니다.
5. PR 상태, 헤드 SHA, 체크 스위트 (check suites) 및 기존 리뷰를 다시 읽습니다.
6. 증거 세트가 닫히고 통과(green) 상태일 때만 승인합니다. 그렇지 않으면 보류하거나 실패로 처리 (fail closed)합니다.

이것은 모든 저장소에 적용되는 새로운 Qwen Code 토글 (toggle)이 아닙. 공식 릴리스는 Qwen Code 자체의 분류 (triage) 구현을 통해 이 패턴을 공개합니다. 아키텍처를 조정할 수는 있지만, 귀하의 저장소를 위한 워크플로우를 직접 구축하고 보안을 확보해야 합니다.

대상 사용자

이 가이드는 GitHub Actions에서 AI 풀 리퀘스트 (pull-request) 리뷰어, 자동 수정 (autofix) 봇 또는 코딩 에이전트 파이프라인을 구축하는 유지 관리자 (maintainers)를 위한 것입니다. 에이전트가 CI 완료 전에 작업을 마쳐서, 폴링 (polling)이 리소스를 낭비하거나 가장 느린 체크가 완료되기 전에 만료되는 경우에 적용됩니다.

에이전트가 실제로 무엇을 완료했는지 증명하는 것이 첫 번째 문제라면, Qwen Goal 증거 체크리스트부터 시작하세요. 이슈가 자동으로 에이전트 작업을 생성하는 문제가 있다면, 모든 쓰기 작업 앞에 신뢰도 및 승인 게이트 (confidence and approval gate)를 유지하십시오.

변경 사항 및 중요성

Qwen Code 0.21.1 릴리스 노트에 따르면, 이제 트리아지 (triage) 흐름에서 에이전트 내부의 CI 폴링 (polling)을 중단하고, CI가 완료된 후 증거 (evidence) 및 승인 (approval)을 확정합니다. 병합된 구현 내용에 따르면, 기존 루프는 긴 유닛 테스트 스위트 (unit suite)가 약 30분 정도 소요되는 동안 약 10분 동안 폴링을 수행했습니다. 측정된 예시에서는 해당 스위트가 완료되기 전에 승인이 도착했습니다.

새로운 방식은 추론 (reasoning)과 대기 (waiting)를 분리합니다. 에이전트는 체크 런 (check runs)을 한 번 가져오고, 보류 중인 체크 (pending checks) 상태를 정직하게 기록합니다. CI 활동 후에 트리거되는 결정론적 파이널라이저 (deterministic finalizer)는 제한된 증거 영역 (bounded evidence region)을 업데이트하며, 현재 상태를 재확인한 후에만 커밋에 고정된 (commit-pinned) 승인을 게시할 수 있습니다.

이러한 분리가 중요한 이유는 "대기"가 지능의 문제가 아니기 때문입니다. 모델 턴 (model turn)은 형편없는 스케줄러이며, 오래된 대화는 현재 CI 상태에 대한 신뢰할 수 있는 정보원 (source of truth)이 될 수 없습니다.

2-레인 아키텍처 (The two-lane architecture)

핸드오프 (handoff)에는 "PR을 완료하라"는 식의 모호한 명령이 아닌, 저장소 (repository), PR, 리뷰된 SHA, 필수 체크 항목, 잠정적 판결, 증거 기록과 같은 제한된 식별자 (bounded identifiers)가 포함되어야 합니다.

6단계 파이널라이제이션 워크플로우 (A six-stage finalization workflow)

1. 리뷰 리비전 동결 (Freeze the review revision)

분석 전에 PR 헤드 SHA를 기록합니다. 모든 증거와 제안된 승인을 해당 SHA에 결합합니다. 만약 헤드가 이동하면, 이전의 의도를 오래된 것 (stale)으로 표시합니다.

2. CI 1회 호출 (Fetch CI once)

관련 워크플로우 런 (workflow runs) 및 체크 스위트 (check suites)를 한 번만 읽습니다. success, failure, cancelled, skipped, pending 상태를 구분합니다. 필수 항목 중 하나라도 보류 중 (pending)이라면, 대기를 중단하고 작업을 연기합니다.

3. 좁은 범위의 핸드오프 방출 (Emit a narrow handoff)

인증되고 멱등성(idempotent)이 보장된 기록을 저장하며, 그 의미는 오직 다음과 같습니다: “지정된 증거(evidence)가 녹색(green, 통과)으로 종료되면, 이 리뷰된 SHA는 승인될 수 있음.” 임의의 댓글이 권한을 생성하도록 두지 마십시오. Qwen은 오직 봇이 작성한 마커(marker)만을 수락합니다.

4. workflow_run으로부터 깨어나기 (Wake from workflow_run)

완료된 workflow_run 액티비티를 사용합니다. GitHub는 기본 브랜치(default branch)에 최종화 워크플로(finalizer workflow) 파일이 있을 것을 요구합니다. 완료된 체크가 경합(race)하거나 리뷰를 중복하지 않도록 PR 또는 SHA 단위로 직렬화(serialize)하십시오.

5. 모든 최종 불변량(terminal invariant) 재확인

쓰기 작업을 수행하기 전에, 현재 PR을 가져와 다음 사항을 검증합니다:

• PR이 열려 있으며 초안(draft) 상태가 아닌지
• head SHA가 여전히 리뷰된 SHA와 일치하는지
• 핸드오프(handoff)가 예상된 식별자(identity)로부터 왔는지
• 해당 SHA에 필요한 모든 체크가 존재하고 완료(settled)되었는지
• 필수 결과 중 실패(failed), 취소(cancelled) 또는 누락(missing)된 것이 없는지
• 이 SHA에 대한 승인이 이미 존재하지 않는지
• 저장소별 가드레일(guardrails)이 여전히 승인을 허용하는지

승인이 리뷰된 커밋에 결합될 수 있도록 GitHub의 리뷰 API commit_id 필드를 사용하십시오. “abc123에 대해 승인됨”이라고 말하는 댓글은 실제로 해당 SHA를 전달하는 API 쓰기보다 약합니다.

6. 하나의 최종 상태 결정

하나의 결과값을 작성합니다: approved, failed, stale, guarded, 또는 still_pending. 주변의 증거를 보존하고 반복되는 이벤트가 수렴(converge)되도록 합니다.

복사 가능한 최종화 계약 (Copyable finalizer contract)

agent_ci_handoff:
  repository: "owner/repo"
  pull_request: 123
...

이것은 아키텍처 계약(architecture contract)이며, Qwen Code 설정이 아닙니다.

8가지 수락 테스트 (Eight acceptance tests)

흔한 실수

모델 턴(model turn) 내부에서의 폴링 (Polling). 리뷰를 개선하지 못한 채 시간만 소모하며, 예산 경계(budget-boundary) 경합을 유발합니다.

권한이 있는 최종화 작업(privileged finalizer)에서 신뢰할 수 없는 코드 실행. GitHub는 최소 권한(least privilege) 원칙과 신뢰할 수 없는 체크아웃(checkout)에 대한 주의 깊은 처리를 권장합니다. 최종화 작업은 일반적으로 PR 브랜치 실행이 아니라, API 읽기와 하나의 좁은 범위의 쓰기 권한만 필요합니다.

모든 체크를 필수 증거로 취급하기. 신뢰할 수 있는 세트(trusted set)를 정의하십시오. 봇 배관(bot plumbing), 대체된 스위트(superseded suites), 그리고 최종화 작업(finalizer) 자체가 게이트(gate)를 오염시킬 수 있습니다.

FAQ

Qwen Code 0.21.1이 내 저장소에 이 최종화 작업(finalizer)을 자동으로 추가하나요?

아니요. 이번 릴리스는 Qwen Code 자체의 분류(triage) 워크플로우에 해당 동작을 포함하고 있습니다. 선택한 Qwen 워크플로우가 명시적으로 동등한 자동화 기능을 설치하지 않는 한, 이를 검증된 참조 구현(reference implementation) 및 디자인 패턴으로 취급하십시오.

Sources

• Qwen Code v0.21.1 release
• Qwen Code PR: stop in-agent CI polling
• GitHub Actions: workflow_run event
• GitHub Actions secure use reference
• GitHub Actions concurrency
• GitHub REST API: pull-request reviews