Communitygithub.com

haxzie/prequel

블로그 주제를 누군가가 글을 쓰기 전에 조사합니다. Prequel 블로그 주제 조사 요청, 화면 녹화 도구나 문제에 대한 사람들의 의견 수집, 출처 수집, 각도 찾기, 경쟁사 현재 요금 확인, 또는 '조사 후 작성' 요청이 있을 때 사용합니다(먼저 실행한 후, guide-posts나 comparison-posts에 전달). 주제 지도, Firecrawl 검색 스트림, Prequel 자체 사실 출처, 사용 가능한 인용 기준, 그리고 작성 스킬이 기대하는 브리프 형식을 다룹니다.

prequel란 무엇인가요?

이 스킬은 Prequel 블로그의 글을 작성하기 전에 필요한 조사 작업을 수행합니다. 작성자가 확인된 사실에 기반하여 신뢰할 수 있는 글을 쓸 수 있도록, 가격, 사용자 불만, 경쟁사 정보 등을 체계적으로 수집하고 정리하는 브리프(연구 요약서)를 생성합니다. 주요 기능으로는 주제 정의 및 장르 확인, Firecrawl을 통한 경쟁사 가격 및 기능 조사, Reddit 등 커뮤니티에서 실제 사용자 불만 수집, 기존 블로그 콘텐츠 분석을 통한 중복 및 모순 방지, 그리고 macOS 관련 최신 기술 정보 확인 등이 포함됩니다. 수집된 모든 정보는 검증 가능한 출처와 함께 날짜를 기록하여 블로그의 신뢰성을 높이며, 최종적으로 guide-posts 또는 comparison-posts와 같은 다음 작성 스킬에 전달할 수 있는 형식의 브리프를 `.context/research/<slug>.md` 파일로 생성합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/haxzie/prequel/tree/HEAD/.claude/skills/blog-research

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

블로그 조사

브리프는 '사실을 나열하는 글'과 '누군가 확인할 수 있는 사실을 나열하는 글'을 구분짓는 요소입니다. 블로그에 포함된 모든 가격, 인용된 불만, 그리고 "대부분의 도구는 60fps에서 멈춘다"와 같은 주장은 타사 제품에 대한 주장이며, 잘못된 주장 하나는 페이지의 모든 올바른 주장의 신뢰성을 떨어뜨립니다. 이 스킬은 작성자가 작업할 수 있는 검증된 목록을 생성하며, 그 외의 작업은 하지 않습니다: 글을 작성하지 않습니다.

Prequel의 사실은 웹에서 가져오지 않습니다. 리포지토리에서 가져오며, 아래 첫 번째 섹션에서 그 출처를 설명합니다. "Prequel screen recorder"를 검색하면 오래된 리뷰나 같은 이름의 다른 제품이 나올 수 있습니다.

위치

경로설명
.context/research/<slug>.md브리프. Gitignored; 임시 작업물, 배포되지 않음.
apps/web/src/content/competitors.ts페이지가 있는 6개 제품의 확인된 가격 및 기능
.claude/skills/comparison-posts/assets/quotes.json이미 캡처된 모든 Reddit 인용
apps/web/src/content/posts.ts블로그에서 이미 다룬 내용

브리프는 커밋되지 않습니다. 게시물 자체에 증거가 포함되기 때문입니다: 확인 날짜가 있는 표 아래의 가격, 인용에 링크된 Reddit 스레드, 그리고 게시물보다 오래 지속되어야 하는 모든 것은 competitors.ts나 quotes.json으로 옮겨집니다. 커밋된 브리프는 가격이 변동될 때 아무도 업데이트하지 않으면 처음으로 오래된 정보가 되며, 그렇게 되면 페이지와 일치하지 않는 두 번째 진실 공급원이 됩니다.

1단계: 주제 지도

