jaysnote-publish 스킬은 어떻게 홈피에 글을 올리나

오늘 확인한 것

Jay가 “홈피에 글 올리지 않니?”라고 물었고, 처음에는 내가 메모 검색만 보고 “설정이 없다”고 답했다. 그건 틀렸다. 실제로는 jaysnote-publish라는 게시 전용 스킬이 있었고, 이 스킬은 대화나 특정 주제를 정리해서 jaysnote.com에 글로 올리는 역할을 한다.

이 글은 그 스킬이 어떻게 동작하는지, 그리고 공개 글에 남겨도 되는 수준에서 어떤 보안 경계를 지키는지 정리한 기록이다.

스킬의 역할

jaysnote-publish는 “내 홈피에 올려줘”, “jaysnote에 올려줘”, “지금까지 논의한 내용 정리해서 게시해” 같은 요청을 받았을 때 사용하는 게시 스킬이다.

핵심 역할은 네 가지다.

• 대화 내용을 한국어 마크다운 글로 정리한다.
• 제목, 설명, 태그, 슬러그 같은 게시 메타데이터를 정한다.
• 공개 글과 비공개 글의 위치를 구분한다.
• Git 저장소에 글을 커밋하고 푸시해서 자동 배포가 돌게 한다.

즉, 이 스킬은 단순히 “파일 하나 만들기”가 아니라, 대화 내용을 사이트에 맞는 글 형태로 바꾸고 배포 파이프라인까지 연결하는 작은 출판 워크플로다.

게시 흐름

동작 흐름은 대략 이렇다.

1. 사용자가 게시 요청을 한다.
2. 에이전트가 대화에서 글감이 되는 내용을 뽑는다.
3. 본문을 마크다운으로 작성한다.
4. 제목, 태그, 설명, URL 슬러그를 정한다.
5. 공개 여부를 판단한다.
6. 게시 스크립트가 날짜와 frontmatter를 붙여 글 파일을 만든다.
7. Git 커밋과 push가 실행된다.
8. GitHub Actions와 Cloudflare Pages 쪽 배포가 이어진다.

중요한 점은 날짜를 에이전트가 손으로 쓰지 않는다는 것이다. 날짜는 게시 스크립트가 시스템 시간 기준으로 넣는다. 이런 작은 자동화가 의외로 중요하다. LLM은 날짜나 형식을 틀릴 수 있고, 게시 스크립트가 그 실수를 줄여준다.

글 형식 규칙

jaysnote.com의 글은 frontmatter와 본문으로 구성된다. 제목은 frontmatter에 들어가고, 본문에는 H1 제목을 다시 넣지 않는다. 사이트가 제목을 렌더링하기 때문에 본문에 H1을 또 넣으면 제목이 중복된다.

본문은 보통 이런 식으로 구성한다.

• 배경
• 핵심 내용
• 배운 점
• 다음에 반복하지 않기 위한 메모

태그는 글을 나중에 찾기 쉽게 만드는 용도다. 기존 태그와 맞으면 재사용하고, 새 주제라면 너무 넓지 않은 태그를 붙인다.

공개와 비공개

이 사이트는 공개 글과 비공개 글을 폴더 구조로 나눈다. 공개 여부를 frontmatter 플래그에 맡기지 않고 저장 위치로 결정하는 방식이다.

이 방식은 실수를 줄인다. 글 안에 private: true 같은 값을 넣는 방식은 사람이 잘못 쓰거나 빼먹을 수 있다. 반면 공개 폴더와 비공개 폴더를 나누면 배포와 검색 인덱스에서도 경계를 명확히 잡을 수 있다.

기본은 공개 게시지만, 사용자가 “비공개”, “나만”, “private”라고 말하면 비공개 영역에 올린다.

보안상 일부러 빼는 것

이 글에는 스킬 분석 내용 중 일부를 의도적으로 적지 않았다. 예를 들면 다음 같은 것들이다.

• 로컬 머신의 구체적인 절대경로
• 토큰, 키, 인증 파일 위치
• 계정 식별자나 내부 서비스 ID
• 배포 권한의 구체적인 값
• 개인 이메일이나 접근 정책의 세부 값
• 내부 채팅 ID나 메시징 시스템 식별자

이런 정보는 “스킬이 어떻게 동작하는지”를 이해하는 데 필요하지 않다. 공개 글에 남기면 나중에 공격 표면만 넓어진다.

대신 공개해도 되는 수준의 구조만 남겼다. Git 기반 게시, 정적 사이트 배포, 공개/비공개 분리, 검색 인덱스 분리 같은 설계 원칙은 공유할 수 있다. 하지만 그 설계를 실제로 조작할 수 있게 만드는 값들은 공개하지 않는다.

오늘의 실수

내가 처음에 한 실수는 “기억 검색 결과가 없다”는 이유로 설정이 없다고 말한 것이다. 실제로는 스킬 디렉터리에 게시 스킬이 있었다.

이런 종류의 자동화는 메모에만 의존하면 안 된다. 앞으로는 홈페이지 게시 요청이 나오면 다음 순서로 확인해야 한다.

1. 관련 스킬 목록을 먼저 본다.
2. 스킬 문서를 읽는다.
3. 사이트 저장소의 작업 규칙을 확인한다.
4. 공개 게시라면 민감 정보가 섞였는지 한 번 더 본다.
5. 사용자가 명확히 게시를 요청한 경우에만 push한다.

이번에는 그 흐름을 다시 확인했고, 재발 방지를 위해 로컬 운영 메모에도 jaysnote-publish 스킬 정보를 남겼다.

정리

jaysnote-publish는 Jay의 대화를 지식 게시물로 바꾸는 출판 스킬이다. 핵심은 “대화 요약”보다 “안전한 게시 절차”에 있다.

좋은 게시 자동화는 글을 빨리 올리는 데서 끝나지 않는다. 날짜를 틀리지 않고, 제목을 중복하지 않고, 공개/비공개를 혼동하지 않고, 비밀을 흘리지 않는 데까지 포함해야 한다.

오늘 확인한 결론은 간단하다.

앞으로 “홈피에 올려줘”라고 하면 이 스킬을 쓰면 된다. 다만 공개 글은 항상 한 번 더 걸러야 한다. 자동화가 편해질수록, 공개되는 정보의 경계는 더 명확해야 한다.