AGENT SKILL

jev-fanout

Ask every independent TypeSafe Jev question in one POST /v1/systemone (speculative fan-out). Use for parallel questions, smart-home or compound commands, one-call turn assessment, or when the user runs /jev-fanout. Do not fire one HTTP call per question.

License 许可
MIT
所属仓库
cobusgreyling/Jev
最近更新
2026-10-15
Stars
★ 141
Forks
30

01 前言 Front Matter

name
jev-fanout
description
Ask every independent TypeSafe Jev question in one POST /v1/systemone (speculative fan-out). Use for parallel questions, smart-home or compound commands, one-call turn assessment, or when the user runs /jev-fanout. Do not fire one HTTP call per question.

03 SKILL.md 正文

Jev speculative fan-out

Ask every independent judgment over the same state in one POST /v1/systemone. Questions run in parallel and cannot see each other's answers. Code consumes the ones that apply.

Primitives and auth: skills/jev/SKILL.md. Official pattern: https://docs.typesafe.ai/patterns/fan-out

Do this

  1. List the judgments the workflow might need, including speculative ones (category, compound, room, device, availability, action per device type).
  2. Put each in questions with complete instructions. Write the speculative premise into the question (If this is a light command, …). Question IDs are not sent to the model.
  3. Mix choice, score, and noul in that one request. Pin jev-1.13.0 once thresholds are tuned; jev-latest moves.
  4. In code, branch on the answers that apply; leave the rest unused.
  5. Make a second HTTP call only when the next options or next state cannot be built yet.

Do not

  • One question per HTTP call
  • Hide five judgments in one Choice
  • Assume later questions saw earlier answers

Shape

{
  "state": "I've been trying to connect Stripe for 3 days. I'm losing sales. Help ASAP.",
  "model": "jev-latest",
  "questions": {
    "department": {
      "type": "choice",
      "instructions": "Which team should handle this message?",
      "criteria": {
        "billing": "Payments, invoicing, refunds",
        "technical": "Bugs, outages, integrations",
        "other": "Neither fits"
      }
    },
    "frustration": {
      "type": "score",
      "instructions": "How frustrated does the author appear?",
      "criteria": ["Calm, just stating facts", "Frustrated but civil", "Very angry, strong language"]
    },
    "is_urgent": {
      "type": "noul",
      "instructions": "Does the message convey urgency or time-sensitivity?"
    }
  }
}

This repo

  • examples/04_parallel_fanout.py — Choice + Score + Noul in one call
  • jev_lab/home.py and /home — ~13 speculative questions, then the dispatcher acts
  • packages/js/src/turn.ts — npx jev turn (route + input guard, one call)
  • docs/smart-home.md

04 同仓库更多 Skills