[AI] 반자동 Blog 포스팅 시스템 만들기(3) - 정해진 시간에 맥북을 깨우는 goguma 시스템 도입! 문제 해결 완료

 

클라우드 환경으로 변경하려던 찰나,
잠자는 맥북을 깨우는 도구에 대해 알게되었다.
지금 나에게 딱 필요한 도구!
활용하여 문제를 해결해보자.

 

 

 

 

[ 포스팅 시스템 만들기 1 ]

[AI] 반자동 Blog 포스팅 시스템 만들기(1) - Codex의 예약 작업 활용하기

 

 

 

[ 포스팅 시스템 만들기 2 ]

[AI] 반자동 Blog 포스팅 시스템 만들기(2) - OpenAPI와 GitHub 클라우드 기반으로 변경

 

 

 

[ Goguma ]

GitHub - s3onghyun/bulchimbeon: 🪖 불침번 — Your Mac's night-watch soldier. Keeps your Mac awake only while AI agents wor

 

 

 

[ GitHub ]

GitHub - hyeong-ing/ai-blog: 공식 자료 조사와 팩트체크를 바탕으로 한국어 AI 블로그 초안을 만드는 Cod

 

 

 

[ 네이버 블로그]

Beyond today. What's next? : 네이버 블로그

 

 

 

---

 

 

 

 

1.  동작 흐름

화면

 

현재 시스템은 Mac의 전원 관리와 Codex의 글 작성 예약이 각각 작동하는 구조다. 이 프로그램은 블로그에 글까지 업로드 해주는 것이 아닌, 잠들어 있는 Mac을 깨워 Codex 예약 작업을 실행하는 프로그램이다.

 

시각	동작	담당
07:20	잠든 Mac 깨우기	goguma + macOS 전원 예약
07:20 - 08:20	작업 도중 잠들지 않도록 유지	macOS 예약 서비스 + Python 프로그램 + goguma
07:30	AI 블로그 주제 조사와 초안 작성	Codex 일일 자동화
08:20	아침 작업용 잠자기 방지 해제	Python 프로그램
08:20 직후	사용 상태 확인 후 조건부 잠자기	별도의 MacOS 예약 서비스

 

 

 

---

 

 

 

2. goguma 

goguma는 스킬 파일이 아닌, Mac의 깨우기와 잠자기 방지를 담당하는 오픈소스 도구로 적용되어 있다. 즉, Codex가 글을 작성할 시간에 Mac을 사용할 수 있도록 만드는 역할이다.

현재 프로젝트의 본래 목적은 AI 생태계의 변화를 조사하고 블로그 초안을 꾸준히 만드는 것이다. 그런데 Codex가 오전 07:30 예약을 등록하더라도, Mac이 잠들어 있으면 정해진 시간에 작업할 수 없다 이를 해결하기 위해 글 작성 자동화에 전원 관리 기능을 연결했다.

 

• goguma가 하는 일
  1) 작업 전에 잠든 Mac 깨우기
  2) 작업 중 Mac이 다시 잠들지 않도록 유지하기
  3) 유지가 끝나면 잠자기 방지 해제하기
  
  goguma는 먼저 작업 환경을 준비한다. 오전 07:20이 되면 Mac을 깨운다. goguma에 ai-blog-morning-wake라는 예약을 등록했다. 내부 설정은 오전 7:21을 작업 시각으로 두고 1분 먼저 깨우도록 했다. 그래서 macOS에 등록되는 실제 깨우기 시각은 07:20이다.
  
  다음으로 07:20 - 08:20까지 잠자기 방지이다. Mac이 깨어나면 macOS 예약 서비스가 morning-power.py를 실행한다. goguma run은 연결한 프로그램이 실행되는 동안 Mac이 깨어있도록 유지한다. 기다리는 프로그램이 08:20에 끝나면 goguma도 잠자기 방지를 해제한다.
  
  여기서 아쉬운 점은 글을 쓰는 작업이 미리 끝나도 8시 20분까지 유지하도록 만든 것이다. 이렇게 한 이유는 테스트를 더 많이 진행해야하고 될지 안될지 알 수 없었기 때문에 일단 이런 방식으로 프로그램이 돌아가도록 만들었다. 이 부분은 나중에 수정해야할 부분 중 하나이다.
  
  08:20이 되면 잠자기를 별도의 프로그램이 담당한다. goguma의 잠자기 방지 해제는 이제 Mac이 잠들어도 된다는 의미이지, 정확한 시간에 실제 잠자기로 전환하는 것까지 보장하지는 않는다. 그래서 별도의 08:20 예약을 추가했다. 
  
  1) 최근 5분 이내 사용자 입력이 있는가?
  2) 다른 앱이 잠자기를 막고 있는가?
  3) 사용 상태를 정상적으로 확인할 수 있는가?
  
  사용 중이거나 상태를 확인하지 못하면 그날의 자동 잠자기를 건너뛴다. 조건이 충족될 때만 macOS에 잠자기를 요청한다. 
  
  Codex 전용 goguma 스킬을 설치해 연결한 구조가 아니다. goguma의 예약 기능과 CLI를 직접 만든 시간 관리 프로그램에 연결한 구조이다.
  
  
  