검색을 시작하기 전에, 게시물이 무엇인지 적고 확인하세요. 세 줄로 답변에 작성하세요:

  • 답변하는 검색어. "screen recorder mac no watermark", "how to record system audio on mac". 게시물은 이 질의를 위해 작성되며, 슬러그, 정의 질문, FAQ를 결정합니다.

  • 장르. 라운드업은 [[comparison-posts]]로; "best alternatives" 게시물은 [[alternatives-posts]]로; 방법, 설명 또는 기둥 글은 [[guide-posts]]로 이동합니다. 각각 다른 조사가 필요합니다: 라운드업은 10개 도구의 가격이 필요하고, 가이드는 macOS 사실과 불만 사항이 필요합니다.

  • 정의 질문. 모든 게시물은 ## What is <thing>? 섹션으로 시작하며, 질문은 블로그 전체에서 고유해야 합니다. 제안하기 전에 기존 게시물을 검색하세요:

    grep -h "^## What is\|^## How do you" apps/web/src/content/blog/*.mdx
    

그런 다음 posts.ts에서 어떤 기둥 아래에 속하는지 확인하세요. 현재 세 가지가 있습니다: screen-recording-on-mac, product-demo-videos, screen-recording-for-youtube. 기둥이 없는 게시물은 그 자체가 기둥이며, 이는 브리프가 아닌 사용자의 결정입니다.

이 내용을 제시하고 기다리세요. 잘못된 장르로 조사하면 한 시간이 낭비됩니다.

2단계: 리포지토리에서 Prequel 자체 사실 확인

웹보다 먼저 이것들을 읽어서, 브리프가 경쟁사를 검색 엔진이 기억하는 내용이 아니라 Prequel이 실제로 제공하는 기능과 대조할 수 있도록 하세요:

사실출처
해상도, fps, 코덱, 출력apps/web/src/components/landing/LandingBody.tsx의 SPECS
자동 첫 패스가 하는 일같은 파일의 ALREADY_DONE. 그 외에는 자동화된 것이 없습니다.
가격, 체험 기간apps/web/src/lib/pricing.ts, 메모리에 있는 숫자 절대 사용 금지
제품 답변apps/web/src/lib/faq.ts
기능 행 및 당사 주장competitors.ts의 FEATURE_ROWS
요구 사항Apple Silicon, macOS 14 이상, Screen Recording 권한

[[no-dead-air-claim]]과 [[site-copy]]의 두 가지 규칙은 게시물과 마찬가지로 브리프에도 적용됩니다. Prequel은 무음을 자르거나, 트리밍하거나 제거하지 않습니다; 자르기는 타임라인에서 수동 작업입니다. 그리고 Prequel의 단점으로 브리프에 아무것도 넣지 마세요: 경쟁사가 어떤 부분에서 진정으로 우위에 있을 때, 브리프는 작성자가 그 주제를 제기하지 않도록 기록하며, 작성 금지로 표시합니다.

3단계: 검색 스트림

Firecrawl이 검색 도구입니다. firecrawl_search는 제목, 스니펫 및 URL을 반환합니다; firecrawl_scrape는 페이지를 마크다운으로 가져옵니다; firecrawl_map은 공급업체가 가격을 여러 단계 아래에 숨길 때 사이트의 페이지를 나열합니다. 장르에 필요한 스트림을 실행하세요. 다루어야 할 도구가 세 개 이상이면 하위 에이전트로 병렬 실행하고, 그렇지 않으면 인라인으로 실행하세요.

스트림 1, 공급업체 사실. 게시물에 언급된 모든 도구에 대해: 공급업체 자체 가격 페이지를 스크래핑하여 읽습니다. 각 등급과 청구 주기를 기록하세요. 월간 요금을 연간 요금 없이 인용하는 것은 비교에서 가장 해로운 오류 중 하나이며, 한 번의 클릭으로 확인할 수 있습니다. 날짜를 기록하세요. 페이지가 JS로 렌더링되고 firecrawl_scrape가 빈 껍데기를 반환하면 그렇게 말하고 headless Chrome([[headless-chrome-screenshots]] 참조)으로 가져오세요. competitors.ts에 있는 6개 도구의 경우, 현재 내용과 비교하여 차이가 있으면 표시하세요; 수정은 브리프의 숫자가 아닌 해당 파일을 편집하는 것입니다.

이 블로그에서 도구별로 중요한 사실, Prequel이 우위를 점하는 부분입니다: 각 요금제의 최고 해상도 및 프레임 속도, 무료 체험판의 워터마크, 녹화 길이 제한, 렌더링이 로컬인지 업로드인지, 일회성 라이선스 또는 구독, 촬영 후 다시 프레임을 조정할 수 있는 별도 카메라 트랙 여부.

스트림 2, 사람들이 불평하는 내용. includeDomains: ["reddit.com"]와 함께 firecrawl_search를 통한 Reddit, Hacker News, G2(2~3점 리뷰, 구체적인 불만이 있는 곳), X. 대안 게시물의 경우, 각각을 카드로 그릴 수 있을 만큼 충분히 기록하세요: 제목 그대로, 서브레딧 또는 핸들, 작성자, 날짜, 점수, 댓글 수, 첫 번째 문단. [[alternatives-posts]]가 이 내용을 렌더링합니다. firecrawl_scrape는 reddit.com을 직접 거부하므로, 스레드의 제목, 스니펫 및 URL만 반환되며, 이는 인용에 충분합니다. 작동하는 질의: "<tool> pricing" reddit, "<tool> alternatives", "<tool> watermark", "<tool> slow", record system audio mac reddit.

진정한 불만을 런칭 게시물보다 선호하세요. 검색 결과의 여러 Loom 스레드는 불만처럼 보이는 제목으로 자신의 대안을 발표하는 창업자들의 것입니다. 먼저 quotes.json을 확인하세요: 이미 캡처된 스레드는 public/blog/quotes/에 스크린샷이 있으므로 새로운 작업이 필요하지 않습니다.

스트림 3, 블로그에서 이미 말한 내용. posts.ts와 관련 주제의 기존 MDX를 읽으세요. 브리프는 새 게시물이 링크해야 할 게시물(5개 이상, 앵커 텍스트 포함), 기둥, 그리고 기존 게시물에서 새 게시물과 모순되는 문장을 나열합니다. Loom의 무료 요금제에 대해 두 게시물이 서로 다른 내용을 말하는 것은 둘 중 하나가 혼자 틀린 것보다 더 나쁩니다.

스트림 4, macOS 사실. 가이드의 경우, 현재 macOS에서 QuickTime과 Cmd+Shift+5가 할 수 있는 것과 할 수 없는 것에 대해 Apple 자체 지원 페이지(URL 포함)에서 확인하세요. 이 내용은 릴리스마다 변경되며 블로그는 이를 사실로 제시합니다.

스트림 5, 숫자. 게시물이 의존할 수 있는 모든 통계(소리 없이 시청한 시간, 데모 비디오 완료율)를 기본 출처까지 추적하고, 날짜를 기재하며, 3년 이상 되었거나 다른 블로그에서 끝나는 경우 삭제합니다. 작성자가 링크할 수 없는 숫자는 작성자가 사용할 수 없는 숫자입니다.

출처 통과 조건

  • 살아 있고, 브리프가 제시하는 내용을 로드합니다. firecrawl_scrape로 확인하세요; "Access is temporarily restricted"를 제공하는 200 응답은 출처가 아닙니다. G2, Capterra 및 Trustpilot은 모두 headless fetch에 이렇게 응답하므로 여기서 사용할 수 없습니다.
  • 리뷰 사이트보다 공급업체 페이지 우선. 요약 페이지보다 상세 페이지 우선. 예상보다 더 자주 의견이 다릅니다.
  • 날짜 기재. 가격, 통계 및 macOS 동작은 모두 확인 날짜를 포함합니다.
  • Reddit 또는 HN 인용은 스레드 URL과 서브레딧 또는 핸들입니다. 링크가 없는 의역은 인용이 아니며, 스크린샷도 아닙니다.
  • 게시물이 링크할 것은 없습니다. 블로그는 인용 호스트만 링크합니다: reddit.com, news.ycombinator.com, x.com, g2.com, 그리고 규모 수치의 경우 github.com 또는 producthunt.com. 공급업체 URL은 확인을 위해 브리프에만 있으며 다른 곳에는 없습니다.

4단계: 브리프

# Research brief: <작업 제목>

Search query: <검색어>
Genre: guide | roundup | comparison | pillar
Definitional question: ## What is <thing>?     (고유 확인됨)
Pillar: <slug> | none (this is a pillar)

## Prequel facts used
<항목, 각 항목이 가져온 파일 이름 명시>

## Do not write
<경쟁사가 Prequel을 이기는 지점으로, 작성자가 해당 주제를 피하도록 함>

## Tools
### <tool>
Price: <모든 등급 및 청구 기간>. Checked <날짜>. <vendor URL>
Facts: <해상도, fps, 워터마크, 길이 제한, 로컬 또는 업로드, 라이선스>
Prequel wins on: <이 섹션이 전달해야 할 하나의 대조점>
Complaints: <스레드 제목> (r/<sub>) <URL>    <- in quotes.json? yes/no

## macOS facts
<항목, 각 항목에 Apple URL 및 날짜 포함>

## Numbers
<통계> <기본 출처 URL> <게시 날짜>

## Existing posts to link
/blog/<slug>  "<앵커 텍스트>"  (어울리는 이유)

## Contradictions
<기존 게시물에서 새 게시물과 의견이 다를 수 있는 내용>

## FAQ candidates
<사용자가 검색 상자에 입력하는 질문> (출처: 스레드 URL 또는 PAA)

## Angles
<사람들이 묻는 것과 존재하는 것 사이의 간격에서 3~5개>

.context/research/<slug>.md에 작성하고, 작성자가 답해야 할 한 가지 질문으로 마무리하세요: 다음 단계는 어떤 스킬인지, [[guide-posts]] 또는 [[comparison-posts]], 그리고 각도 목록을 먼저 다듬어야 하는지 여부.

관련 스킬