AOSSIE-Org / AOSSIE-Org/DebateAI

[Feature Proposal] Explainable Score Analysis System

Aperta
#220 3 commenti 0 reazioni 0 assegnatari Vedi su GitHub
Lingua principale
TypeScript
Stelle
84
Fork
198
Merge medio
2g 19h
PR unite (30g)
30

Descrizione

### Is your feature request related to a problem?

Yes. Currently, users receive a final score/rating at the conclusion of a debate, but there is a lack of transparency regarding the "why" behind the numbers. This "Black Box" scoring makes it difficult for debaters to identify specific areas for improvement, such as whether they struggled with logical consistency, oratorical delivery, or rebuttal effectiveness.

---

### Description of the Proposed Feature

The Explainable Score Analysis (ESA) system aims to decompose the aggregate score into granular, interpretable components.
This feature will provide users with a detailed post-match report that balances quantitative data with qualitative insights.

---

### Key Components:

- Categorical Breakdown: Scores divided into specific pillars (e.g., Argument Strength, Evidence Quality, Rebuttal Efficiency, and Delivery).
- Sentiment/Tone Analysis: Feedback on whether the user's tone was appropriate for the debate context.
- Critical "Turning Points": Identifying specific exchanges in the transcript where the user gained or lost the lead.
- Actionable Coaching: 2–3 specific "Next Steps" generated by the AI based on the weaknesses identified.

---

### User Impact

- Educational Growth: Users can target specific skills (e.g., "I need to work on my rebuttals").
- Trust & Transparency: Users are less likely to feel "cheated" by an AI judge if they can see the logic behind the deduction.
- Engagement: Detailed feedback loops encourage users to return and try to improve specific sub-scores.

---

### Proposed Implementation Ideas

- Backend: Update the LLM prompt instructions to return a structured JSON object containing both the total score and a breakdown by criteria.
- Frontend: Introduce a "Score Summary Card" and a "Deep Dive" tab in the post-debate UI.

Guida per i contributori

Nessuna guida per i contributori indicizzata per questo repository

Valutazione

Questa issue non è ancora stata valutata.

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.