openclaw-pr-maintainer

OpenClaw PR 유지보수 도우미

• 요청된 이슈/PR 작업만 수행합니다. 루트 AGENTS.md: 수리, 제품, 소스 신뢰, 승인 정책. 이 스킬: GitHub 워크플로우 및 유지보수 권한.
• 붙여넣은 참조는 게시 허가 또는 범위 확장을 의미하지 않습니다.

유지보수 권한

• 빨간색 main은 긴급 상황이지, 관련 없는 병합을 위한 전제 조건이 아닙니다. 입증된 빨간 main 수정 사항을 수리 범위 내에서 main에 직접 푸시합니다. 관련 없거나 기존 CI에도 불구하고 범위가 지정된 유지보수 명령을 병합하려면 상속된 실패 예외를 선택하고, 특별한 문구, 갱신된 승인, 또는 관련 없는 메인 CI의 수리/재실행을 요구하지 마십시오. 사람의 승인, 실패 증거, 보호된 작성자의 실행 능력은 별도의 검사입니다.
• 수리 및 병합 권한에는 내부 일정, 데이터베이스 수락, 수명 주기 설계, 위험, 검증이 포함됩니다. 작업 내 버그 수정(호환 가능한 SDK 수정 포함) 및 유효하지 않거나 도달할 수 없는 데이터만 제거하는 백업된 수리는 새로운 승인이 필요하지 않습니다.
• 50개 항목 이상의 대량 닫기/다시 열기에는 명시적인 개수와 범위가 필요합니다.
• 자문 워크플로우에는 명시적인 보안 요청이 필요합니다.
• Peter가 지시한 팀 업데이트는 릴리스 배포자를 사용합니다. 소유자 외에는 라이브 상태를 직접 편집하지 마십시오. 모든 배포/재시작에 대해 Night Watch에 알리십시오. Night Watch는 재시작 시기를 조정할 뿐, 업데이트를 승인하지 않습니다.

범위 선택

• 리뷰/분류/목록: 읽기 전용; 변경 사항/결과/증거/불확실성을 설명합니다. 편집, 할당, 레이블, 댓글, 닫기에는 권한이 필요합니다.
• 수정만: 로컬로 조사/수리/검증; 게시에는 선적/병합 또는 이에 준하는 범위 지정이 필요합니다.
• 병합/선적/자율 수리: 소스 증거 → 리뷰 → 네이티브 제출 → 확인된 병합. 보류 중인 요청을 추적합니다. PR로 인한 CI/충돌은 동일한 권한으로 수리하고, 상속된 CI는 위 예외를 통해 라우팅합니다. 자동 병합 수락 ≠ 완료. 크레딧/관련 없는 작업을 보존합니다. 루트 게이트는 유지되며, 일상적인 권한을 반복하지 않습니다.
• 대기열/탐색: 분류를 읽습니다. 라이브 읽기/공유 탐색은 일괄 처리합니다. 명명된 PR ≠ 대기열 정리.
• 작성자/회귀 기여도: 작성자 및 출처 조사 계정 연령/이력 조건부.
• 주도적으로 실무에 참여합니다. 유용한 작업자 수를 제한하고, 체크아웃/참조 및 GitHub 쓰기를 직렬화합니다. 내부 하위 작업을 숨기는 사용자 소유 앱 작업은 허용되지 않습니다. 인계/재할당 전에 중단된 작업자의 패치/클레임/증거를 보존합니다.

실제 항목 검사

• git status -sb로 시작합니다. 관련 없는 작업을 보존합니다. 로컬 gitcrawl → PATH ghx, 좁은 라이브 JSON 사용. 오래되었거나 누락된 아카이브 → ghx, 광범위한 동기화 금지. PR 소스: ghx pr view/diff + 체크아웃, 웹 검색 금지.

ghx pr view <pr> --repo openclaw/openclaw \
  --json number,title,state,body,author,assignees,baseRefName,headRefName,headRefOid,files,comments,reviews
ghx issue view <issue> --repo openclaw/openclaw \
  --json number,title,state,body,author,assignees,comments

• 할당: 분류, 심층 작업 전. 다른 담당자를 언급합니다. 소유권을 보존합니다. 계정/활동 조사는 조건부.

결과 확립

• 소유자, 진입점, 호출자, 형제, 테스트, 문서, 기록, 현재 main을 읽고 결정적인 의존성 계약을 검사합니다. Codex: 루트의 개인 소스 검사. 반대 증거 → 방어 전에 조사합니다. 발명된 행렬/대안 금지.
• 이미 수정됨: 현재 main 수리를 증명합니다. 표준 커밋/PR + 일치하는 소스/실행 가능한 증거. 종결 권한 → 증거 댓글 + 종료; 그렇지 않으면 보고.
• 실제 결함: 재현 → 불변성을 소유하는 수리 → 경로/형제 증명. 증상 가드보다 단순화. 크기/LOC ≠ 정확성 게이트.
• 유용한 PR: 편집 가능한 브랜치 개선. 안전하지 않음 → 종료 전에 승인된 크레딧 교체. 교체된 계보 → 유지보수 소유의 교체, 기여자 PR을 squash하지 않음.
• 불확실/제품 결정: 차이점 명시. 투기적 병합/자동 범위 외 종료 금지.
• 증거 + 소스 신뢰/호스트 경로: $openclaw-testing, 병합. 집중된 증거 → 준비된 PR. PR CI = 광범위한 증거. 자격을 갖춘 사용 가능한 호스트에서 제한된 로컬 증거를 선호합니다. 신중한 원격 증거는 비용이 많이 드는 검사 또는 환경 차이를 다룰 수 있습니다. 대기열 → 작업 소유 할당을 중단하고, PR CI 또는 안전한 로컬 범위를 사용하며, 충족되지 않은 요구 사항을 보존합니다. 신뢰할 수 없는 소스를 로컬에서 실행하지 마십시오. 선택적 라이브 차이 → 의미 있는 경계 증거 + 제한 사항. 명시적 라이브, 외부 API, 인증된 위험 증거는 필수입니다. 목/생략/오래된 헤드 ≠ 라이브.
• 동작 변경: 경계 증거 계약 + $test-audit. 요청된 동작과 리포지토리 표준은 별도로 확인합니다.

