REA 체인지로그 업데이트
릴리스 노트 준비 및 기여자 귀속에 사용합니다. 게시 권한과 기존 체크포인트 검증을 위해 저장소 루트의 docs/releasing.md를 읽으십시오. 이 스킬은 노트를 준비할 뿐, 병합, 태깅 또는 게시를 승인하지 않습니다.
산문 작성 전 사전 작업
전체 기록과 태그를 가져옵니다. 릴리스 PR의 기준 브랜치에 있는 .release-please-manifest.json에서 게시된 기준 태그를 선택하고, 해당 브랜치의 정확한 SHA를 편집 대상으로 고정합니다. REA 태그는 rea-agents-VERSION 형식입니다. 제안된 버전(사전 릴리스 접미사 포함)을 사용하고, OpenClaw의 달력 버전을 모방하기 위해 always-bump-minor 전략을 변경하지 마십시오.
node scripts/release-notes.mjs inventory \
--repository morluto/rea --base rea-agents-PREVIOUS \
--target FULL_BASE_BRANCH_SHA --version VERSION \
--manifest /tmp/rea-VERSION.contributions.json
node scripts/release-notes.mjs record \
--manifest /tmp/rea-VERSION.contributions.json \
--summary \
--output /tmp/rea-VERSION.record.md
기존 봇 초안뿐만 아니라 인벤토리를 읽으십시오. 인벤토리에는 사이드 브랜치 커밋, 범위 내 병합 커밋이 있는 GitHub 관련 PR, 커밋 작성자/공동 작성자, 확인된 종료 이슈 및 해당 리포터가 포함됩니다. GitHub 연결은 페이지네이션됩니다. 네트워크 오류가 발생하면 생성을 중단하고, 복구 후 새 출력 파일로 다시 실행하십시오. 기존 출력 파일은 덮어쓰지 않습니다.
확인되지 않은 커밋 신원은 user: null과 함께 이름/이메일로 유지됩니다. 핸들을 추측하거나 병합자를 대신하여 감사해서는 안 됩니다. 보고서는 미확인 정보를 보존합니다. 이는 검토된 메타데이터 스냅샷이며, 사람이 패치를 작성했다는 독립적인 증거가 아닙니다. 속성이 확인되지 않은 신원, 특이한 병합 전략, 백포트, 되돌리기 또는 GitHub이 연결하지 않은 참조의 경우 소스 PR과 diff를 검사하고 제한 사항을 보고하십시오. 현재 수집기는 이슈 리포터 크레딧을 위해 확인된 PR 종료 관계를 사용합니다. 관련 없는 이슈 언급은 자동으로 크레딧이 부여되지 않습니다. 되돌리기 후에도 단순히 인벤토리에 포함된 작업이 여전히 출시된다고 주장하지 마십시오.
사용자를 위해 작성하고 크레딧 유지
CHANGELOG.md에서 가장 최근의 ## [VERSION] 섹션만 다시 작성하고, 버전/날짜/링크 제목을 유지하십시오. 다음 아래에 한 줄 마크다운 목록 항목을 사용하십시오:
### 하이라이트: 몇 가지 릴리스를 정의하는 사용자 결과; 소규모 릴리스에는 할당량이 없습니다.### 변경 사항: 기능 및 의미 있는 동작 변경.### 수정 사항: 안정성, 정확성, 호환성 및 안전성 수정.### ⚠ 주요 변경 사항: 해당하는 경우 유지하고, 기존 체크포인트 검증기가 요구하는 마이그레이션 및 원본 PR/커밋 참조를 포함합니다.
관련 작업을 분석가 워크플로 또는 사용자 영향별로 그룹화하십시오. 짧고 구체적인 항목으로 결과 동작을 설명하십시오. 하이라이트는 릴리스를 요약합니다. 변경 사항에서 전체 설명을 반복하지 마십시오. 내부 정리, 테스트, CI 및 일상적인 문서는 일반적으로 출처 파일에만 속합니다. 주장하기 전에 모호한 PR/diff를 읽으십시오. 시뮬레이션된 공급자 확인과 실제 공급자 확인을 구분하십시오.
공개 노트에서 각 대표 기여를 한 번씩 링크와 함께 인정하고, 검증된 인간 작성자, 알려진 공동 작성자 및 확인된 종료 이슈 리포터에 대해 Thanks @...를 추가하십시오. 그룹화는 모든 크레딧을 한 줄에 보존합니다. 하이라이트, 세부 항목 또는 마이그레이션이 동일한 작업을 참조하는 경우, 해당 항목 중 하나에만 감사를 넣고 모든 항목에 넣지 마십시오. 이슈 링크를 포함하십시오. 직접 커밋 항목은 커밋 링크와 알려진 인간 크레딧을 전달합니다. GitHub 봇 및 알려진 에이전트 계정은 제외하십시오. REA에서 관찰된 Anthropic, Cursor 및 Codex 공동 작성자 트레일러는 @claude, @cursoragent 및 @codex로 확인되며 GitHub 유형은 User입니다. 크레딧 정책은 메타데이터를 유지하면서 이들을 제외합니다. REA 유지 관리자의 요청에 따라 @morluto 자체 감사는 생략하되 인벤토리에서 저자 정보는 유지합니다. 다른 인간 기여자는 계속 자격이 있습니다. 모호한 #NNN 번호를 피하기 위해 교차 저장소 참조에는 명시적 GitHub 링크를 사용하십시오. 알 수 없는 핸들은 알 수 없는 상태로 유지됩니다. 가짜 크레딧을 만들지 마십시오.
생성된 record --summary 출처 링크를 이 릴리스의 끝에 그대로 추가하십시오. 링크된 인벤토리는 검색된 범위 내 모든 PR 및 직접 기여(산문에서 생략된 내부 작업 포함)를 설명합니다. 공개 노트에 전체 record 출력을 붙여넣지 마십시오. 감사가 중복되고 사용자용 변경 사항이 모호해집니다. 전체 기록은 검토를 위해 계속 사용할 수 있습니다. 검증을 통과시키기 위해 생성된 크레딧을 수동으로 편집하지 마십시오. 제품 기록이 변경되면 인벤토리를 새로 고치십시오. 산문만 수정하는 경우 스냅샷을 재사용할 수 있습니다.
Release Please로 마무리
라이브 릴리스 PR을 변경하기 전에 해당 PR 업데이트에 대한 권한이 있어야 합니다. 로컬 준비 및 검증은 독립적으로 진행할 수 있습니다.
-
선택된 오픈 릴리스 PR에 브랜치/본문을 편집하기 전에
rea:release-notes-finalized를 추가하십시오. 메인 제안 푸시는 이 레이블을 존중합니다. 이것은 Release Please의autorelease: snooze메커니즘이 아닌 워크플로 가드입니다. 이미 실행 중인 제안이 완료되어야 편집할 수 있습니다. 확정된 노트 위에 수동 준비를 전달하지 마십시오. -
해당 릴리스 브랜치에서 검토된 인벤토리를
docs/releases/VERSION.contributions.json으로 저장하십시오. 이는 임시 계획 파일이 아닌 지속적인 공개 릴리스 출처입니다. 자격 증명이나 로컬 환경 덤프를 추가하지 마십시오. 기존 버전 아티팩트를 정렬된 상태로 유지하십시오. -
기존 체크포인트 검증기와 새 검사기를 실행하십시오:
node scripts/release-notes.mjs check \ --manifest docs/releases/VERSION.contributions.json node scripts/release-notes.mjs render \ --manifest docs/releases/VERSION.contributions.json \ --output /tmp/rea-VERSION.notes.md검사기는 GitHub의 65,536자 제한까지 인라인 PR 본문(주변 메타데이터 포함)을 지원합니다. 더 큰 노트의 경우 크레딧을 자르지 않고 실패합니다. Release Please의 오버플로 링크 본문은 통합되지 않습니다.
-
Release Please 헤더/푸터 및 컴포넌트/버전 구조를 유지하면서 렌더링된 섹션으로 릴리스 PR 본문을 업데이트하십시오.
gh pr edit --body-file에 본문 파일을 사용하십시오.CHANGELOG.md만 변경하면 Release Please의 릴리스 본문이 변경되지 않습니다. 승인된 변경 사항만 푸시하십시오. -
PR 본문을 새로 가져와 파일로 저장하고
check --pr-body FILE을 실행하십시오. 전체 diff를 검토하고 현재 CI가 완료될 때까지 기다리십시오. 게시는 릴리스 생성 전에 본문을 다시 확인합니다. 게시 중에는 추가 본문 편집을 피하십시오.
확정 레이블은 봇 새로 고침을 중단하지만 메인은 중단하지 않습니다. 인벤토리 대상 이후의 새로운 제품 변경 사항은 게시 전에 노트를 새로 고쳐야 합니다. 워크플로는 대상 조상을 확인하고 해당 대상 이후에는 릴리스 메타데이터 경로만 허용합니다. 또한 인벤토리 대상이 검토된 병합의 첫 번째 부모와 같아야 하므로 메인 커밋이 개입된 경우 새 인벤토리가 필요합니다. 허용된 릴리스 메타데이터 경로 내의 diff도 검토하십시오. 경로 가드는 패키지 종속성/스크립트 편집이 버전 전용 변경 사항임을 증명하지 않습니다. 자동 제안을 재개하려면 확정 레이블을 제거하고 봇이 다시 생성하도록 하십시오. 편집 내용이 대체될 것으로 예상하십시오.
기여 인벤토리가 없는 기존 릴리스는 현재 게시 경로를 유지합니다. 릴리스 산문을 수정하기 위해 패키지를 다시 태깅하거나 재게시하지 마십시오.