formars0309-cloud 제목 생성 브리프
주제는 정해졌고 제목은 아직인 구간을 맡는다.
이 스킬도 제목을 만들지 않는다. 만드는 건 에이전트다. 스크립트가 하는 일은 "어떤 각도를 낼 수 있는가"를 실측값으로 판정하고, 낼 수 없는 각도를 닫는 것이다.
세 스킬의 분업
blueocean 주제를 고른다 수요·공급·상업성·추세 → 등급
title-draft 각도를 정한다 실측값 → 낼 수 있는 유형 + 하드 컷 ← 여기
title-check 후보를 잰다 표현수요·유사도·상투어·SERP 잘림
도구
node ~/.claude/skills/title-draft/scripts/brief.mjs --in blueocean.json --keyword 본인부담상한제
node ~/.claude/skills/title-draft/scripts/brief.mjs --in blueocean.json --top 5
node ~/.claude/skills/title-draft/scripts/brief.mjs --in blueocean.json \
--keyword 본인부담상한제 \
--myth "상한제는 신청만 하면 초과분을 다 돌려받는다" \
--basis "비급여·선별급여는 산정 대상에서 제외된다 — 보건복지부 고시"
| 옵션 | 뜻 |
|---|---|
--in <path> |
blueocean 결과 JSON (기본 blueocean.json) |
--keyword <k> |
대상 키워드 |
--top <n> |
상위 n개를 한 번에. --myth 는 적용되지 않는다 |
--myth <문장> |
반박할 통념 |
--basis <근거> |
그 통념을 반박하는 근거. --myth 와 둘 다 있어야 반전형이 열린다 |
--json |
JSON 출력 |
세 유형 — 순서에 의미 없다
품질 등급이 아니라 서로 다른 각도다. 그래서 순위를 매기지 않는다.
| 유형 | 언제 열리나 | 쓰는 법 |
|---|---|---|
| 질문형 | 항상 | 독자가 검색창에 치는 말에 가깝게. 답을 제목에서 주지 않는다 |
| 대상·상황형 | 검색량 10만 미만일 때 | 누가·언제 읽어야 하는지를 제목에 넣는다 |
| 반전형 | --myth + --basis 둘 다 있을 때만 |
근거가 말하는 범위 안에서, 결과가 아니라 과정·조건을 뒤집는다 |
후보가 2개, 때로는 1개만 나온다. 정상이다. 빈 각도를 채우지 않는 것이 목적이다.
반전형을 조건부로 둔 이유
반전형은 후킹이 가장 세다. 그래서 위험도 가장 크다.
뒤집을 통념이 없는 주제에 이 유형을 요구하면 에이전트가 없는 통념을 지어낸다. "많은 분들이 오해하시는데…" 같은 문장이 그렇게 나온다. 금칙어 필터는 이걸 잡지 못한다 — 어휘 문제가 아니라 없는 사실을 만든 것이기 때문이다. 제목이라 본문 검수도 우회한다.
그래서 통념은 사람이 준다. 자동화가 한 단계 줄어드는 대신 이 사고가 원천 차단된다.
통념만으로는 부족하다 — 근거도 받는다
통념만 받으면 반박의 내용은 여전히 에이전트가 지어낸다. 통념이 사실이어도
"그런데 실제로는 …" 뒤가 근거 없이 채워지면 결과는 같다. 그래서 --basis 를 함께 받는다.
근거에 DOI·PMID 가 있으면 브리프가 citation-verify 명령을 만들어 준다.
node ~/.claude/skills/citation-verify/scripts/verify.mjs verify --doi 10.xxxx/yyyy
NOT_FOUND · MISMATCH · RETRACTED 가 나오면 반전형을 쓰지 않는다.
식별자가 없는 근거(공식 고시·학회 지침 등)는 원문을 직접 열어 그 문서가 실제로
이 반박을 지지하는지 확인한다. 확인 전에는 반전형을 쓰지 않는다.
하드 컷
점수가 아니라 통과/탈락이다. 하나라도 걸리면 그 후보는 버리고 다시 쓴다.
- 금칙어 — 완치, 무조건, 100%, 부작용이 없다, 모든 환자, 누구나 효과, 즉시 완화, 영구적으로
- 상투어 — 총정리, 놓치지 마세요, 완벽 정리, 한방에, 꿀팁, 충격, 경악, 이것만 알면
- 결과 약속 금지 — 낫는다·해결된다·받을 수 있다 로 끝맺지 않는다
- 없는 사실 금지 — 브리프에 없는 통념·수치·사례를 만들지 않는다
측정값을 합산하지 마라
브리프와 title-check 가 내는 숫자는 항목별 진단이다. 눈으로 더해 우열을 만들면
없앤 순위가 되살아난다. 상투어 0건은 "좋다"가 아니라 "이 항목에서 걸릴 게 없다"는 뜻이다.
제목의 클릭률은 네이버 API로 잴 수 없다. 잴 수 없는 것에 점수를 붙이면 가짜 정밀도가 된다. 최종 선택 근거는 숫자가 아니라 독자·맥락과의 적합성이다.
흐름
blueocean --hot 30으로 주제를 고른다brief.mjs --keyword <k>로 낼 수 있는 각도를 확인한다- 열린 유형마다 후보를 하나씩 쓴다. 닫힌 유형은 비워 둔다
title-check --keyword <k> --title ... --title ...으로 잰다- 하드 컷에 걸린 것은 다시 쓴다
- 사람이 고른다. 의료 콘텐츠는 발행 전 의료인 검토를 거친다
한계
이 도구는 근거의 참을 판정하지 않는다. citation-verify 는 DOI·PMID 가 실재하는
논문을 가리키는지만 확인한다 — 그 논문이 이 반박을 실제로 지지하는지는 사람이 읽어야 안다.
산문으로 된 근거는 기계가 검증할 수단이 아예 없다.
PMID 는 PMID: 라벨이 붙은 것만 인식한다. 맨 숫자를 PMID 로 오인하면 엉뚱한 논문을
조회하게 되기 때문이다. 검색량 10만 기준은 임의값이며 니치에 따라 조정할 여지가 있다.