Päringu täiustamine (Enhance Prompt)

Kirjuta kasutaja päring enne mudelile saatmist ümber tõhusamaks versiooniks. Näita kasutajale, mis muutus ja miks. Tee laiendus nähtavaks ja muudetavaks, mitte kunagi vaikivaks.

Selle oskuse mõte ei ole teha iga päring pikemaks. Mõte on tuua lühikeses päringus peituvad kaudsed eeldused nähtavale ja muuta need selgesõnalisteks juhisteks, et mudel annaks juba esimesel katsel selle, mida kasutaja tegelikult tahtis, mitte alles pärast mitut täpsustusringi.

Millal see oskus rakendub

Rakenda, kui:

1. Kasutaja on Enhance Prompti selgesõnaliselt käivitanud (nupuvajutus, oskuse lisamine või päästikfraas).
2. Rakenduses on Enhance Prompti automaatse laiendamise lüliti sees ja kasutaja on just päringu saatnud.

Automaatse laiendamise režiimis kontrolli enne laienduse koostamist ka järgmises jaotises toodud vahelejätmise tingimusi. Automaatne laiendamine ei tohi olla agressiivne — paljud päringud ei vaja laiendamist ning laiendus seal, kus seda vaja pole, tekitab hõõrdumist, mitte väärtust.

Millal MITTE rakendada (vahelejätmise tingimused)

Jäta laiendus vahele ja lase algne päring muutmata läbi, kui:

• Päring on juba hästi struktureeritud. Kui kasutaja on juba määranud rolli, ülesande, piirangud ja väljundi vormi, lisab laiendus vaid müra. Rusikareegel: kui päring on üle ~80 sõna ja sisaldab selgesõnalisi juhiseid vormi, sihtrühma või ulatuse kohta, jäta vahele.
• Päring on vestluslik või suhtlusse puutuv. „aitäh“, „mida sa selle all mõtlesid“, „jätka“, „jäta see punkt vahele“ — need on vestluskäigud, mitte uued ülesanded. Ära laienda.
• Päring on eelmist ülesannet jätkav täpsustav küsimus. Kui chat_history näitab, et kasutaja täiendab eelmist vastust („kas saad lisada ka X“, „lühemalt palun“, „aga California puhul“), annab eelmine käik konteksti; laiendus heidaks selle kõrvale. Ära laienda.
• Päring on pigem toiminguline kui sisuline. „tee kokkuvõte dokumendist, mille just üles laadisin“, „tõlgi see“, „vorminda see tabelina“ — need on otsesed toimingupalved; laiendus lisab hõõrdumist, mitte selgust.
• Kasutaja on selle päringu puhul selgesõnaliselt loobunud. Kui kasutaja on kirjutanud --no-enhance-prompt, [skip enhance prompt] või midagi sarnast, austa seda.
• Lisatud on oskus, mis juba ise päringut laiendab. Kui attached_skills sisaldab oskust, mille kirjelduse järgi see tegeleb päringute laiendamise või ümberkirjutamisega, jäta vahele — lase lisatud oskusel juhtida.

Vahele jättes tagasta vahelejätmise otsus selgesõnaliselt (vt jaotist „Väljund“), et rakendus saaks algse päringu läbi lasta.

Mida hea laiendus teeb

Hea laiendus muudab kaudsed elemendid selgesõnaliseks. Juriidilistes päringutes on kõige sagedamini esile toomist vajavad kaudsed elemendid järgmised:

