# Score

> Зважена система оцінювання за вимірами для AI-агентів — «Не здогадуйся. Оцінюй». Головна ідея: спершу зрозуміти потреби, потім чернетка й ітерації, агент — це аналітик. Видає ранжований TSV через `x score compute`.

- Skill: `x-cmd/score-19` (Agent Skill, multi-file: 45 files)
- Install (CLI): `npx get-skill add x-cmd/score-19`
- Raw SKILL.md: https://api.skillmd.com/api/skills/x-cmd/score-19/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: x-cmd (https://skillmd.com/u/x-cmd)
- Updated: 2026-11-15
- Page: https://skillmd.com/skills/x-cmd/score-19

---



# Score
«Не здогадуйся. Оцінюй.»
Зважена система оцінювання за вимірами для AI-агентів.
## Як використовувати
**Спершу зрозуміти, потім оцінювати.** Постав достатньо запитань, перш ніж визначати виміри. Хибні виміри → хибні оцінки, хай якою буде точність.
**Чернетка, потім ітерації.** Коли потреби не прояснілися повністю, склади стандарт якнайкраще, оціни й покажи результати. Користувачі реагують на конкретні ранжування — «цей фактор має бути вище», «ти пропустив X». Ось це й є сигнал. Уточнюй і оцінюй заново. Одна ітерація краща за десять раундів здогадувань.
**Агент — це аналітик.** Після обчислення прочитай TSV. Поясни, чому X переміг Y. Підкресли несподіванки. Запропонуй коригування. Ранжування починає розмову, а не завершує її.
## Основний потік
```
① Understand needs  → ② Define score.yml  → ③ Score score.tsv  → ④ x score compute  → ⑤ Report & iterate
```
Результат: `target, total, rank, block, reason, <dim> (X%), evidence`. Total 0–100, відсортовано за спаданням. rank=1 — найкращий.
## Приклад — допомагаємо користувачеві обрати рекламні слогани
1. Обговоріть із користувачем виміри оцінювання та критерії. Запишіть `slogan.score.yml`.
2. AI оцінює кожен слоган за кожним виміром (0–10, з доказом) → `slogan.score.tsv`. Поля total і rank залиште порожніми.
3. `x score compute slogan.score.yml slogan.score.tsv` → заповнює total + rank.
4. Прочитайте результати, обговоріть із користувачем. Скоригуйте оцінки або додайте кандидатів, повторіть.
5. Або: `x score iter -f slogan.score.yml slogan.score.tsv "<feedback>"`
Більше прикладів: [EXAMPLE.md](EXAMPLE.md).
## Модель із двох файлів
- `*.score.yml` — багаторазовий стандарт: виміри, фактори, описи
- `**.score.tsv` — цілі + оцінки + докази; колонка 1 = назва цілі
`x score compute <yml> <tsv>` те саме, що `python compute.py`.
## Сценарії застосування
1. **Дає агентам робочий процес ухвалення рішень.** score.yml прив'язує агента до структурованого процесу — агент іде за стандартом, а не за настроєм останнього повідомлення.
2. **Рішення ґрунтуються на правилах.** Виміри × фактори × докази → зважений підсумок → ранг. Кожна оцінка спирається на факти. Міркування прозоре.
3. **Підлаштовується під різні потреби.** Замініть виміри, скоригуйте фактори, додайте жорсткі фільтри (колонка `block`). Той самий шаблон — різні користувачі.
4. **Розвивається в міру прояснення потреб.** Чернетка → оцінка → зворотний зв'язок → уточнення → гостріше.
5. **Стандартний файл + архівовані результати для будь-якого skill.** score.yml = стандарт рішення. score.tsv = запис рішення. Обидва можна архівувати, переглядати, ними можна ділитися.
---
## Формула
```
total = Σ(factor × score) ÷ Σ(factor) × 10   →   0–100
```
- **factor** — ціле 1–10. База = 2. 1=дрібний, 4=2×, 6=3×, 8=4×, 10=5×. Автоматично нормалізується.
- **score** — 0–10 за кожним виміром, спирається на доказ.
- **total** — зважений підсумок 0–100.
Заголовки вимірів показують вагу у відсотках: `factor ÷ Σ(factor) × 100`.
## Колонки результату
| Колонка | Джерело | Опис |
|--------|--------|-------------|
| `target` | введено | Назва кандидата |
| `total` | обчислено | Зважена оцінка (0–100) |
| `rank` | обчислено | 1 = найкращий. `X`, якщо заблоковано |
| `block` | введено | Жорсткий фільтр — не порожнє = не проходить, опускається вниз, rank=X |
| `reason` | введено/виведено | Необов'язково: нотатки AI щодо нюансів оцінки |
| `<dim> (X%)` | обчислено | Оцінки за вимірами, заголовок показує вагу у відсотках |
| `evidence` | введено | Факти, що підтверджують кожну оцінку |
## Шкала
- 9–10 — Відмінно — повністю відповідає критеріям
- 7–8 — Добре — відповідає критеріям, незначна прогалина
- 5–6 — Прийнятно — напрям правильний, помітний прорахунок
- 3–4 — Слабко — значна прогалина
- 1–2 — Провал — ледьше опрацьовано
- 0 — N/A — не застосовно
## Правила
1. **Опирання на докази** — кожна оцінка МУСИТЬ мати доказ. Факти, а не відчуття.
2. **Використовуй увесь діапазон** — 5 це середина, а не значення за замовчуванням. 0 і 10 трапляються рідко, але можливі.
3. **Фактори — це відносні підсилювачі** — factor 2 = 2× вплив factor 1. Автоматично нормалізується.
4. **Цілі унікальні й не порожні** — у кожному рядку колонка 1 має містити назву цілі. Без дублікатів і порожніх значень.
5. **Агент читає, звітує, вирішує** — після обчислення поясніть результати. За потреби переоцініть або переважте.
## Файли
- `SKILL.cn.md` — китайська версія
- `compute.py` — валідує + обчислює total + rank
- `template/*.score.yml` — 35+ шаблонів. `x score ls` показує список, `x score init -t <name>` копіює
- `EXAMPLE.md` — Більше прикладів використання
- `rule-vs-score.md` — Коли використовувати rule, а коли score
- `score-template-writer.md` — Як писати шаблони оцінювання

## Пов'язане

- [rule](../rule/SKILL.md) — парний супровід для відповідності
- [naming](../naming/SKILL.md) — назви кандидатів, які оцінюються тут
