Skip to content

feat(jev): Jev(TypeSafe System One) 사용법 스킬 플러그인 - #16

Merged
dorage merged 4 commits into
mainfrom
feat/jev-plugin
Oct 5, 2026
Merged

dorage merged 4 commits into
mainfrom
feat/jev-plugin

Conversation

@dorage

@dorage dorage commented Oct 1, 2026 •

Copy link
Copy Markdown
Owner

요청 원문

다음 Jev라는 도구의 Cookbooks와 References를 참조해서, Jev의 사용을 검토, 사용법 스킬을 포함하는 플러그인을 만들어줘.

플러그인이 하는 일

  • Jev를 사용하거나, Jev 사용요청을 했을때만 사용한다.
  • 현 상황에 적절한 question type을 판단하는 방법
  • Jev를 잘 사용하는 방법
  • typescript 환경에서 사용법
  • python 환경에서 사용법
  • 그 외 jev 사용에 도움이 되는 내용들을 파악하고 정리

세션 ID: 814797eb-9dfc-4188-9d5e-97ecceb26950

무엇을 만들었나

claude-plugins/jev 플러그인 하나, 스킬 jev 하나. 진입점 SKILL.md 가 판단 기준을 쥐고, 세부는 references/ 7개 파일로 나눴어요.

  • SKILL.md — 트리거 조건(Jev/TypeSafe 언급, 기존 Jev 코드 수정, LLM JSON 파싱 대체), 작업 순서, 질문 타입 결정 기준, 요청·응답 모양, confidence 분기, 피할 것, 레퍼런스 색인
  • question-types.md — Choice/Score/Noul 필드, 고르는 기준, Noul 대 Score 실측, 구조화된 instructions/criteria
  • writing-questions.md — 질문 쪼개기, state 구성, 작성 규칙, jev-1.13 약점 9가지와 대안
  • patterns.md — confidence 와 임곗값, fan-out / confidence routing / composite scoring / intent routing
  • cookbooks.md — 쿡북 18편 요약 (실제 질문 문구, state 구성, 임곗값, 비용, 교훈)
  • python.md, typescript.md — SDK 치트시트(시그니처·기본값·예외·재시도)와 완전한 예제
  • http-api.md — 엔드포인트, 와이어 포맷, 오류, 가격·레이트 리밋·컨텍스트 한도, 별칭

근거

  • https://docs.typesafe.ai/llms.txt 색인의 111쪽 전체를 2026-10-01 에 내려받아 요약했어요. 개념·질문 타입·패턴·API 는 직접 읽고, 쿡북 18편과 SDK 레퍼런스는 서브에이전트가 요약한 뒤 핵심 수치(RetryPolicy 기본값, 클라이언트 시그니처, 질문 빌더 시그니처)를 원문과 대조했어요
  • 공식 스킬 https://github.com/typesafe-ai/skills 는 "라이브 문서를 읽어라"는 10KB 안내라서, 오프라인에서도 같은 판단이 가능하도록 내용을 담는 쪽을 택했어요

확인해 주실 것

  • 쿡북 요약(cookbooks.md, 88KB)이 너무 무거우면 쿡북별로 파일을 나누거나 교훈만 남기는 방식으로 줄일 수 있어요
  • 마크다운 규칙(표·숫자목록 금지)은 전 파일에서 지켰어요. 코드 블록 안의 JSON/코드는 원문 그대로예요
  • OpenRouter 스킬의 응답 예시 3개는 마스터가 typesafe/jev-1.13-20260917 로 실제 호출한 결과예요 (noul 0.04, choice billing 1.0 / confidence 0.99, score 2.97)

🤖 Generated with Claude Code

dorage and others added 2 commits October 1, 2026 13:21
- 질문 타입(Choice/Score/Noul) 선택 기준, 질문 작성법, jev-1.13 약점과 대안
- confidence 임곗값과 4개 패턴(fan-out, confidence routing, composite scoring, intent routing)
- 쿡북 18편 요약(질문 문구·state·임곗값·비용·교훈)
- Python(typesafe-sdk)·TypeScript(@typesafe-ai/sdk) 치트시트와 HTTP API 원형
- 마켓플레이스에 jev 등록

문서 기준: https://docs.typesafe.ai/llms.txt (2026-10-01)

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
dorage and others added 2 commits October 1, 2026 13:49
- 모델 ID typesafe/jev-1.13, 엔드포인트 /api/v1/systemone 과 /api/alpha/decisions
- 응답에 붙는 id·provider·usage.cost, 오류 코드(402 포함), 32k 컨텍스트, 가격
- JSON 예시 3개: noul 에이전트 가드레일, choice 지원 라우팅, score 리드 자격
- curl, TypeScript(fetch·SDK), Python(SDK) 호출 코드
- OpenRouter 쿡북(툴콜 게이트, 권한 프롬프트 자동 승인)의 가드레일 설계 규칙
- README·plugin.json(0.2.0)·marketplace 설명 갱신, jev 스킬에 교차 참조

출처: openrouter.ai/docs/guides/community/jev, typesafe-sdk, systemone API (2026-10-01)

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
마스터가 typesafe/jev-1.13-20260917 로 실제 호출한 응답 3개(noul 0.04,
choice billing 1.0, score 2.97)와 토큰·비용 수치를 그대로 반영.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@dorage

dorage commented Oct 1, 2026

Copy link
Copy Markdown
Owner Author

참고: 이 PR 본문을 갱신하다 gh pr edit 가 gh 2.46 의 Projects(classic) 폐기 오류로 실패하는 문제를 발견했어요. #18 에 정리했고, 여기서는 gh api -X PATCH repos/dorage/dotfiles/pulls/16 으로 우회했어요.

@dorage
dorage marked this pull request as ready for review October 5, 2026 22:03
@dorage
dorage merged commit 1d7be1e into main Oct 5, 2026
1 check passed
@dorage
dorage deleted the feat/jev-plugin branch October 5, 2026 22:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant