메뉴
Pi 버전 업데이트, CHANGELOG 검토, extensions 의존성·호환성 점검과 업데이트 내역 정리에 사용한다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
기존 user/project 메모리의 중복·노후 항목을 검토, 통합, 정리할 때 사용한다. 사용자 확인 없이 메모리를 삭제하지 않는다.
서브에이전트·스킬 사용 통계와 미사용 항목을 분석해 인사이트를 도출할 때 사용한다.
코딩·조사 작업을 별도 Picky Pickle에 위임할 때 사용한다. worktree 준비, 지침 작성, Pickle 생성·후속 관리를 수행한다.
Context7 CLI(`ctx7`)로 라이브러리·프레임워크 공식 문서와 API 예시를 조회할 때 사용한다.
새 기능, 큰 변경, 아키텍처 결정 전에 구현보다 설계를 먼저 확정할 때 사용한다.
장기·병렬·대규모 작업을 서브에이전트로 분해·실행·검증하거나 동적 workflow를 설계할 때 사용한다.
| name | pi-auto-update |
| description | Pi 버전 업데이트, CHANGELOG 검토, extensions 의존성·호환성 점검과 업데이트 내역 정리에 사용한다. |
| disable-model-invocation | false |
$ARGUMENTS가 없으면 현재 레포 기준 pi 업데이트 작업으로 간주한다.
목표는 아래 6단계를 순서대로 수행하는 것이다.
pi -v 로 현재 설치 버전과 설치 가능한 최신 버전 확인extensions/에서 영향받는 코드와 의존성 위치 확인extensions/ 내부의 pi 관련 의존성 업데이트항상 아래 순서로 보고한다.
extensions/ 파일, 패키지, 기능package.json을 어떻게 바꿨는지공식 근거가 있으면 반드시 링크를 포함한다.
반드시 먼저 실행:
pi -v
여기서 현재 설치 버전과 최신 버전을 읽는다.
pi -v 출력이 불명확하면 아래로 보조 확인한다.
npm view @earendil-works/pi-coding-agent version
과거 패키지 네임스페이스
@mariozechner/*는 더 이상 사용하지 않는다. 현재 공식 패키지는 모두@earendil-works/*네임스페이스다.
필요하면 현재 repo에서 사용 중인 pi 관련 버전도 함께 확인한다.
우선 확인 대상:
extensions/package.jsonextensions/**/package.jsonpackage.json의 peerDependenciessettings.json의 lastChangelogVersion우선 이 공식 문서를 확인한다:
https://github.com/earendil-works/pi/blob/main/packages/coding-agent/CHANGELOG.md예전 위치(
badlogic/pi-mono,earendil-works/pi-mono)는 모두earendil-works/pi로 이전되었다.
가능하면 문서 fetch 도구를 사용해 읽고, 실패 시 웹 검색/브라우저/CLI로 본다.
다음을 추린다:
각 항목을 아래 형식으로 정리한다:
- vX.Y.Z — {변경 요약}
- 영향: {우리 repo에서 영향받는 extension/기능}
- 대응 필요: yes/no
extensions/ 영향 범위 스캔extensions/ 아래에서 pi 관련 의존성이 선언된 파일을 모두 찾는다.
찾아야 하는 패턴:
@earendil-works/pi-coding-agent@earendil-works/pi-agent-core@earendil-works/pi-ai@earendil-works/pi-tui과거 네임스페이스
@mariozechner/pi-*가 잔존해 있다면 모두@earendil-works/pi-*로 교체 대상이다.
특히 확인 대상:
extensions/package.jsonextensions/remote/package.jsonextensions/**/package.jsonextensions/ 내부에서 아래를 검색해 영향 가능성이 큰 코드를 모은다.
import type { ExtensionAPIpi.registerCommand(pi.registerTool(pi.on(@earendil-works/pi-coding-agent@earendil-works/pi-tui@earendil-works/pi-ai변경 가능성이 큰 영역:
CHANGELOG의 각 의미 있는 항목에 대해 아래를 만든다.
- 변경점: {공식 changelog 내용}
- 우리 코드 영향: {파일 경로들}
- 조치: {무시 / 버전만 업데이트 / 코드 수정 필요}
extensions/ 폴더 내부의 pi 관련 의존성은 모두 같은 릴리즈 계열로 맞춘다.latest를 쓰는 곳이 있더라도, 가능하면 이번 확인한 최신 버전으로 명시적으로 맞추는 것을 우선 검토한다.package.json의 peerDependencies는 실제 호환성 정책이 바뀌지 않으면 함부로 좁히지 않는다.보통 다음을 점검/수정한다.
extensions/package.json
@earendil-works/pi-agent-core@earendil-works/pi-ai@earendil-works/pi-coding-agent@earendil-works/pi-tuiextensions/remote/package.json
@earendil-works/pi-coding-agentextensions/**/package.json 중 pi 관련 패키지가 있는 모든 파일package.json 의 peerDependencies 에 남아 있는 @earendil-works/pi-* 항목의존성 파일 수정 후 실행:
cd extensions && pnpm install
락파일 변경도 함께 검토한다.
CHANGELOG와 영향 스캔 결과를 근거로 필요한 부분만 최소 수정한다.
예시 대응:
최소 검증:
cd extensions && pnpm run typecheck
가능하면 추가 검증:
cd extensions && pnpm run test
필요 시 전체 패키지 설치/로드 관점 확인:
pnpm install
pi -v
최종 응답 전, 시각화 도구를 사용할 수 있으면 반드시 show_widget으로 업데이트 결과를 보여준다.
첫 show_widget 호출 전에는 내부 준비 단계로 visualize_read_me를 한 번 호출한다.
extensions/ 패키지/기능과 코드 수정 필요 여부package.json / lockfile / pi 관련 패키지 버전extensions/package.json, extensions/pnpm-lock.yaml처럼 명확한 경로로 표시시각화는 보조 산출물이므로, 최종 텍스트 보고도 기존 출력 원칙 순서대로 반드시 제공한다.
작업 종료 전 반드시 확인:
pi -v 결과를 기록했는가extensions/ 내 모든 pi 관련 package.json을 확인했는가extensions 기준 pnpm run typecheck를 실행했는가pnpm run test도 실행했는가extensions/ 영향 스캔 없이 일괄 수정하기Auto-update complete.
## Version
- current: ...
- latest: ...
- update needed: yes/no
## Changelog
- v...
- impact: ...
- action: ...
## Impact scan
- extensions/package.json
- extensions/...
## Dependency updates
- ...
## Code changes
- ...
## Validation
- `cd extensions && pnpm run typecheck` → ...
- `cd extensions && pnpm run test` → ...
## Visualization
- widget: shown/not shown
- summary: version flow, impact categories, changed files, validation state
## Follow-ups
- ...