Systematically conduct structured Q&A discussions with users. Handles multiple question types, tracks progress, validates responses, and generates comprehensive summary reports. Perfect for assessments, onboarding, feedback collection, or educational interactions.

Core Capabilities

Question Types:

Multiple Choice: Select one or more correct answers from options
Single Choice: Select exactly one correct answer from options
Open-Ended: Free-form text responses with optional validation

Session Features:

Progress tracking (Question X of Y)
One question at a time for clarity
Smart re-prompting on invalid answers with helpful feedback
Complete response logging with validation status
Summary report after discussion completion

When to Use

Use this skill when you need to:

Conduct structured assessments or quizzes
Gather feedback through systematic questioning
Onboard users with validated knowledge checks
Create educational interactions with tracking
Run audits or compliance checks requiring documented responses

Don't use when:

Questions are casual or conversational (just chat naturally)
You don't need to validate or track responses
The discussion is exploratory rather than structured

The Process

Step 1: Define Questions

Create a structured question array with all necessary metadata:

const questions: Question[] = [
  {
    id: 'q1',
    text: 'What is the capital of France?',
    type: 'single',
    options: ['London', 'Paris', 'Berlin', 'Madrid'],
    correctAnswer: 'Paris'
  },
  {
    id: 'q2',
    text: 'Select all that apply: Which are JavaScript frameworks?',
    type: 'multiple',
    options: ['React', 'Django', 'Vue', 'Laravel'],
    correctAnswers: ['React', 'Vue']
  },
  {
    id: 'q3',
    text: 'Explain why you chose your answer above',
    type: 'open',
    validation: (answer) => answer.length >= 10
  }
];

Step 2: Conduct the Discussion

Call the main function to start:

const session = await conductDiscussion(questions);

The skill will:

Display each question clearly with progress indicator
Wait for user response
Validate against question criteria
Re-prompt if invalid with helpful feedback
Store validated response
Move to next question
Generate summary when complete

Step 3: Review Results

Access the session data for reporting:

// Session structure:
{
  totalQuestions: number;
  completedQuestions: number;
  responses: Array<{
    questionId: string;
    text: string;
    answer: string;
    isValid: boolean;
    attempts: number;
  }>;
  summary: {
    totalAttempts: number;
    validResponses: number;
    invalidResponses: number;
    completionTime: number;
  };
}

Display Conventions

Question Presentation:

Clear title showing question number and total (e.g., "Question 1 of 5")
Question text prominently displayed
Options numbered for easy reference (1, 2, 3...)
Instructions vary by type:

Single choice: "Select one option (enter number)"

Multiple choice: "Select all that apply (enter numbers separated by commas)"
Open-ended: "Enter your response (minimum 10 characters)"

Validation Feedback:

Invalid input: "Invalid selection. Please enter 1, 2, 3, or 4"
Multiple choice format error: "Invalid format. Use: 1,2,3"
Open-ended validation failed: "Response too short. Please provide more detail"
Empty input: "Response cannot be empty"

Progress Display:

Each question shows: "Question 2 of 7"
Visual spacing between questions for clarity
Summary displayed after final question

Error Handling

Input Validation:

Out of range selections → re-prompt with valid range
Wrong format (single choice given multiple) → explain expected format
Empty responses → ask to provide an answer
Custom validation failures → explain criteria with helpful message

Session Errors:

No questions provided → throw clear error
Invalid question type → validate during setup
Timeout/interruption → save progress and allow resume

Key Principles

One question at a time - Never show multiple questions together
Clear feedback - Always explain why an answer is invalid
Complete tracking - Log every response with validation status
Flexible validation - Support exact match, list validation, and custom functions
User-friendly - Numbered options, clear instructions, helpful messages
Resumable - Design allows pausing and resuming if needed

Example Usage

See @index.ts for complete implementation with:

Full TypeScript types for all question types
Comprehensive error handling
Real-world usage examples
Integration patterns

qa-discussion

安装