1. Roll. Millist juristi rolli mudel võtab? „Oled ettevõttesisene jurist, kes vaatab üle X“ ankurdab vastuse õigesse hääletooni ja põhjalikkusse. Vaikimisi roll on ettevõttesisene jurist; kohanda vastavalt kontekstile.
2. Jurisdiktsioon. Juriidilised vastused sõltuvad jurisdiktsioonist. Kui päringus esitatud küsimuse vastus sõltub jurisdiktsioonist ja jurisdiktsiooni pole märgitud, lisa kasutaja seadistatud jurisdiction, kui see on olemas, või märgi, et laiendus eeldas vaikimisi US-i ja küsimus tuleks uuesti esitada, kui kehtib mõni teine jurisdiktsioon.
3. Sihtrühm. Kas väljund on kasutajale endale, äripartnerile edasisaatmiseks, nõukogule või välisele õigusnõustajale? Sihtrühm muudab tooni, pikkust ja sügavust.
4. Ulatus. „Vaata see leping üle“ võib tähendada 30-sekundilist esmast sõelumist või kahetunnist sisulist ülevaatust. Too kaudne ulatus esile. „Too välja kolm kuni viis kõige olulisemat probleemi“ on teistsugune palve kui „põhjalik ülevaatus“.
5. Väljundi vorm. Täpploend? Pealkirjadega memo? Tabel? Ühelõiguline kokkuvõte? Vali vaikimisi see, mida sisu soovitab, kuid tee see selgesõnaliseks.
6. Piirangud ja välistused. Mida vastus ei tohiks teha? „Andmata lõplikku õiguslikku arvamust“, „spekuleerimata täitmisele pööratavuse üle“, „piirdudes dokumendi tekstist nähtavate küsimustega“ — need on turvapiirded, mis hoiavad mudeli ulatuse piires.
7. Viitamise ootused. Kui päring puudutab dokumenti, täpsusta, kas vastused peaksid viitama konkreetsetele klauslitele või jaotistele.

Hea laiendus lisab need ainult seal, kus need tegelikult puuduvad. Rolli lisamine päringule, milles roll on juba määratud, on müra. Jurisdiktsiooni lisamine küsimusele, millel pole jurisdiktsioonist sõltuvat osa, on müra.

Mida hea laiendus EI tee

• Ei mõtle välja juriidilist sisu. Oskus laiendab päringut; see ei vasta sellele ette. Kui kasutaja päring on „mis on NDA tavapärane kehtivusaeg“, täpsustab laiendus rolli, sihtrühma ja vormi — see ei lisa päringusse „tavapärane on 3 aastat“.
• Ei kitsenda kasutaja kavatsust. Kui kasutaja päring on avatud, säilitab laiendus selle avatuse. „Anna mulle kolm probleemi“ määramine, kui kasutaja ütles „vaata see üle“, asendab kasutaja otsustuse oskuse omaga.
• Ei too sisse oskusi, mida kasutaja ei lisanud. Kui NDA-Review oskust pole lisatud, kuid päring puudutab NDA-d, võib laiendus märkida, et NDA-Review on teegis olemas, kuid ei lisa päringusse NDA-Review ülevaatuse raamistikku.
• Ei ole vastuolus oskuse juhistega. Kui oskus on lisatud, austab laiendus selle oskuse ulatust. Oskuse frontmatteri kirjeldus ütleb, mida oskus teeb; laiendus peaks seda täiendama, mitte üle kirjutama.
• Ei heida kõrvale kasutaja sõnastust. Säilita kasutaja sisulised tegusõnad ja nimisõnad. „Aita mul välja mõelda“ jääb nii, nagu on; ära „paranda“ seda sõnastuseks „Analüüsi põhjalikult“. Kasutaja hääl kannab infot kiireloomulisuse, formaalsuse ja enesekindluse kohta — selle säilitamine on osa kavatsuse säilitamisest.
• Ei ületa mõistlikku pikkust. Hea laiendus on tavaliselt 2–5 korda sisendist pikem. Kui 10-sõnalisest päringust saab 200-sõnaline päring, on see märk, et laiendus on üle piiri läinud.

Töövoog

1. Loe sisend. Parsi raw_input. Tuvasta, mida kasutaja palub (sisuline ülesanne) ja kuidas ta seda palub (hääl, formaalsus, kiireloomulisus).

2. Kontrolli vahelejätmise tingimusi. Käi läbi ülaltoodud jaotise vahelejätmise tingimused. Kui mõni kehtib, tagasta vahelejätmise otsus (vt jaotist „Väljund“). Lõpeta siin.

3. Loe kontekst. Kui attached_skills, attached_files, chat_history või jurisdiction on antud, loe need läbi. Tuvasta, mis on juba paika pandud ja mida ei tule uuesti määrata.

4. Tuvasta lüngad. Käi läbi seitse elementi (roll, jurisdiktsioon, sihtrühm, ulatus, väljundi vorm, piirangud, viitamise ootused) ja tuvasta, millised neist on päringus kaudsed ja väärt esile toomist. Jäta vahele elemendid, mis on juba selgesõnalised, ja elemendid, mis selle päringu puhul ei ole asjakohased (nt viitamise ootused on ebaolulised, kui ühtki dokumenti pole kaasatud).

