project-rules

星标1

分支0

更新时间2026年2月10日 10:26

Summary Bot 프로젝트의 아키텍처, 기술 스택, 코딩 컨벤션 규칙을 정의합니다. 코드 작성, 모듈 추가, 구조 변경, 컨벤션 확인 시 자동 참조됩니다.

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

来源

khw1031

khw1031/summary-bot

打开 GitHub 仓库查看创作者相关仓库

下载

Summary Bot Project Rules

Telegram 봇으로 URL/텍스트를 받아 LLM 요약 후 GitHub에 마크다운으로 저장하는 NestJS 앱.

기술 스택

레이어	선택
Package Manager	pnpm
Runtime	Node.js 20+
Framework	NestJS
Telegram	`telegraf` + `nestjs-telegraf`
LLM	`@anthropic-ai/sdk` + `@google/generative-ai` (Vercel AI SDK 사용 금지)
GitHub	`@octokit/rest`
URL 파싱	`@extractus/article-extractor`
배포	Railway (Webhook 모드)

프로젝트 구조 규칙

src/
├── app.module.ts
├── main.ts
├── telegram/       # Telegraf 봇, webhook, 메시지 핸들러
├── summary/        # 오케스트레이션 (URL파싱 -> LLM -> GitHub)
├── llm/            # LLM 호출 추상화 + providers/
├── github/         # Octokit 파일 push
├── extractor/      # URL -> 본문 추출
└── config/         # 환경변수 관리

각 도메인은 NestJS 모듈로 분리 (module.ts + service.ts)
DTO는 해당 모듈의 dto/ 하위에 배치
LLM 프로바이더는 llm/providers/에 추가

핵심 패턴

LLM Provider

LlmProvider 인터페이스 구현 (summarize(content): Promise<SummaryResult>)
Primary: Claude (claude-sonnet-4-20250514), Fallback: Gemini (gemini-2.0-flash)
LLM_PROVIDER 환경변수로 기본 프로바이더 선택
실패 시 자동으로 다른 프로바이더로 fallback

SummaryResult 구조

interface SummaryResult {
  title: string;           // 한글 제목
  description: string;     // 영문 kebab-case slug
  category: string;        // Tech | AI | Business | Design | Productivity | Life
  tags: string[];          // 3-5개
  summary: string;         // 마크다운 요약 본문
}

GitHub 저장 규칙

경로: 90-summaries/YYYY-MM-DD-{slug}.md
커밋 메시지: docs: add summary - {한글 제목}
마크다운 frontmatter 필수: title, date, category, tags, source

Telegram 핸들러

nestjs-telegraf 데코레이터 사용 (@Update, @On, @Action)
텍스트 수신 -> 요약 미리보기 + 인라인 버튼 (저장/재생성/삭제)
요약 결과는 메모리 캐시에 임시 저장 (TTL 10분)

환경변수

필수: TELEGRAM_BOT_TOKEN, TELEGRAM_WEBHOOK_DOMAIN, ANTHROPIC_API_KEY, GEMINI_API_KEY, GITHUB_TOKEN, GITHUB_REPO

상세 참조

아키텍처 상세

同仓库更多 Skills

同仓库

add-rules

khw1031/summary-bot

프로젝트에 규칙을 Skill 기반으로 추가하고 기존 규칙을 Skill로 변환합니다. 규칙 추가, 룰 추가, rule 추가, 새 규칙, 컨벤션 추가, 스타일 가이드 추가, 가이드라인 추가, 규칙 변환, rule 통합 요청 시 활성화.

2026-02-101

code-review-team

khw1031/summary-bot

프로젝트 컨텍스트를 파악한 뒤 전문가 관점으로 코드 리뷰하고, 사용자 승인 후 Agent Team SPAWN으로 병렬 개선 작업을 수행합니다. 트리거: 코드리뷰, 코드 리뷰, code review, 리뷰해줘, 리팩토링, 코드검토, PR 리뷰, 변경사항 검토.

2026-02-101

create-skill

khw1031/summary-bot

Claude Code Skill을 생성합니다. 스킬 생성, SKILL.md 작성, 새 스킬 만들기 요청 시 활성화.

2026-02-101

feature-workflow

khw1031/summary-bot

기능 구현을 5단계(Requirements → Design → Task → Implementation → Review) 워크플로우로 체계적으로 진행합니다. Agent Team 기반 병렬 구현을 지원합니다. 워크플로우, 기능 구현, 기능 개발, 작업 재개, TASK-ID 패턴, .ai/tasks 요청 시 활성화.

2026-02-101

name	project-rules
description	Summary Bot 프로젝트의 아키텍처, 기술 스택, 코딩 컨벤션 규칙을 정의합니다. 코드 작성, 모듈 추가, 구조 변경, 컨벤션 확인 시 자동 참조됩니다.
user-invocable	false

Summary Bot Project Rules

Telegram 봇으로 URL/텍스트를 받아 LLM 요약 후 GitHub에 마크다운으로 저장하는 NestJS 앱.

기술 스택

레이어	선택
Package Manager	pnpm
Runtime	Node.js 20+
Framework	NestJS
Telegram	`telegraf` + `nestjs-telegraf`
LLM	`@anthropic-ai/sdk` + `@google/generative-ai` (Vercel AI SDK 사용 금지)
GitHub	`@octokit/rest`
URL 파싱	`@extractus/article-extractor`
배포	Railway (Webhook 모드)

프로젝트 구조 규칙

src/
├── app.module.ts
├── main.ts
├── telegram/       # Telegraf 봇, webhook, 메시지 핸들러
├── summary/        # 오케스트레이션 (URL파싱 -> LLM -> GitHub)
├── llm/            # LLM 호출 추상화 + providers/
├── github/         # Octokit 파일 push
├── extractor/      # URL -> 본문 추출
└── config/         # 환경변수 관리

각 도메인은 NestJS 모듈로 분리 (module.ts + service.ts)
DTO는 해당 모듈의 dto/ 하위에 배치
LLM 프로바이더는 llm/providers/에 추가

핵심 패턴

LLM Provider

LlmProvider 인터페이스 구현 (summarize(content): Promise<SummaryResult>)
Primary: Claude (claude-sonnet-4-20250514), Fallback: Gemini (gemini-2.0-flash)
LLM_PROVIDER 환경변수로 기본 프로바이더 선택
실패 시 자동으로 다른 프로바이더로 fallback

SummaryResult 구조

interface SummaryResult {
  title: string;           // 한글 제목
  description: string;     // 영문 kebab-case slug
  category: string;        // Tech | AI | Business | Design | Productivity | Life
  tags: string[];          // 3-5개
  summary: string;         // 마크다운 요약 본문
}

GitHub 저장 규칙

경로: 90-summaries/YYYY-MM-DD-{slug}.md
커밋 메시지: docs: add summary - {한글 제목}
마크다운 frontmatter 필수: title, date, category, tags, source

Telegram 핸들러

nestjs-telegraf 데코레이터 사용 (@Update, @On, @Action)
텍스트 수신 -> 요약 미리보기 + 인라인 버튼 (저장/재생성/삭제)
요약 결과는 메모리 캐시에 임시 저장 (TTL 10분)

환경변수

필수: TELEGRAM_BOT_TOKEN, TELEGRAM_WEBHOOK_DOMAIN, ANTHROPIC_API_KEY, GEMINI_API_KEY, GITHUB_TOKEN, GITHUB_REPO

상세 참조

아키텍처 상세