Recipes

Verdict 0.5.0 릴리스: MCP 읽기 전용 강화, skill install --detect, 스키마 경로 이동

README 링크에서 발견 · today

Software & DevOps

Verdict 리뷰 CLI를 위한 Changesets 릴리스 PR, MCP 및 스키마 관련 breaking 변경 포함

What they did

작성자가 @stainless-code/verdict에 대해 Changesets가 생성한 릴리스 PR을 병합하여 0.5.0으로 버전을 올리고, changesets/action GitHub Action을 통해 npm에 자동으로 게시했습니다. 이번 릴리스에는 세 가지 마이너 변경과 여러 패치가 포함되었습니다. 마이너 변경: `verdict mcp --read-only` 아래의 실험적 MCP 서버가 더 이상 `threads` 도구를 노출하지 않으며, `report`는 `--output`/`--sarif` 인자를 제거하고 아무것도 쓰지 않는다고 주장하는 대신 `readOnlyHint: false`를 보고하여 일곱 개의 도구(report, next, show, trend, ready, doctor, check-tree)가 남습니다. 게시된 스키마는 스킬과 함께 이동하여 모든 `$id` 기본 경로가 이제 `skills/verdict/schemas/`입니다. 그리고 `verdict skill install --detect`는 이제 머신에 이미 설정된 모든 코딩 에이전트에 리뷰 스킬을 추가하며, 각 대상과 결과를 명시하고, `--json`은 상태, 경로, 작성된 파일을 나열하며, 설정된 에이전트가 없으면 거부하고, `--dir` 및 `--agent`와 상호 배타적입니다. 패치: 문서 사이트는 가이드를 `verdict`라는 두 번째 스킬 대신 `verdict-docs`로 게시하며, 두 개의 게시된 스킬이 `name:`을 공유하면 문서 빌드가 실패합니다. 전역 플래그는 명령줄 어디에서나 작동하고 단독 `--`는 위치 인자 파싱을 종료합니다. 서명된 설치는 `cosign`이 PATH에 있을 때 더 이상 중단되지 않는데, 이제 검증이 Release 워크플로가 실제로 발급하는 인증서 아이덴티티(태그가 아닌 main으로의 푸시)를 확인하기 때문입니다. 배포되는 리뷰 프롬프트에 있던 잘못된 펜스 블록이 이제 올바른 형식입니다. `npx skills add stainless-code/verdict`는 천 개가 넘는 파일을 복사하는 대신 스킬만 설치합니다. 스킬은 풀 리퀘스트, 브랜치, 커밋 범위, 스테이징된 변경에서 트리거되며, 업스트림 MIT 고지는 커밋에 고정됩니다. TypeScript 클라이언트는 `anyOf`를 `unknown` 대신 유니온으로 렌더링합니다. `verdict upgrade`는 실행 중인 바이너리 옆의 설치 프로그램 영수증을 읽지만, 디렉터리를 소유한 npm, Homebrew, node_modules 또는 스킬 복사본에 양보합니다. 그리고 셸 완성은 `--provider` 및 `--json`과 함께 `threads`를 제공합니다.

How it went

릴리스 PR이 자동으로 열렸고 병합할 준비가 되었으며, 병합 후 npm이 패키지를 게시합니다. 변경 로그는 상세하고 범위가 잘 정리되어 있으며, 호환성 깨지는 변경 사항이 명시적으로 강조되고, 기존의 읽기 전용 `report` 힌트를 고정하거나 URL로 스키마를 해석하는 호스트를 위한 마이그레이션 노트도 포함되어 있습니다. 완성도가 높습니다. 각 패치가 구체적인 버그와 수정 사항을 명시하고, 문서 빌드는 이제 중복된 스킬 이름을 방지합니다.

Worth knowing

릴리스 PR이지 기능 빌드가 아니므로, 기반 변경 사항은 이미 main에 반영되었고 Changesets, npm 게시 자격 증명, Release 워크플로가 구성되어 있다고 가정합니다. MCP 및 스키마 변경은 호스트와 검증기 입장에서 breaking 변경이며, 읽기 전용 `report` 힌트 변경은 호스트가 더 이상 해당 힌트를 신뢰해서는 안 된다는 것을 의미합니다. 이 게시물은 CI 결과나 실제 게시 단계를 보여주지 않습니다.

Wiring

Changesets가 흐름을 주도합니다. 기여자가 main에 changeset 파일을 추가하면 changesets/action GitHub Action이 릴리스 PR을 열거나 업데이트하고, 이를 병합하면 npm publish가 트리거됩니다. 스킬 페이로드는 `SKILL.md`와 함께 `skills/verdict/`에 위치하며, `verdict skill install`은 정확히 해당 파일들을 기록합니다. `--detect`는 구성된 코딩 에이전트를 스캔하여 각각에 설치하는 반면, `--dir`과 `--agent`는 명시적인 대안으로 남아 있습니다. 스키마는 `skills/verdict/schemas/`에서 제공되며 `$id` URL로 참조됩니다. 문서 사이트는 `verdict-docs`를 게시하고 `/.well-known/agent-skills/index.json`을 통해 노출하며, 빌드 검사에서 중복된 스킬 이름을 거부합니다. 설치 스크립트와 `verdict upgrade`는 main으로의 푸시에 대해 cosign 인증서 신원을 검증하며, `upgrade`는 npm, Homebrew, node_modules 또는 스킬 복사본에 위임하기 전에 바이너리 옆의 설치 프로그램 영수증을 읽습니다.

Try it yourself

I can't complete this as requested. I don't have access to your repository — no changesets, README, install scripts, docs build config, or skill directories are available to me in this conversation, and I won't invent release notes, file contents, or collision lists.

To get this done, you'd need to either paste the relevant files here or run the checks yourself. Here's what to gather and how to approach each part:

**1. Release notes from changesets**
- Paste the contents of `.changeset/*.md` (or the output of `npx changeset status`).
- I'll group them into Breaking / Minor / Patch and, for each breaking entry, spell out the exact downstream migration step (e.g., "schema `$id` base moved from `X` to `Y` — update imports/refs" or "MCP tool `foo` removed — call `bar` instead").

**2. `verdict skill install --detect` documentation**
- Paste `README.md` (or the relevant section) and `install.sh` / `install.ps1`.
- I'll check whether the flag is documented and whether both installers end a successful run by pointing users at it.

**3. Duplicate `name:` collision check**
- Paste the docs build config/plugin that validates skill frontmatter, plus the `name:` line from each skill's frontmatter (or the skill directory listing with frontmatter).
- I'll confirm the build is wired to fail on duplicates and list any colliding directories.

If you can share those, I'll do the analysis directly.

Source

English

Tools in this stack