• 발생했던 문제
  초기에는 JSON 파일로 goguma에 예약을 알려주고 Codex가 완료 상태를 기록하도록 시험했다. JSON을 이용한 깨우기는 성공했지만, goguma의 완료 감지 연결에서 문제가 발생했다. 
  
  그래서 현재는 완료 감지 방식 대신 고정된 아침 시간대를 유지하는 방식으로 선택했다. 이 프로그램은 Codex로 만들었다. AI는 설정한 목표가 안되면 목표 자체를 수정하기보다 목표를 수행하는 방법을 바꾼다. 그래서 이렇게 계속 안되면 인간이 생각하든, AI와 더 대화를 해보든, 목표 자체를 수정하는 방향으로 검토하는 것도 좋은 방법인 듯 하다. 

 

 

 

---

 

 

 

 

3. 현재 동작 방식 (파일, 폴더, Skill 별로)

 

• 파일·폴더

README.md	프로젝트 소개, 시작 방법, 전체 구성 안내
AGENTS.md	Codex가 지켜야 할 공통 규칙. 주제 선정·정확성·게시 금지 원칙
.gitignore	원고·조사 자료·로그·인증 정보 등의 업로드 제외
prompts/daily-run.md	매일 Codex가 읽고 수행하는 작업 순서
scripts/morning-power.py	7:20~8:20 잠자기 방지 유지와 8:20 사용 상태 확인·잠자기 처리
config/morning-power/README.md	전원 예약 설치 위치·설정·로그 확인·중지 방법
local.ai-blog.morning-awake.plist.example	7:20에 전원 유지 프로그램을 실행하는 macOS 예약 예시
local.ai-blog.morning-sleep.plist.example	8:20에 조건부 잠자기 프로그램을 실행하는 예약 예시

 

 

• 블로그 작성 Skill 
  .agents/skills/에 아래의 스킬이 있습니다.

topic-research/SKILL.md	기존 글 중복 확인, 새 주제 선정, 공식 자료 조사
community-research/SKILL.md	실제 사용자 경험과 반응 조사
fact-check/SKILL.md	주장별 사실 확인과 작성 가능 여부 판단
blog-writer/SKILL.md	검증 자료로 한국어 본문과 SEO 메타데이터 작성
search-visibility-review/SKILL.md	검색 가독성·요약·제목·근거 연결 검토

 

 

• 글 작성 기준과 결과물 보조 파일

guidelines/topic-policy.md	어떤 주제를 고를지 판단하는 기준
guidelines/source-policy.md	출처 우선순위, 인용·검증·조사 기록 방법
guidelines/editorial-guide.md	한국어 문체와 편집 기준
guidelines/search-visibility-policy.md	SEO·AEO·GEO 검토 기준
guidelines/image-policy.md	이미지 필요성·권한·배치·자리 표시 기준
templates/	blog-post.md는 본문 골격, review-checklist.md는 게시 전 검토표
topics/	candidates.md는 후보·초안 이력, published.md는 실제 게시 이력. 공개 저장소에는 빈 양식 제공
skill-staging/	정식 Skill이 없을 때 참고하는 대체 사본. .agents/skills/가 우선

 

 

• 결과물을 만들고 검사하는 코드

scripts/render-preview.mjs	완성된 Markdown을 읽기 좋은 HTML로 변환
scripts/prepare-images.mjs	이미지 계획을 읽어 가이드와 설명용 SVG 생성
scripts/validate-workspace.py	파일 구조, Skill 형식, 본문·SEO·조사 자료 연결 검사
scripts/test-preview.mjs	HTML 변환과 위험한 내용 차단 검사
scripts/test-images.mjs	이미지 생성·권한 처리·원본 보존 검사
scripts/vendor/marked/	HTML 변환에 사용하는 Markdown 라이브러리와 라이선스·출처