[사내AX] AI 도구가 늘어나니 사례글 쓰기가 어려워졌다 — 대화를 전부 모아오는 스킬로 업그레이드한 후기 - 2탄
2026.01.26
📝 한줄 요약
AI 코딩 도구를 3개(클로드코드, 안티그래비티, 오픈코드 등)나 쓰게 되면서 대화 기록이 흩어졌다. 사례글을 쓰려면 모든 대화가 필요했기에, 5개 도구의 세션을 한 번에 모아오는 스킬로 업그레이드했다.
🎯 이런 분들께 도움돼요
여러 AI 코딩 도구를 번갈아 쓰면서 작업 기록이 분산되는 게 불편한 분
사례글을 써야 하는데 막막한 분 -> 사례글 작성 스킬!
🧭 작업 순서 (요약)
Antigravity 설계: 멀티 도구 세션을 통합하는 구조 설계 + 구현 계획 작성
OpenCode 전수 조사: 5개 도구의 세션 저장 위치/형식 파악 (웹 검색 + 로컬 확인)
OpenCode 구현: 스킬에 멀티 도구 파싱 규칙과 프로젝트 단위 통합 규칙 추가, Antigravity는 내부 검색/외부 파싱 경로 분리
skill-creator 적용: 모놀리식 파일을 SKILL.md + references로 분리해 컨텍스트 효율 개선
😫 문제 상황 (Before)
이전에 write-post라는 스킬을 만들었다. Claude Code에서 작업한 대화 세션을 자동으로 파싱해서 개발 로그(DEVLOG)를 만들고, 그 로그를 바탕으로 비개발자 대상 사례 게시글까지 써주는 스킬이었다.
지난 사례글 먼저 보기
문제는, 점점 Claude Code 하나만 쓰지 않게 됐다는 것이다.
OpenCode도 쓰고, Antigravity도 쓰고 — 하나의 프로젝트를 여러 도구로 번갈아 작업하다 보니, 대화 기록이 세 곳에 흩어졌다. 사례글을 쓰려면 내가 뭘 시켰고 AI가 뭘 했는지 전체 맥락이 필요한데, 그 기록이 도구마다 따로 저장되어 있으니 하나의 DEVLOG로 뽑아낼 수가 없었다.
기존 스킬은 Claude Code 세션만 읽을 수 있었다. 매번 스킬을 2번씩 나눠 쓰는 것도 비효율적이었고, 도구가 늘어날수록 이 문제는 더 심해질 게 뻔했다.
🛠️ 사용한 도구
Antigravity: 범용화 아키텍처 설계, 구현 계획 수립
OpenCode: 멀티 도구 지원 계획 수립 + 구현 + 구조 개선
Claude Code: 이전 버전 (1탄) 개발에 사용
🔧 작업 과정
🧭 먼저 Antigravity에게 설계를 맡겼다
여러 도구의 세션을 모아오려면 아키텍처부터 짜야 했다. 각 도구가 저장하는 형식이 전부 다를 텐데, 이걸 어떻게 통합할지부터 결정해야 했다.
자동 Devlog 생성기 (Auto Devlog Generator)를 설계해줘Antigravity가 "Agent-Agnostic Context Extraction"이라는 이름의 아키텍처를 설계했다. 핵심은 환경을 자동 감지하고, 도구별로 다른 추출기를 돌리는 구조였다. 구현 계획서까지 아티팩트로 뽑아줬다.
설계는 Antigravity에게, 구현은 OpenCode에게 — 이렇게 역할을 나누니 효율적이었다.
🗂️ 5개 도구의 세션 저장 위치를 전수 조사했다
구현에 앞서 OpenCode에게 각 AI 코딩 도구가 대화 세션을 어디에, 어떤 형식으로 저장하는지 조사를 시켰다.
에이전트별 대화 세션 저장 위치를 파악해서, 사례 게시글 쓰는 스킬이 한 번에 모든 대화를 가져오도록 업데이트하고 싶어
OpenCode가 웹 검색과 로컬 파일 확인을 교차 검증하면서 5개 도구의 세션 구조를 전부 파악했다:
Claude Code: JSONL 파일 (프로젝트 경로를 폴더명으로 인코딩)
OpenCode: JSON 3단계 구조 (세션 → 메시지 → 파트)
Codex CLI: 날짜별 폴더에 JSONL
Gemini CLI: 프로젝트 해시 디렉토리에 JSON
Antigravity: 마크다운 아티팩트 + 암호화된 Protobuf
도구마다 저장 형식이 전부 달랐다. JSONL, JSON, 마크다운, 심지어 암호화된 바이너리까지. 이걸 하나의 스킬로 통합해야 했다.