5. Koosta laienduse mustand. Kirjuta laiendatud päring. Säilita kasutaja sisulised tegusõnad ja nimisõnad. Lisa sammus 4 tuvastatud elemendid. Hoia kogupikkus 2–5-kordse sisendi pikkuse piires.

6. Kirjuta põhjenduste jaotis. Kolm kuni kuus täppi, üks iga lisatud või muudetud elemendi kohta. Iga täpp nimetab lihtsas keeles, mis lisati ja miks. Kasutaja loeb seda; kirjuta kasutajale, mitte arendajale.

7. Tagasta struktureeritud väljund. Vt jaotist „Väljund“.

Väljund

Oskus tagastab struktureeritud objekti:

expansion_applied: true | false
expanded_prompt: <the expanded prompt text, or the original if skipped>
reasoning:
  - <bullet on what was added or modified, and why>
  - <one bullet per substantive change>
skip_reason: <if expansion_applied is false, the reason from the skip conditions list, or null>
preview_to_user: |
  <a single rendered string the application can show in the "review before sending" UI, combining the expanded prompt and the reasoning, formatted for human reading>

Oskus vastutab: - Laienduse sisu ja põhjenduste koostamise eest. - Rakenduse poolt tarbitava struktureeritud väljundi tagastamise eest.

Rakendus vastutab: - preview_to_user kasutajale näitamise eest koos muutmise/saatmise/vahelejätmise nuppudega. - expanded_prompt mudelile saatmise eest, kui kasutaja kinnitab. - Algse raw_input saatmise eest, kui kasutaja valib vahelejätmise. - Ülevaatusekraanil „vaata seda oskust“ võimaluse pakkumise eest, et kasutaja saaks soovi korral oskust ennast uurida (vt allpool „Läbipaistvus“).

Oskus ise ei käivita mudelit laiendatud päringuga; see tagastab laienduse rakendusele käsitlemiseks.

Läbipaistvus

See oskus on loodud nii, et kasutaja saaks seda uurida. Rakendus peaks tegema oskuse sisu (selle SKILL.md ja selle tugifailid) vaadatavaks ülevaatusekraanilt enne saatmist. Kasutajad, kes tahavad täpselt mõista, kuidas nende päringuid täiustatakse — sh milliseid mustreid see oskus rakendab, millised piirangud kehtivad lisatavale ja millised põhimõtted hoiavad hääle alles —, peaksid saama oskust ennast lugeda.

Läbipaistvus on funktsioon, mitte leke. Oskuse juhised ei ole ärisaladus; need on avatud lähtekoodiga tööprodukt. Kasutajad, kes saavad oskust lugeda, saavad sellega ka mitte nõustuda, selle edasi arendada (fork) või selle asendada. Just selline peab olema suhe kasutajate ja nende tööd kujundavate tööriistade vahel.

Erijuhud ja keeldumised

• Tühi või peaaegu tühi sisend. Kui kasutaja saatis ainult tühikud, „?“, „test“ või midagi sarnast, tagasta expansion_applied: false koos skip_reason: "input too short to expand meaningfully".
• Mitmekeelne sisend. Säilita sisendi keel. Prantsuskeelne päring laieneb prantsuskeelseks laiendatud päringuks koos prantsuskeelsete põhjendustega. Kui sisend segab keeli või keel on ebaselge, laienda valdavas keeles ja märgi ebaselgus põhjendustes.
• Päringud, mis sisaldavad konfidentsiaalset teavet päringus endas. Ära võta ega ümberjuta konfidentsiaalset sisu põhjenduste jaotisse. Põhjenduste jaotis räägib struktuurist, mitte sisust.
• Päringud, mis on selgelt väljaspool õiguspraktikat. Kui kasutaja päringul pole juriidilise tööga mingit pistmist (nt „mis on hea restoran Bostonis“, „kirjuta haiku minu koerast“), laienda üldiste rolli/sihtrühma/vormi heuristikate, mitte õigusspetsiifiliste põhjal. Ära keeldu — Enhance Prompt on üldine laiendusoskus, mis on häälestatud juriidilisele tööle, kuid on kasulik ka mujal.
• Päringud, mis paluvad oskusel teha midagi muud kui laiendada. Kui kasutaja päring on „mida Enhance Prompt teeb“ või „skip Enhance Prompt“, suuna vahelejätmise teele ja tagasta algne päring.

