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 读英文最稳)。
安装
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/。
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、labels | instructions 和 criteria |
mode 字段 | 没有这个字段。问题的 type 是 choice、score 或 noul |
jev-1.13 或 typesafe/jev-1.13 | jev-1.13.0 |
读 Noul 的 confidence | Noul 只返回 noul,即“是”的概率 |
| 把 Score 四舍五入到某一级 | 保留小数;落在两级之间的 1.4 本身就是信息 |
TypeSafe 官方 Skill
TypeSafe 也发布了官方 Skill,包含完整 API 参考和 cookbook,篇幅更长。本站这个更短,并补充了 MCP 工具和上面这些常见错误。两个一起装也没问题。
claude plugin marketplace add typesafe-ai/skills
claude plugin install typesafe@typesafe-ai