CODEOWNERS 리뷰

• CODEOWNERS는 리뷰를 라우팅합니다. 라이브 적용을 검사합니다. 제한된/보안 경로 + 실질적인 제품/동작/보안/소유권 변경에는 등록된 소유자의 참여가 필요합니다.
• 소유권/리뷰 거버넌스: 확인된 활성 조직 관리자의 지시도 자격이 있습니다. 리포지토리 관리자/우회만으로는 충분하지 않습니다. 두 경로 모두 강제 리뷰를 면제하지 않습니다.

리뷰 및 게시

• 사소하지 않은 코드를 커밋하거나 병합하기 전: 허용된 워크플로우를 통해 신선한 리뷰를 수행합니다. 사용자가 거부하지 않는 한 실행 가능한 결과를 해결합니다. 실행 가능 = 가능성이 높거나 영향이 큼. 가능성이 낮고 복구 가능한 에지 케이스(수정이 불균형적으로 복잡성을 추가)는 한 줄의 이유와 함께 거부합니다.

• 사소하지 않은 코드 커밋/병합: 선택된 로컬 리뷰 경로를 사용하고 확인된 실행 가능한 결과를 해결합니다. 필요한 신선한 독립적 리뷰는 여전히 적용됩니다. 리뷰 전용: 요청된 경우에만 독립적 패스, 추가 필수 CLI 패스 없음.

• 실질적인 변경 사항/해결되지 않은 우려 사항에 대해 리뷰를 다시 엽니다. 패치와 동일한 리베이스/기계적 헤드 변경은 예외입니다. 실제 사람/봇 결과를 처리합니다. 거부를 설명합니다. 봇 점수/순위 목록은 별도의 의무를 생성하지 않습니다. ClawSweeper 자문. 병합을 위해 댓글을 기다리지 마십시오.

• 현재 PR 템플릿: 일반적인 문제/영향. 인벤토리는 diff/세부 정보에 포함합니다. 위험, 마이그레이션, 조치, 증거, 격차, 크레딧을 최신 상태로 유지합니다. 중요한 트레이드오프를 설명합니다. 발명된 내부 전용 사용자 혜택 또는 보편적인 LOC/출처/대체 수정 에세이는 금지입니다.

• CHANGELOG.md는 릴리스 소유. 릴리스 노트 컨텍스트는 PR/커밋에 포함. 에이전트 기록은 명시적 요청 시에만 제공합니다.

• 공개 변형: 작성자/커미터 + 작성자를 확인합니다. 실제 --body-file <path> 페이로드와 함께 ghx를 사용하고, stdin은 사용하지 마십시오(--body-file -, --input -, /dev/stdin). 프록시는 stdin을 전달하지 않습니다. ghx --no-cache로 변경된 본문을 다시 읽고 정확한 비어 있지 않은 바이트를 확인합니다. 승인된 범위만. 기존 댓글/본문을 업데이트하고 복제하지 않습니다.

• 게시/병합: 병합을 읽습니다(미디어, 정확한 헤드 CI, 네이티브 워크플로우).

• 원격 병합/종료 + 소스를 확인합니다. 문제, 소유 변경 사항, 증거/격차, 크레딧, 연결된 최종 상태를 산문으로 보고합니다. 가치 있는 후속 조치만 수행합니다.

최종 확정 및 정리

• 라이브 세션 cwd를 보유한 작업 트리(본인 및 하위 디렉토리 포함)를 절대 제거하지 마십시오. 자식 cd/cwd 재정의는 부모를 이동시키지 않습니다. 소유자가 종료/cwd를 해제할 때까지 유지하고 경로를 보고합니다.
• 확인된 결과 → 기본 정리를 통해 작업 로그, 영수증, 증명 아카이브, .crabbox, 스크래치, 완료된 작업 트리를 제거합니다. 제거만을 위한 보존/아카이브/내보내기/인계는 금지입니다.
• 생성된 작업 트리는 작업/PR이 병합되면 제거합니다. 즉시 필요하지 않은 경우. 라이브 cwd 작업 트리는 절대 제거하지 마십시오.
• 모든 작업: 결과는 채팅/stdout에 표시. 파일은 전달물/도구/증명/복구 필요 시에만 사용하며, 목적/재사용을 명시합니다. 병합 전 증명은 필수입니다. 선택적 후속 조치는 완료를 지연시키지 않습니다.
• 요청된 전달물/보존, 완료되지 않은 소스 + 필요한 복구 상태, 활성/라이브/알 수 없는 소유자, 자격 증명, 에이전트 상태, 공유 종속성을 보존합니다.