Viitematerjalid

• reference/expansion_patterns.md — levinud mustrid juriidiliste päringute laiendamiseks eri liiki juriidilise töö puhul (lepingute ülevaatus, koostamine, uurimine, nõustamine).
• reference/preserve_user_voice.md — põhimõtted kasutaja hääle säilitamiseks laiendamise käigus.
• examples/example_short_prompt.md — lühike päring, mis on laiendatud täielikuks struktureeritud päringuks.
• examples/example_skipped.md — näide päringust, mis tuleks vahele jätta, koos põhjendusega.
• examples/example_with_skill.md — laiendus, kui oskus on juba lisatud, näitab, kuidas laiendus austab lisatud oskuse ulatust.

Kutsesaladuse (privilege) käsitlemine

Nii kasutaja raw_input kui ka sellest tulenev expanded_prompt võivad sisaldada kutsesaladusega kaitstud materjali. Laiendatud päring on kasutaja sisendi tuletis — see pärib algse sisendi kutsesaladuse staatuse, olgu see milline tahes. Käsitle laiendust samamoodi nagu algset suhtlust.

Konkreetselt:

• Mõlemad artefaktid säilitavad algse kutsesaladuse staatuse. Kui raw_input oli kutsesaladusega kaitstud advokaadi ja kliendi vaheline suhtlus või advokaadi tööprodukt (attorney work product), on seda ka expanded_prompt. Kutsesaladus ei kao seetõttu, et oskus kirjutab pinnavormi ümber.
• Ära salvesta laiendatud päringut väljaspool kutsesaladuse ringi. Seda oskust rakendavad hostid ei tohi logida, säilitada, edastada ega jagada expanded_prompt, preview_to_user ega reasoning väljaspool sama usalduspiiri, mis kehtiks kasutaja algsele päringule. Analüütikatorud, treeningandmete kogumine, kolmandate osapoolte mudeli otspunktid ja jagatud ülevaatusjärjekorrad on levinud lekketeed ning peavad olema ringi sees või välistatud.
• Ka põhjenduste jaotis on tuletis. Kuigi põhjendused räägivad struktuurist, mitte sisust, võivad need nimetada päringu teemat ja kanda seega sama kutsesaladuse staatust. Ära pea reasoning logimiseks ohutuks ainult seetõttu, et see ei tsiteeri sisendit sõna-sõnalt.
• Hosti vastutus. Kasutaja vastutab selle eest, et ta ei lisaks kutsesaladusega kaitstud sisu raw_input-i, kui hostrakendus pole seadistatud seda käsitlema; hostrakendus vastutab selle eest, et laiendatud artefakti ei logita, säilitata ega edastata väljaspool kutsesaladuse ringi. See oskus ise ei kirjuta midagi — kuid see loob artefakti, mida allavoolu süsteemidel on kiusatus logida.

Kvaliteedikontrolli parandused (LegalQuants, 2026-05)

See oskus vaadati 2026-05-11 üle Legal Skill Design Frameworki alusel (otsus: SOME CONCERN). Tuvastatud sisuline lünk oli see, et laiendatud päringu artefakti kutsesaladusega seotud tagajärgi ei käsitletud — iga juriidiline päring, mida see metaoskus puudutab, muutub ümberkirjutatud artefaktiks, mida hostrakendus võib logida või säilitada, ning algne SKILL.md käsitles konfidentsiaalsust ainult põhjenduste jaotise tasandil. Ülaltoodud jaotis „Kutsesaladuse (privilege) käsitlemine“ lisati paranduse käigus, et teha selgesõnaliseks, et (a) kasutaja sisendpäring ja laiendatud versioon võivad mõlemad sisaldada kutsesaladusega kaitstud materjali, (b) mõlemad säilitavad algse kutsesaladuse staatuse ja (c) laiendatud päringut ei tohi salvestada, logida ega jagada väljaspool kutsesaladuse ringi. Frontmatterit täiendati väljadega version, last_reviewed ja last_reviewed_by ning autorlus viidi kooskõlla, et tunnustada Kevin Kellerit (vastavalt registri README-le). Tehniline töövoog, vahelejätmise tingimused, laiendusmustrid ja väljundskeem jäeti puutumata.