Score
"Don't guess. Score."
Khung chấm điểm theo chiều có trọng số cho AI agent.
Cách dùng
Hiểu trước, chấm sau. Hãy hỏi đủ câu trước khi định nghĩa các chiều. Chiều sai → điểm sai, dù có chính xác đến đâu.
Soạn thảo rồi lặp lại. Khi nhu cầu chưa rõ hoàn toàn, hãy dựng một tiêu chuẩn theo khả năng tốt nhất, chấm điểm, rồi trình kết quả. Người dùng sẽ phản hồi với những thứ hạng cụ thể — "yếu tố này lên cao hơn", "bạn bỏ sót X". Đó chính là tín hiệu. Tinh chỉnh rồi chấm lại. Một vòng lặp còn hơn mười vòng đoán mò.
Agent là nhà phân tích. Sau khi compute, hãy đọc TSV. Giải thích vì sao X thắng Y. Chỉ ra những điều bất ngờ. Đề xuất điều chỉnh. Bảng xếp hạng mở đầu cuộc trò chuyện, không kết thúc nó.
Luồng chính
① Hiểu nhu cầu → ② Định nghĩa score.yml → ③ Chấm điểm score.tsv → ④ x score compute → ⑤ Báo cáo & lặp lại
Đầu ra: target, total, rank, block, reason, <dim> (X%), evidence. Total 0–100, sắp xếp giảm dần. rank=1 là tốt nhất.
Ví dụ — giúp người dùng chọn slogan quảng bá
- Thảo luận với người dùng để xác định các chiều và tiêu chí đánh giá. Viết
slogan.score.yml.
- AI chấm điểm từng slogan theo từng chiều (0–10, kèm bằng chứng) →
slogan.score.tsv. Để trống total và rank.
x score compute slogan.score.yml slogan.score.tsv → điền total + rank.
- Đọc kết quả, thảo luận với người dùng. Điều chỉnh điểm hoặc thêm ứng viên, lặp lại.
- Hoặc:
x score iter -f slogan.score.yml slogan.score.tsv "<feedback>"
Thêm ví dụ: EXAMPLE.md.
Mô hình hai tệp
*.score.yml — Tiêu chuẩn dùng lại được: các chiều, hệ số, mô tả
**.score.tsv — Mục tiêu + điểm + bằng chứng; cột 1 = tên mục tiêu
x score compute <yml> <tsv> tương đương với python compute.py.
Kịch bản ứng dụng
- Cho agent một quy trình ra quyết định. score.yml neo agent vào một quy trình có cấu trúc — agent tuân theo tiêu chuẩn, không theo tâm trạng của tin nhắn gần nhất.
- Quyết định dựa trên quy tắc. Chiều × hệ số × bằng chứng → tổng có trọng số → thứ hạng. Mọi điểm đều neo vào sự thật. Lập luận minh bạch.
- Tinh chỉnh theo nhu cầu khác nhau. Đổi chiều, chỉnh hệ số, thêm bộ lọc cứng (cột
block). Cùng một template, người dùng khác nhau.
- Tiến hoá cùng khi nhu cầu được làm rõ. Soạn thảo → chấm điểm → phản hồi → tinh chỉnh → sắc bén hơn.
- Tệp tiêu chuẩn + kết quả lưu trữ cho bất kỳ skill nào. score.yml = tiêu chuẩn ra quyết định. score.tsv = biên bản ra quyết định. Cả hai đều có thể lưu trữ, rà soát, chia sẻ.
Công thức
total = Σ(factor × score) ÷ Σ(factor) × 10 → 0–100
- factor — số nguyên 1–10. Mốc cơ sở = 2. 1=thấ nhất, 4=2×, 6=3×, 8=4×, 10=5×. Tự động chuẩn hóa.
- score — 0–10 cho mỗi chiều, neo vào bằng chứng.
- total — tổng có trọng số 0–100.
Tiêu đề chiều hiển thị trọng số %:
factor ÷ Σ(factor) × 100.
Các cột đầu ra
| Cột |
Nguồn |
Mô tả |
target |
input |
Tên ứng viên |
total |
computed |
Điểm có trọng số (0–100) |
rank |
computed |
1 = tốt nhất. X nếu bị chặn |
block |
input |
Bộ lọc cứng — khác rỗng = mất tư cách, đẩy xuống cuối, rank=X |
reason |
input/output |
Tùy chọn: ghi chú của AI về sắc thái của điểm |
<dim> (X%) |
computed |
Điểm theo từng chiều, tiêu đề hiển thị trọng số % |
evidence |
input |
Sự thật đứng sau mỗi điểm |
Thang điểm
- 9–10 — Excellent — đáp ứng hoàn toàn tiêu chí
- 7–8 — Good — đáp ứng tiêu chí, thiếu sót nhỏ
- 5–6 — Adequate — đúng hướng, có điểm lệch đáng kể
- 3–4 — Weak — thiếu sót nghiêm trọng
- 1–2 — Fail — mới nhắm được thoáng qua
- 0 — N/A — không áp dụng
Quy tắc
- Neo vào bằng chứng — mọi điểm đều PHẢI có bằng chứng. Là sự thật, không phải cảm giác.
- Dùng hết khoảng điểm — 5 là giữa khoảng, không phải mặc định. 0 và 10 hiếm nhưng vẫn có thể.
- Hệ số là bộ khuếch đại tương đối — factor 2 = ảnh hưởng gấp 2 lần factor 1. Tự động chuẩn hóa.
- Mục tiêu duy nhất và không rỗng — cột 1 mỗi dòng đều phải có tên mục tiêu. Không trùng, không trống.
- Agent đọc, báo cáo, quyết định — sau khi compute, giải thích kết quả. Chấm lại hoặc đánh lại trọng số khi cần.
Files
SKILL.cn.md — phiên bản Trung Quốc
compute.py — Kiểm tra + tính total + rank
template/*.score.yml — hơn 35 template. x score ls để liệt kê, x score init -t <name> để sao chép
EXAMPLE.md — Thêm ví dụ sử dụng
rule-vs-score.md — Khi nào dùng rule và khi nào dùng score
score-template-writer.md — Cách viết template chấm điểm
Liên quan
- rule — bạn đồng hành về tuân thủ
- naming — tên ứng viên được chấm điểm ở đây
1---2name: score-203description: |4 Khung chấm điểm theo chiều có trọng số cho AI agent — "Don't guess. Score." Ý tưởng cốt lõi: hiểu nhu cầu trước, soạn thảo rồi lặp lại, agent là nhà phân tích. Xuất ra TSV đã xếp hạng qua `x score compute`.5metadata:6 source: https://skillmd.com/skills/x-cmd/score-207 related: "rule,naming"8---91011# Score12"Don't guess. Score."13Khung chấm điểm theo chiều có trọng số cho AI agent.14## Cách dùng15**Hiểu trước, chấm sau.** Hãy hỏi đủ câu trước khi định nghĩa các chiều. Chiều sai → điểm sai, dù có chính xác đến đâu.16**Soạn thảo rồi lặp lại.** Khi nhu cầu chưa rõ hoàn toàn, hãy dựng một tiêu chuẩn theo khả năng tốt nhất, chấm điểm, rồi trình kết quả. Người dùng sẽ phản hồi với những thứ hạng cụ thể — "yếu tố này lên cao hơn", "bạn bỏ sót X". Đó chính là tín hiệu. Tinh chỉnh rồi chấm lại. Một vòng lặp còn hơn mười vòng đoán mò.17**Agent là nhà phân tích.** Sau khi compute, hãy đọc TSV. Giải thích vì sao X thắng Y. Chỉ ra những điều bất ngờ. Đề xuất điều chỉnh. Bảng xếp hạng mở đầu cuộc trò chuyện, không kết thúc nó.18## Luồng chính19```20① Hiểu nhu cầu → ② Định nghĩa score.yml → ③ Chấm điểm score.tsv → ④ x score compute → ⑤ Báo cáo & lặp lại21```22Đầu ra: `target, total, rank, block, reason, <dim> (X%), evidence`. Total 0–100, sắp xếp giảm dần. rank=1 là tốt nhất.23## Ví dụ — giúp người dùng chọn slogan quảng bá241. Thảo luận với người dùng để xác định các chiều và tiêu chí đánh giá. Viết `slogan.score.yml`.252. AI chấm điểm từng slogan theo từng chiều (0–10, kèm bằng chứng) → `slogan.score.tsv`. Để trống total và rank.263. `x score compute slogan.score.yml slogan.score.tsv` → điền total + rank.274. Đọc kết quả, thảo luận với người dùng. Điều chỉnh điểm hoặc thêm ứng viên, lặp lại.285. Hoặc: `x score iter -f slogan.score.yml slogan.score.tsv "<feedback>"`29Thêm ví dụ: [EXAMPLE.md](EXAMPLE.md).30## Mô hình hai tệp31- `*.score.yml` — Tiêu chuẩn dùng lại được: các chiều, hệ số, mô tả32- `**.score.tsv` — Mục tiêu + điểm + bằng chứng; cột 1 = tên mục tiêu33`x score compute <yml> <tsv>` tương đương với `python compute.py`.34## Kịch bản ứng dụng351. **Cho agent một quy trình ra quyết định.** score.yml neo agent vào một quy trình có cấu trúc — agent tuân theo tiêu chuẩn, không theo tâm trạng của tin nhắn gần nhất.362. **Quyết định dựa trên quy tắc.** Chiều × hệ số × bằng chứng → tổng có trọng số → thứ hạng. Mọi điểm đều neo vào sự thật. Lập luận minh bạch.373. **Tinh chỉnh theo nhu cầu khác nhau.** Đổi chiều, chỉnh hệ số, thêm bộ lọc cứng (cột `block`). Cùng một template, người dùng khác nhau.384. **Tiến hoá cùng khi nhu cầu được làm rõ.** Soạn thảo → chấm điểm → phản hồi → tinh chỉnh → sắc bén hơn.395. **Tệp tiêu chuẩn + kết quả lưu trữ cho bất kỳ skill nào.** score.yml = tiêu chuẩn ra quyết định. score.tsv = biên bản ra quyết định. Cả hai đều có thể lưu trữ, rà soát, chia sẻ.40---41## Công thức42```43total = Σ(factor × score) ÷ Σ(factor) × 10 → 0–10044```45- **factor** — số nguyên 1–10. Mốc cơ sở = 2. 1=thấ nhất, 4=2×, 6=3×, 8=4×, 10=5×. Tự động chuẩn hóa.46- **score** — 0–10 cho mỗi chiều, neo vào bằng chứng.47- **total** — tổng có trọng số 0–100.48Tiêu đề chiều hiển thị trọng số %: `factor ÷ Σ(factor) × 100`.49## Các cột đầu ra50| Cột | Nguồn | Mô tả |51|--------|--------|-------------|52| `target` | input | Tên ứng viên |53| `total` | computed | Điểm có trọng số (0–100) |54| `rank` | computed | 1 = tốt nhất. `X` nếu bị chặn |55| `block` | input | Bộ lọc cứng — khác rỗng = mất tư cách, đẩy xuống cuối, rank=X |56| `reason` | input/output | Tùy chọn: ghi chú của AI về sắc thái của điểm |57| `<dim> (X%)` | computed | Điểm theo từng chiều, tiêu đề hiển thị trọng số % |58| `evidence` | input | Sự thật đứng sau mỗi điểm |59## Thang điểm60- 9–10 — Excellent — đáp ứng hoàn toàn tiêu chí61- 7–8 — Good — đáp ứng tiêu chí, thiếu sót nhỏ62- 5–6 — Adequate — đúng hướng, có điểm lệch đáng kể63- 3–4 — Weak — thiếu sót nghiêm trọng64- 1–2 — Fail — mới nhắm được thoáng qua65- 0 — N/A — không áp dụng66## Quy tắc671. **Neo vào bằng chứng** — mọi điểm đều PHẢI có bằng chứng. Là sự thật, không phải cảm giác.682. **Dùng hết khoảng điểm** — 5 là giữa khoảng, không phải mặc định. 0 và 10 hiếm nhưng vẫn có thể.693. **Hệ số là bộ khuếch đại tương đối** — factor 2 = ảnh hưởng gấp 2 lần factor 1. Tự động chuẩn hóa.704. **Mục tiêu duy nhất và không rỗng** — cột 1 mỗi dòng đều phải có tên mục tiêu. Không trùng, không trống.715. **Agent đọc, báo cáo, quyết định** — sau khi compute, giải thích kết quả. Chấm lại hoặc đánh lại trọng số khi cần.72## Files73- `SKILL.cn.md` — phiên bản Trung Quốc74- `compute.py` — Kiểm tra + tính total + rank75- `template/*.score.yml` — hơn 35 template. `x score ls` để liệt kê, `x score init -t <name>` để sao chép76- `EXAMPLE.md` — Thêm ví dụ sử dụng77- `rule-vs-score.md` — Khi nào dùng rule và khi nào dùng score78- `score-template-writer.md` — Cách viết template chấm điểm7980## Liên quan8182- [rule](../rule/SKILL.md) — bạn đồng hành về tuân thủ83- [naming](../naming/SKILL.md) — tên ứng viên được chấm điểm ở đây