🔒 암호화 벽에 부딪혔다 — 그리고 우회했다
가장 까다로웠던 건 Antigravity였다. 대화 원문이 담긴 .pb 파일이 Google 암호화 키 없이는 읽을 수 없었다.
OpenCode가 이 한계를 스스로 파악하고 대안을 제시했다 — Antigravity는 작업하면서 brain/ 폴더에 요약 문서(마크다운 아티팩트)를 자동으로 남기는데, 이걸 "대화 세션의 대리물"로 활용하자는 것이었다.
여기서 한 단계 더 나갔다. 추가 조사를 해보니, Antigravity Power User Guide에서 흥미로운 사실을 발견했다 — Antigravity 에이전트는 내부적으로 과거 대화를 검색하는 기능이 있었다. "지난주에 작업한 내용 찾아줘"라고 하면 이전 세션을 직접 참조할 수 있는 것이다.
결국 두 가지 경로를 모두 스킬에 반영했다:
Antigravity 내부에서 스킬 실행: 에이전트 자체 검색으로 과거 대화 직접 참조 (암호화 파일 포함)
다른 도구에서 Antigravity 세션 파싱:
brain/마크다운 아티팩트만 활용
🧩 skill-creator 스킬로 구조를 개선했다
멀티 도구 지원을 추가하다 보니 스킬 파일이 390줄이 넘어갔다. AI가 이걸 한 번에 읽고 이해해야 하는데, 너무 길어지면 컨텍스트 효율이 떨어진다.
이때 skill-creator라는 다른 스킬을 활용했다. 스킬을 잘 만드는 방법을 알려주는 스킬인데, 여기서 "Progressive Disclosure" 패턴을 적용했다 — 핵심 워크플로우만 담은 메인 파일(SKILL.md)과 필요할 때만 참조하는 보조 파일(references/)로 분리하는 구조다.
skill-creator 스킬의 가이드라인을 적용하여 write-post 스킬을 구조적으로 개선해줘392줄짜리 단일 파일이 SKILL.md(250줄) + references/case-study-template.md(140줄)로 깔끔하게 분리됐다. 스킬이 스킬을 개선하는 순간이었다.
✅ 결과 (After)
📊 Before vs After
항목 | Before | After |
|---|---|---|
지원 도구 | Claude Code 1개 | 5개 (Claude Code, OpenCode, Codex CLI, Gemini CLI, Antigravity) |
세션 수집 | 단일 도구만 파싱 | 프로젝트 단위로 모든 도구의 세션 자동 스캔 + 통합 |
스킬 구조 | 390줄 단일 파일 | SKILL.md(250줄) + references(140줄) Progressive Disclosure |
Antigravity 대화 | 읽기 불가 (암호화) | 내부 실행 시 자체 검색 가능 / 외부에서는 brain/ 아티팩트 활용 |
📎 결과물
GitHub 리포지토리: https://github.com/daht-mad/write-post
Mac/Windows 원클릭 설치 스크립트 (5개 도구 선택 설치)
프로젝트 단위 멀티 도구 세션 스캔 + 통합 DEVLOG 생성
여기서 중요!
어떤 도구에서 사례글을 쓰게 되더라도 각 환경에서 해당 스킬을 "스킬"로 인식할 수 있어야 했다
그래서 각 도구별 스킬이 저장되어야 하는 위치를 지정해주고, 각 경로에 스킬 폴더가 복제되게끔 했다

