/qq-group-speaker-distinction

name: qq-group-speaker-distinction
description: Use when integrating QQ group chat where users want one shared group session, but the assistant must still distinguish who said each message.
description_zh: 用于 QQ 群聊集成：保持一个共享群会话，同时让 AI 能区分每条消息来自哪位群成员。

QQ Group Speaker Distinction

Use this skill when the user says "do not isolate by user in group chat" but still needs speaker separation.

Core Rule

• Keep one session key per group: `qq:group:{group_id}`.
• Attach speaker identity on each inbound message before it enters model context.
• Speaker identity must include stable `user_id`; nickname is only a display field.

Minimal Implementation

const sessionKey = `qq:group:${groupId}`;
const speakerTag = `[speaker:user_id=${userId};name=${displayName ?? "unknown"}]`;
const modelInput = `${speakerTag} ${rawText}`;

Add one system instruction for QQ group sessions:

• "Use `[speaker:...]` to distinguish participants. Do not merge different speakers."

Anti-Patterns

• Using `qq:group:{group_id}:user:{user_id}` when shared group context is required.
• Passing only nickname without stable `user_id`.
• Stripping speaker tags before session append or model input.

Validation Checklist

1. Log `group_id`, `user_id`, final `session_key`, and final model input. 2. Send two messages from different users in the same group. 3. Confirm both messages hit the same `session_key`. 4. Confirm each model input line has the correct `speaker:user_id=...` tag.

Best-Practice Memory Split

• Conversation context: keyed by `group_id` only.
• Optional profile memory: keyed by `group_id + user_id` for preference lookup only.