Skills

给编码 Agent 的 Jev Skill

一个 SKILL.md,你的编码 Agent 在写调用 Jev 的代码时会加载它。它保证请求格式、三种问题类型和置信度处理写对,也会告诉 Agent 什么时候 Jev 不是合适的工具。

Skill 讲了什么

  • 请求:POST https://api.typesafe.ai/v1/systemone,字段 model、state 和 questions 映射。
  • Choice、Score、Noul 各返回什么、问题怎么写。
  • 把同一个 state 的多个问题合并成一次请求。
  • 置信度门禁、阈值常量集中放一个文件、固定模型版本。
  • 什么时候直接调用 Jev MCP 服务 的工具,而不是写代码。
  • 什么时候不该用 Jev:写文字、生成代码、开放式回答。

阅读完整的 SKILL.md。纯 Markdown,约 170 行,英文写成(Agent 读英文最稳)。

安装

Claude Code(所有项目)
mkdir -p ~/.claude/skills/jev-decisions
curl -fsSL https://jevhub.org/skills/jev-decisions/SKILL.md \
  -o ~/.claude/skills/jev-decisions/SKILL.md

只给一个项目用,就放到仓库里的 .claude/skills/jev-decisions/。

Codex
mkdir -p ~/.codex/skills/jev-decisions
curl -fsSL https://jevhub.org/skills/jev-decisions/SKILL.md \
  -o ~/.codex/skills/jev-decisions/SKILL.md

其他 Agent:把文件放进它的 skills 或 rules 目录,或把内容粘进项目指令。

它能避免的错误

这些错误在公开的 Jev 代码和转抄的片段里都出现过。每一个都会让 API 拒绝请求,或者悄悄回答了另一个问题。

错误写法正确写法
"model": "systemone""model": "jev-latest",或固定 jev-1.13.0
"questions": [ ... ](数组)"questions": { "your_id": { ... } }(映射)
instruction、options、labelsinstructions 和 criteria
mode 字段没有这个字段。问题的 type 是 choice、score 或 noul
jev-1.13 或 typesafe/jev-1.13jev-1.13.0
读 Noul 的 confidenceNoul 只返回 noul,即“是”的概率
把 Score 四舍五入到某一级保留小数;落在两级之间的 1.4 本身就是信息

TypeSafe 官方 Skill

TypeSafe 也发布了官方 Skill,包含完整 API 参考和 cookbook,篇幅更长。本站这个更短,并补充了 MCP 工具和上面这些常见错误。两个一起装也没问题。

在 Claude Code 安装官方 Skill
claude plugin marketplace add typesafe-ai/skills
claude plugin install typesafe@typesafe-ai