Score
„Nu ghici. Scoruiește."
Framework de scoring pe dimensiuni ponderate pentru agenți AI.
Cum să-l folosești
Întâi înțelege, apoi scoruiește. Pune suficiente întrebări înainte de a defini dimensiunile. Dimensuni greșite → scoruri greșite, oricât de precisă ar fi calculul.
Fă draft, apoi iterează. Când nevoile nu sunt clare, fă un standard «de un efort rezonabil», scoruiește și arată rezultatele. Utilizatorii reacționează la clasamente concrete — „acest factor ar trebui să fie mai mare", „ai omis X". Asta e semnalul. Rafinează și rescoruiește. O iterație bate zece runde de ghicit.
Agentul e analistul. După compute, citește TSV-ul. Explică de ce X l-a bătut pe Y. Scoate în evidență surprizele. Sugerează ajustări. Clasamentul începe conversația, nu o încheie.
Fluxul principal
① Înțelege nevoile → ② Definește score.yml → ③ Scoruiește score.tsv → ④ x score compute → ⑤ Raportează și iterează
Ieșire: target, total, rank, block, reason, <dim> (X%), evidence. Total 0–100, sortat descrescător. rank=1 e cel mai bun.
Exemplu — ajutarea unui utilizator să aleagă sloganuri promoționale
- Discută cu utilizatorul ca să definezi dimensiunile și criteriile de evaluare. Scrie
slogan.score.yml.
- AI-ul scoruiește fiecare slogan pe dimensiuni (0–10, cu dovezi) →
slogan.score.tsv. Lasă total și rank goale.
x score compute slogan.score.yml slogan.score.tsv → completează total + rank.
- Citește rezultatele, discută cu utilizatorul. Ajustează scorurile sau adaugă candidați, repetă.
- Sau:
x score iter -f slogan.score.yml slogan.score.tsv "<feedback>"
Mai multe exemple: EXAMPLE.md.
Modelul cu două fișiere
*.score.yml — Standard reutilizabil: dimensiuni, factori, descrieri
**.score.tsv — Ținte + scoruri + dovezi; coloana 1 = numele țintei
x score compute <yml> <tsv> e identic cu python compute.py.
Scenarii de aplicare
- Oferă agenților un flux de decizie. score.yml ancorează agentul într-un proces structurat — agentul urmează standardul, nu dispoziția mesajului din urmă.
- Deciziile se bazează pe reguli. Dimensuni × factori × dovezi → total ponderat → rang. Fiecare scor e ancorat în fapte. Raționamentul e transparent.
- Se adaptează la nevoi diferite. Schimbă dimensiunile, ajustează factorii, adaugă filtre dure (coloana
block). Același șablon, utilizatori diferiți.
- Evoluează pe măsură ce nevoile se clarifică. Draft → scor → feedback → rafinare → mai ascuțit.
- Fișier standard + rezultate arhivate pentru orice skill. score.yml = standardul de decizie. score.tsv = procesul-verbal al deciziei. Ambele arhivabile, reviewabile, partajabile.
Formula
total = Σ(factor × score) ÷ Σ(factor) × 10 → 0–100
- factor — întreg 1–10. Baza = 2. 1=minor, 4=2×, 6=3×, 8=4×, 10=5×. Normalizat automat.
- score — 0–10 pe dimensiune, ancorat în dovezi.
- total — total ponderat 0–100.
Antetele dimensiunilor arată procentul de pondere:
factor ÷ Σ(factor) × 100.
Coloanele de ieșire
| Coloană |
Sursă |
Descriere |
target |
intrare |
Numele candidatului |
total |
calculat |
Scor ponderat (0–100) |
rank |
calculat |
1 = cel mai bun. X dacă e blocat |
block |
intrare |
Filtru dur — nevid = descalificat, împins la final, rank=X |
reason |
intrare/ieșire |
Opțional: note ale AI-ului despre nuanțele scorului |
<dim> (X%) |
calculat |
Scoruri pe dimensiuni, antetul arată ponderea % |
evidence |
intrare |
Fapte care susțin fiecare scor |
Scala
- 9–10 — Excelent — îndeplinește complet criteriile
- 7–8 — Bun — îndeplinește criteriile, cu mici lipsuri
- 5–6 — Adequat — direcția e corectă, dar lipsește ceva notabil
- 3–4 — Slab — lacună semnificativă
- 1–2 — Dezastru — abia atins subiectul
- 0 — N/A — nu se aplică
Rules
- Ancorare în dovezi — fiecare scor TREBUIE să aibă dovezi. Fapte, nu senzații.
- Folosește toată scala — 5 e mijlocul, nu implicitul. 0 și 10 sunt rare, dar posibile.
- Factorii sunt amplificatori relativi — factorul 2 = influență de 2× față de factorul 1. Normalizat automat.
- Ținte unice și nevide — coloana 1 a fiecărui rând trebuie să aibă un nume de țintă. Fără duplicate, fără goluri.
- Agentul citește, raportează, decide — după compute, explică rezultatele. Rescoruiește sau reponderază după nevoie.
Files
SKILL.cn.md — versiunea în chineză
compute.py — Validează + calculează total + rank
template/*.score.yml — 35+ șabloane. x score ls le listează, x score init -t <name> copiază
EXAMPLE.md — Mai multe exemple de folosire
rule-vs-score.md — Când să folosești rule vs score
score-template-writer.md — Cum scrii șabloane de scoring
Related
- rule — companionul de conformitate
- naming — numele candidaților sunt scoruite aici
1---2name: score-153description: |4 Framework de scoring pe dimensiuni ponderate pentru agenți AI — "Nu ghici. Scoruiește." Ideea de bază: întâi înțelege nevoile, apoi fă un draft și iterează, agentul e analistul. Produce TSV clasat prin `x score compute`.5metadata:6 source: https://skillmd.com/skills/x-cmd/score-157 related: "rule,naming"8---91011# Score12„Nu ghici. Scoruiește."13Framework de scoring pe dimensiuni ponderate pentru agenți AI.14## Cum să-l folosești15**Întâi înțelege, apoi scoruiește.** Pune suficiente întrebări înainte de a defini dimensiunile. Dimensuni greșite → scoruri greșite, oricât de precisă ar fi calculul.16**Fă draft, apoi iterează.** Când nevoile nu sunt clare, fă un standard «de un efort rezonabil», scoruiește și arată rezultatele. Utilizatorii reacționează la clasamente concrete — „acest factor ar trebui să fie mai mare", „ai omis X". Asta e semnalul. Rafinează și rescoruiește. O iterație bate zece runde de ghicit.17**Agentul e analistul.** După compute, citește TSV-ul. Explică de ce X l-a bătut pe Y. Scoate în evidență surprizele. Sugerează ajustări. Clasamentul începe conversația, nu o încheie.18## Fluxul principal19```20① Înțelege nevoile → ② Definește score.yml → ③ Scoruiește score.tsv → ④ x score compute → ⑤ Raportează și iterează21```22Ieșire: `target, total, rank, block, reason, <dim> (X%), evidence`. Total 0–100, sortat descrescător. rank=1 e cel mai bun.23## Exemplu — ajutarea unui utilizator să aleagă sloganuri promoționale241. Discută cu utilizatorul ca să definezi dimensiunile și criteriile de evaluare. Scrie `slogan.score.yml`.252. AI-ul scoruiește fiecare slogan pe dimensiuni (0–10, cu dovezi) → `slogan.score.tsv`. Lasă total și rank goale.263. `x score compute slogan.score.yml slogan.score.tsv` → completează total + rank.274. Citește rezultatele, discută cu utilizatorul. Ajustează scorurile sau adaugă candidați, repetă.285. Sau: `x score iter -f slogan.score.yml slogan.score.tsv "<feedback>"`29Mai multe exemple: [EXAMPLE.md](EXAMPLE.md).30## Modelul cu două fișiere31- `*.score.yml` — Standard reutilizabil: dimensiuni, factori, descrieri32- `**.score.tsv` — Ținte + scoruri + dovezi; coloana 1 = numele țintei33`x score compute <yml> <tsv>` e identic cu `python compute.py`.34## Scenarii de aplicare351. **Oferă agenților un flux de decizie.** score.yml ancorează agentul într-un proces structurat — agentul urmează standardul, nu dispoziția mesajului din urmă.362. **Deciziile se bazează pe reguli.** Dimensuni × factori × dovezi → total ponderat → rang. Fiecare scor e ancorat în fapte. Raționamentul e transparent.373. **Se adaptează la nevoi diferite.** Schimbă dimensiunile, ajustează factorii, adaugă filtre dure (coloana `block`). Același șablon, utilizatori diferiți.384. **Evoluează pe măsură ce nevoile se clarifică.** Draft → scor → feedback → rafinare → mai ascuțit.395. **Fișier standard + rezultate arhivate pentru orice skill.** score.yml = standardul de decizie. score.tsv = procesul-verbal al deciziei. Ambele arhivabile, reviewabile, partajabile.40---41## Formula42```43total = Σ(factor × score) ÷ Σ(factor) × 10 → 0–10044```45- **factor** — întreg 1–10. Baza = 2. 1=minor, 4=2×, 6=3×, 8=4×, 10=5×. Normalizat automat.46- **score** — 0–10 pe dimensiune, ancorat în dovezi.47- **total** — total ponderat 0–100.48Antetele dimensiunilor arată procentul de pondere: `factor ÷ Σ(factor) × 100`.49## Coloanele de ieșire50| Coloană | Sursă | Descriere |51|--------|--------|-------------|52| `target` | intrare | Numele candidatului |53| `total` | calculat | Scor ponderat (0–100) |54| `rank` | calculat | 1 = cel mai bun. `X` dacă e blocat |55| `block` | intrare | Filtru dur — nevid = descalificat, împins la final, rank=X |56| `reason` | intrare/ieșire | Opțional: note ale AI-ului despre nuanțele scorului |57| `<dim> (X%)` | calculat | Scoruri pe dimensiuni, antetul arată ponderea % |58| `evidence` | intrare | Fapte care susțin fiecare scor |59## Scala60- 9–10 — Excelent — îndeplinește complet criteriile61- 7–8 — Bun — îndeplinește criteriile, cu mici lipsuri62- 5–6 — Adequat — direcția e corectă, dar lipsește ceva notabil63- 3–4 — Slab — lacună semnificativă64- 1–2 — Dezastru — abia atins subiectul65- 0 — N/A — nu se aplică66## Rules671. **Ancorare în dovezi** — fiecare scor TREBUIE să aibă dovezi. Fapte, nu senzații.682. **Folosește toată scala** — 5 e mijlocul, nu implicitul. 0 și 10 sunt rare, dar posibile.693. **Factorii sunt amplificatori relativi** — factorul 2 = influență de 2× față de factorul 1. Normalizat automat.704. **Ținte unice și nevide** — coloana 1 a fiecărui rând trebuie să aibă un nume de țintă. Fără duplicate, fără goluri.715. **Agentul citește, raportează, decide** — după compute, explică rezultatele. Rescoruiește sau reponderază după nevoie.72## Files73- `SKILL.cn.md` — versiunea în chineză74- `compute.py` — Validează + calculează total + rank75- `template/*.score.yml` — 35+ șabloane. `x score ls` le listează, `x score init -t <name>` copiază76- `EXAMPLE.md` — Mai multe exemple de folosire77- `rule-vs-score.md` — Când să folosești rule vs score78- `score-template-writer.md` — Cum scrii șabloane de scoring7980## Related8182- [rule](../rule/SKILL.md) — companionul de conformitate83- [naming](../naming/SKILL.md) — numele candidaților sunt scoruite aici