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.