💬 이 과정에서 배운 점
✅ 효과적이었던 것
도구별 역할 분담: 설계는 Antigravity, 조사+구현은 OpenCode — 각 도구의 강점을 살려 분업하니 효율이 올랐다
AI에게 조사를 시키면 깊이 파준다: 5개 도구의 세션 구조, 암호화 여부, 우회 방법까지 웹 검색과 로컬 탐색을 교차 검증하며 찾아냈다
스킬이 스킬을 개선하는 구조: skill-creator 스킬의 가이드라인을 write-post 스킬에 적용해 구조를 개선한 경험
🚀 앞으로의 계획
팀원들에게 배포해서 실제 AX 사례글 작성에 활용하게 하고, 피드백을 받아 개선할 예정
현재 실사용한 도구는 Claude Code + OpenCode + Antigravity 3개이므로, 나머지 2개(Codex CLI, Gemini CLI)도 실제 테스트 진행 예정
로그인하고 댓글을 남겨 주세요
이갓 쓰려면 write-post 지워야하니요? 두개가 충돌할까요? 근데 설치한 스킬은 어떻게 지워요?
사례글 쓰는 법 특강 부탁해요
AI 잘 쓰지도 못하는 주제에 자꾸 외주를 주다보니 이제는 생각조차 하기 싫어졌어요
실제 사례를 써 보면서 느낀 점은 흥미로운 지점이 자꾸 생략되는 것 같더라구요. 그런데 사실 그런 부분을 알아서 잘 해주는 것도 불가능에 가깝다 싶기도 합니다.
그걸 좀 개선해보려고요!! 사실 흥미롭다기 보다는 좀 더 읽는 사람으로 하여금 배울 수 있는 지점들을 잘 도출하게끔 하려고 했어요. 이번에 누리님 사례 읽으면서 깃헙 액션이나 cloudflare 등 핵심 개념들이 중간중간 코드블럭으로 설명 삽입되면 좋겠다고 생각했어요.
태현님이 말씀하시는 '흥미로운 지점'의 예시가 어떻게 될까요?
@닿
누리님이 Kick 이라고 부르는 것, 사람들이 댓글 달때 우와 이거 신박해요 하는 것인데, 이걸 AI가 미리 파악하는게 쉽지 않아 보이긴해요.
예를 또 들면, Linear 데이터를 로컬 캐시에서 가져온것 정말 대박이잖아요.
뭔가 전통적인 방식과 직관을 벗어나는 하지만 더 효율적인 / 효과적인 접근 방법? 이 흥미로운 지점이지 싶습니다.
와, 이거 진짜 공감되는 문제를 멋지게 해결하셨네요! 👏
저도 여러 AI 도구를 번갈아 쓰다 보면 "내가 뭘 시켰더라?" 하고 기억이 흩어지는 경험이 있었는데, 그걸 스킬로 자동화해버리셨다니 대단합니다.
특히 인상 깊었던 부분:
"설계는 Antigravity, 구현은 OpenCode" - 도구별 강점을 살린 분업이 정말 스마트해요. AI도 적재적소에 배치하면 시너지가 나는군요.
암호화 벽을 만났을 때 "우회 경로"를 찾은 과정 - 막히면 포기하기 쉬운데, brain/ 폴더 아티팩트를 대리물로 활용한 발상이 👍
"스킬이 스킬을 개선하는 구조" - skill-creator로 write-post를 리팩토링한 건 정말 메타적이고 재밌네요 ㅋㅋ
GitHub 리포지토리 바로 북마크했습니다. 저도 사례글 쓸 때 활용해볼게요!
팀원분들 피드백 반영된 다음 버전도 기대됩니다 🙌
오오!! 역시 문제를 해결하는게 제일이네요!!
우리 회사에도 이런 자동화를 도입하고 싶다면
회사 업무에 맞춘 AI 교육을 함께 설계해요.




너무 좋아요~~ 윈도우용 부탁드려요~🙏💕
윈도우도 사용 가능해요! 이미 있어요!