Refactor skill definitions into SSOT structure

Move onboarding intents, prompt data, and tools behind skill-local sources.

Register skills through factories and add a moderation skill PoC.
This commit is contained in:
dahyeon committed 2026-05-18 08:12:38 -07:00
1 parent b1cc27f6ad
commit fb189330da
29 files changed
+993 -494

No files matched your search

@@ -109,7 +109,7 @@ describe("PromptBuilder", () => {
expect(messages[0]?.content).toContain("[ACTIVE_SKILL:onboarding]");
expect(messages[0]?.content).toContain("카카오톡 오픈채팅 새내기 등록");
expect(messages[0]?.content).toContain("[현재 유저 상태]");
expect(messages[0]?.content.length ?? 0).toBeLessThan(basePrompt.length * 0.65);
expect(messages[0]?.content.length ?? 0).toBeLessThan(basePrompt.length * 0.75);
});
it("injects user memory and adaptive examples when enabled", () => {
+2 -123
View File
@@ -1,124 +1,3 @@
import type { Intent } from '../state/onboarding-state.js';
import type { Example } from '../types.js';
import { ONBOARDING_PROMPT_DATA } from "../prompt-data.js";
export const EXAMPLES_BY_INTENT: Record<Intent['kind'], Example[]> = {
greeting: [
{
user: '안녕하세요!',
assistant: '어서오세요!',
},
{
user: '반갑습니다',
assistant: '안녕하세요~',
},
],
acknowledgement: [
{
user: '넵 확인했어요',
assistant: '네, 편하게 진행해 보시면 돼요.',
},
{
user: '감사합니다',
assistant: '좋아요! 천천히 진행해 주세요.',
},
],
'status-question': [
{
user: '이제 뭐 남았지?',
assistant:
'이제 디스코드 서버 프로필 닉네임 변경하시고 주민신청 채널에 메시지만 남겨주시면 돼요!',
},
{
user: '이제 뭐 해야 할까요?',
assistant: '카톡 닉네임 변경해 주시고 방 하트 인증해 주시면 됩니다!',
},
],
'help-how': [
{
user: '하트 인증은 어떻게 해요?',
assistant:
'채팅방 오른쪽 상단 메뉴 버튼에서 "커버 보기"로 들어가 하트를 클릭하시고, 편집 없이 원본 스크린샷을 올려주시면 돼요.',
},
{
user: '본인인증 방은 뭐에요?',
assistant:
'본인 계정을 사용하고 계신지 확인하는 절차가 있어요! 본인인증방은 담당 운영진이 확인 작업을 도와드리는 별도의 채팅방이에요.',
},
{
user: '닉네임 형식 예시 알려줘',
assistant:
'닉네임은 이름/출생 연도 두 자리/성별/티어 형식이에요. 예를 들면 면정학/89/남/D처럼 쓰시면 돼요.',
},
],
'help-where': [
{
user: '하트 어디서 바꿔요?',
assistant:
'채팅방 오른쪽 상단 메뉴 버튼을 누르면 "커버 보기"가 보여요. 거기서 프로필과 하트를 확인하실 수 있어요.',
},
],
'nickname-question': [
{
user: '닉네임이 왜 안 돼요?',
assistant: '티어는 한 글자 코드로 넣어야 해요. 예를 들면 D처럼 바꿔주시면 돼요.',
},
{
user: '닉네임 형식이 뭐예요?',
assistant: '닉네임은 이름/출생 연도 두 자리/성별/티어 형식으로 입력해 주시면 돼요.',
},
],
'photo-question': [
{
user: '하트 인증이 뭐예요?',
assistant:
'채팅방 프로필에서 하트를 빨간색으로 바꾼 뒤, 그 화면이 보이게 원본 스크린샷을 보내주시면 돼요.',
},
],
'discord-question': [
{
user: '디스코드는 언제 들어가요?',
assistant:
'카카오톡 닉네임 변경과 하트 인증을 완료하셨다면, 이제 카카오톡 본인인증방/구인방 입장과 디스코드 서버 프로필 설정을 진행하시면 돼요.',
},
],
'discord-verify-question': [
{
user: '디코 닉변 확인해줘',
assistant: '아직 디스코드 닉네임 변경은 확인되지 않았어요.',
},
{
user: '디스코드 프로필 닉네임 설정 완료했어요',
assistant:
'디스코드 닉네임을 확인해봤는데 아직 올바른 형식으로 확인되지는 않았어요. 디스코드 서버 닉네임은 이름#태그/출생 연도/티어 형식이에요. 예: 할리#프렌치불독/88/D',
},
{
user: '디스코드 닉네임 바꿨어요',
assistant:
'디스코드 닉네임이 아직 이름#태그/출생 연도/티어 형식으로 확인되지 않아요. 예: 할리#프렌치불독/88/D처럼 태그를 포함해서 설정해 주세요.',
},
],
'age-question': [
{
user: '나이 제한 있나요?',
assistant: '롤림푸스는 27세 이상만 가입이 가능해요.',
},
],
chitchat: [
{
user: '오늘 날씨 좋네요',
assistant: '[NO_RESPONSE]',
},
],
'off-topic-to-other': [
{
user: '@프리리 이거 확인해줘',
assistant: '[NO_RESPONSE]',
},
],
unknown: [
{
user: '가입은 어떻게 하나요?',
assistant: '톡 게시글의 공지를 참고하셔서 닉네임 변경과 하트 인증을 진행해 주세요!',
},
],
};
export const EXAMPLES_BY_INTENT = ONBOARDING_PROMPT_DATA.examples;
+39 -107
View File
@@ -3,20 +3,13 @@ import type { RoomMessage } from '@room/types';
import type { DerivedState, Intent } from '../state/onboarding-state.js';
import type { Blackboard, Example, OnboardingSession, PromptContext } from '../types.js';
import type { UserProfile } from '../state/user-memory.js';
import {
HEART_RULE_TEXT,
MIN_AGE,
KAKAOTALK_NICKNAME_FORMAT_EXAMPLE,
DISCORD_NICKNAME_FORMAT_EXAMPLE,
TIER_CODES_TEXT,
} from '../constants.js';
import {
formatRemainingSteps,
getRemainingSteps,
hasExtendedOnboardingTracking,
isStep1Completed,
} from '../state/progress.js';
import { EXAMPLES_BY_INTENT } from './examples.js';
import { ONBOARDING_PROMPT_DATA } from '../prompt-data.js';
function formatKstTimestamp(value: string | undefined): string {
if (!value) {
@@ -81,6 +74,7 @@ function formatRoomMessages(roomContext?: RoomMessage[]): string {
}
function formatBlackboard(blackboard: Blackboard): string {
const labels = ONBOARDING_PROMPT_DATA.sections.blackboard;
const openQuestions =
blackboard.openQuestions.length > 0 ? blackboard.openQuestions.join(', ') : '(없음)';
const flaggedIssues =
@@ -91,15 +85,16 @@ function formatBlackboard(blackboard: Blackboard): string {
: '(없음)';
return [
`- lastIntent: ${blackboard.lastIntent ?? '(없음)'}`,
`- openQuestions: ${openQuestions}`,
`- flaggedIssues: ${flaggedIssues}`,
`- recentNicknameAttempts: ${nicknameAttempts}`,
`${labels.lastIntent}: ${blackboard.lastIntent ?? '(없음)'}`,
`${labels.openQuestions}: ${openQuestions}`,
`${labels.flaggedIssues}: ${flaggedIssues}`,
`${labels.recentNicknameAttempts}: ${nicknameAttempts}`,
].join('\n');
}
function formatExample(example: Example): string {
return `유저: ${example.user}\n응답: ${example.assistant}`;
const labels = ONBOARDING_PROMPT_DATA.sections.examples;
return `${labels.user}: ${example.user}\n${labels.assistant}: ${example.assistant}`;
}
function formatUserProfile(profile: UserProfile | null | undefined): string {
@@ -129,86 +124,17 @@ function formatUserProfile(profile: UserProfile | null | undefined): string {
}
export function personaLayer(): string {
return `너는 롤림푸스(lolympus) 카카오톡 오픈채팅에서 새내기 등록을 도와주는 친절한 선배야.
처음 온 멤버가 편안하게 등록을 마칠 수 있도록 자연스럽고 정확하게 안내해줘.
[롤림푸스 규칙]
- 가입 가능 연령은 ${MIN_AGE}세 이상이야.
- 새내기 등록 1단계는 카카오톡 닉네임 변경과 방 하트 인증이야.
- 1단계 완료 후에는 카카오톡 본인인증방/구인방 입장과 디스코드 서버 프로필 설정, 디스코드 주민신청 채널 메시지 남기기가 남아 있을 수 있어.
- 카카오톡 닉네임 형식은 닉네임/출생 연도 두 자리/성별/티어야. 예: ${KAKAOTALK_NICKNAME_FORMAT_EXAMPLE}
- 디스코드 서버 닉네임 형식은 닉네임#태그/출생 연도 두 자리/티어야. 카카오톡 형식과 달리 성별은 빼고 태그(#)가 들어가. 예: ${DISCORD_NICKNAME_FORMAT_EXAMPLE}
- 디스코드 관련 질문(디코 닉변, 서버 프로필 등)에는 절대 카카오톡 형식(성별 포함)을 예시로 들지 마. 반드시 디스코드 형식만 안내해.
- 성별은 남 또는 여, 티어 코드는 ${TIER_CODES_TEXT} 중 하나야.
- 방 하트 인증은 ${HEART_RULE_TEXT}
- 세션에 디스코드 관련 미완료 항목이 있으면 전체 등록은 아직 완료가 아니야.
- 디스코드 안내는 카카오톡 1단계가 완료된 뒤에만 해줘.`;
return ONBOARDING_PROMPT_DATA.persona;
}
export function policyLayer(intent: Intent, options?: { toolPolicy?: string | undefined }): string {
const lines = [
'[답변 원칙]',
'- 마지막 메시지에서 직접 물은 내용에만 정확히 답해.',
'- 사용자가 요청하지 않은 다음 단계, 방법, 위치, 예시는 먼저 붙이지 마.',
'- 마크다운 문법, 링크, URL은 쓰지 마.',
'- 온보딩과 무관한 잡담이거나 다른 사람에게 하는 말이면 "[NO_RESPONSE]"만 출력해.',
...ONBOARDING_PROMPT_DATA.policy.base,
...(ONBOARDING_PROMPT_DATA.policy.perIntent[intent.kind].length > 0
? ONBOARDING_PROMPT_DATA.policy.perIntent[intent.kind]
: ONBOARDING_PROMPT_DATA.policy.default),
];
switch (intent.kind) {
case 'greeting':
lines.push('- 짧은 인사만 1문장으로 답해.');
break;
case 'acknowledgement':
lines.push('- 짧은 확인이나 마무리만 1문장으로 답해.');
break;
case 'status-question':
lines.push('- 완료된 것은 빼고 남은 절차만 간단하게 답해.');
lines.push('- 방법 설명, 위치 설명, 예시는 넣지 마.');
break;
case 'help-where':
lines.push('- 위치나 경로만 답하고, 요청하지 않은 다음 단계는 붙이지 마.');
break;
case 'help-how':
lines.push(
'- 어떤 절차가 남아있는지 묻는 질문에는 완료된 건 말하지 말고 남은 절차만 짧게 말해.',
);
lines.push('- 사용자가 물은 한 가지 절차나 방의 의미/방법만 답해.');
lines.push(
'- 본인인증방이나 구인방이 무엇인지 묻는 질문에는 간단히 답하고, 본인인증방/구인방에 들어가서 어떻게 해야 하는지 묻는 경우 공지사항/안내메시지를 참조하라고 답해..',
);
break;
case 'nickname-question':
lines.push('- 닉네임 형식 또는 오류 원인만 답하고 다른 절차는 언급하지 마.');
break;
case 'photo-question':
lines.push('- 하트 인증에 대해서만 답하고 다른 절차는 언급하지 마.');
break;
case 'discord-question':
lines.push(
'- 디스코드 질문에만 답해. 카카오톡 1단계 전이라면 먼저 닉네임 변경과 하트 인증이 필요하다고 알려줘.',
);
lines.push(
'- 주민신청 채널이나 서버 프로필처럼 디스코드 공간/설정을 묻는 질문에는 용도와 역할을 자연스럽게 설명해.',
);
break;
case 'discord-verify-question':
lines.push('- 확인되지 않았으면 확인되지 않았다고만 답하고, 추측해서 단정하지 마.');
lines.push(
`- 디스코드 닉네임 형식은 카카오톡과 달라. 반드시 이름#태그/출생 연도 두 자리/티어 형식(성별 없음, 태그 포함)으로 안내하고, 카카오톡 형식(이름/연도/성별/티어)을 절대 제시하지 마. 예시는 ${DISCORD_NICKNAME_FORMAT_EXAMPLE} 하나만 사용해.`,
);
lines.push(
'- 디스코드 닉네임이 규칙에 맞지 않으면 위 형식과 예시를 1개만 들고 형식에 맞게 변경해 달라고 안내해.',
);
lines.push('- 사용자가 묻지 않은 디스코드 절차나 다음 단계는 먼저 붙이지 마.');
break;
case 'age-question':
lines.push('- 나이 제한만 간단히 답해.');
break;
default:
lines.push('- 질문 범위를 넘어서 먼저 설명하지 마.');
break;
}
if (options?.toolPolicy) {
lines.push(options.toolPolicy);
}
@@ -218,20 +144,21 @@ export function policyLayer(intent: Intent, options?: { toolPolicy?: string | un
export function stateLayer(session: OnboardingSession | null, derived: DerivedState): string {
const remaining = getRemainingSteps(session);
const labels = ONBOARDING_PROMPT_DATA.sections.state;
return [
'[현재 유저 상태]',
`- phase: ${derived.phase.kind}`,
`- step1(카카오톡): ${session ? (isStep1Completed(session) ? '완료' : '미완료') : '미완료'}`,
`- 카카오톡 닉네임: ${formatNicknameStatus(session)}`,
`- 방 하트 인증: ${formatPhotoStatus(session)}`,
`- 카카오톡 본인인증방 입장: ${formatOptionalVerificationStatus(session?.identityRoomJoined)}`,
`- 카카오톡 구인방 입장: ${formatOptionalVerificationStatus(session?.recruitingRoomJoined)}`,
`- 디스코드 프로필 닉네임: ${formatOptionalVerificationStatus(session?.discordProfileNicknameVerified)}`,
`- 디스코드 프로필 메시지: ${formatOptionalVerificationStatus(session?.discordProfileMessageVerified)}`,
`- extendedTracking: ${hasExtendedOnboardingTracking(session) ? 'on' : 'off'}`,
`- remaining: ${remaining.length > 0 ? formatRemainingSteps(remaining) : '없음'}`,
`- deadline(KST): ${formatKstTimestamp(session?.deadlineAt)}`,
labels.title,
`${labels.phase}: ${derived.phase.kind}`,
`${labels.step1}: ${session ? (isStep1Completed(session) ? '완료' : '미완료') : '미완료'}`,
`${labels.nickname}: ${formatNicknameStatus(session)}`,
`${labels.photo}: ${formatPhotoStatus(session)}`,
`${labels.identityRoom}: ${formatOptionalVerificationStatus(session?.identityRoomJoined)}`,
`${labels.recruitingRoom}: ${formatOptionalVerificationStatus(session?.recruitingRoomJoined)}`,
`${labels.discordProfileNickname}: ${formatOptionalVerificationStatus(session?.discordProfileNicknameVerified)}`,
`${labels.discordProfileMessage}: ${formatOptionalVerificationStatus(session?.discordProfileMessageVerified)}`,
`${labels.extendedTracking}: ${hasExtendedOnboardingTracking(session) ? 'on' : 'off'}`,
`${labels.remaining}: ${remaining.length > 0 ? formatRemainingSteps(remaining) : '없음'}`,
`${labels.deadline}: ${formatKstTimestamp(session?.deadlineAt)}`,
].join('\n');
}
@@ -243,29 +170,34 @@ export function examplesLayer(
},
): string {
const count = options?.count ?? 3;
const examples = options?.examples ?? EXAMPLES_BY_INTENT[intent.kind].slice(0, count);
const rendered = examples.length > 0 ? examples.map(formatExample).join('\n\n') : '(예시 없음)';
const examples = options?.examples ?? ONBOARDING_PROMPT_DATA.examples[intent.kind].slice(0, count);
const rendered =
examples.length > 0
? examples.map(formatExample).join('\n\n')
: ONBOARDING_PROMPT_DATA.sections.examples.empty;
return `[응답 예시]\n${rendered}`;
return `${ONBOARDING_PROMPT_DATA.sections.examples.title}\n${rendered}`;
}
export function contextLayer(context: PromptContext): string {
const labels = ONBOARDING_PROMPT_DATA.sections.context;
return [
'[최근 요약]',
labels.summary,
context.summary ?? '(요약 없음)',
'',
'[최근 대화]',
labels.history,
formatHistory(context.conversationHistory),
'',
'[방 분위기]',
labels.room,
formatRoomMessages(context.roomContext),
'',
'[메모]',
labels.blackboard,
formatBlackboard(context.blackboard),
...(context.userProfile
? [
'',
'[유저 메모리]',
labels.userMemory,
formatUserProfile(context.userProfile),
]
: []),
+17 -22
View File
@@ -1,35 +1,30 @@
import type { Intent, OnboardingPhase } from "../state/onboarding-state.js";
import { ONBOARDING_PROMPT_DATA } from "../prompt-data.js";
export function buildToolPolicy(
intent: Intent["kind"],
phase: OnboardingPhase["kind"],
): string {
if (intent === "nickname-question" && phase === "nickname-rejected") {
return "- 닉네임 후보나 현재 닉네임을 설명할 때는 validate-nickname 도구를 먼저 사용한 뒤, 틀린 부분만 짚어.";
const data = ONBOARDING_PROMPT_DATA.toolPolicy;
const byIntentPhase: Partial<Record<`${Intent["kind"]}:${OnboardingPhase["kind"]}`, string>> =
data.byIntentPhase;
const byIntent: Partial<Record<Intent["kind"], string>> = data.byIntent;
const byPhase: Partial<Record<OnboardingPhase["kind"], string>> =
data.byPhase;
const intentPhasePolicy = byIntentPhase[`${intent}:${phase}`];
if (intentPhasePolicy) {
return intentPhasePolicy;
}
if (intent === "status-question") {
return "- 진행 상태 질문은 check-onboarding-progress 도구를 우선 사용하고, 상태만 짧게 답해.";
const intentPolicy = byIntent[intent];
if (intentPolicy) {
return intentPolicy;
}
if (intent === "age-question" || intent === "discord-question") {
return [
"- 디스코드 일반 안내나 규칙 질문이면 lookup-community-rule 도구를 사용해 정확한 규칙만 답해.",
"- 사용자가 디스코드 닉네임이나 프로필 설정을 끝냈다고 말하거나 반영 여부를 묻는다면 verify-discord-nickname 도구를 먼저 사용해 직접 확인해.",
].join("\n");
const phasePolicy = byPhase[phase];
if (phasePolicy) {
return phasePolicy;
}
if (intent === "discord-verify-question") {
return "- 디스코드 닉네임 확인 요청은 verify-discord-nickname 도구를 먼저 사용하고, 조회 결과만 짧게 답해.";
}
if (intent === "help-where") {
return "- 위치 안내가 모호할 때만 get-room-context 도구를 고려하고, 기본적으로는 절차 위치만 답해.";
}
if (phase === "deadline-near") {
return "- 마감이 가까운 상태에서는 남은 절차만 우선순위로 짧게 답해.";
}
return "- 도구가 꼭 필요하지 않다면 호출하지 말고, 지금 질문에 대한 답만 간결하게 해.";
return data.default;
}