프롬프트 도감 › No.565
AI 도우미 자동화 공통 뼈대 만들기
Build: Agent Ops Skeleton
어떤 채널에서든 다시 쓰는 운영 뼈대예요. AI에 도구를 붙이는 연결(MCP) 4개, 자동 실행 규칙 3개, 스케줄러 템플릿, 승인 단계, 작업 기록 양식이 들어 있어요. 유튜브·인스타·블로그·스레드 구축 프롬프트는 이 위에 올라가요.
이럴 때 모든 자동화의 공통 기반
도구 Claude Code · Codex · Cursor
프롬프트
너는 시니어 자동화 엔지니어다. 어떤 채널 파이프라인이든 그 위에 올릴 수 있는 '에이전트 운영 골격'을 이 저장소에 만들어라. 콘텐츠 생성은 하지 말고 뼈대만. 구성: 1. .mcp.json — filesystem, github, playwright(@playwright/mcp), fetch 를 등록하고, 이 프로젝트 전용 MCP 서버(Python, mcp 패키지) 하나를 만들어 도구 4개를 노출: run_job(name), read_receipts(days), link_check(urls), deploy(target, branch). deploy 는 branch=main 이면 환경변수 ALLOW_MAIN_DEPLOY=1 없이는 거부. 2. .claude/settings.json 훅 — PreToolUse(Bash): 본배포·force push 차단 / PostToolUse(Bash): 명령 로그 / Stop: 오늘 영수증이 없으면 알림. 3. 스케줄러 — dagu DAG 템플릿(jobs/_template.yaml)과 launchd plist 템플릿. 모든 잡은 resource-guard(부하·메모리 admission) 뒤에서 돌고, 로그는 프로젝트 안에 남긴다. 4. 모델 라우팅 — 기계적 작업은 로컬 Ollama 먼저, 실패·한도 시 클라우드로. 쿨다운 파일로 같은 공급자를 반복 호출하지 않는다. 5. 승인 게이트 — approve/<id>.txt 파일이 있을 때만 게시·배포. 승인 없이 올라간 게 없는지 검사하는 스크립트. 6. 영수증 — receipts/<날짜>-<작업>.md 규격과 생성 함수. 증거는 URL·HTTP 코드·파일 경로. 7. README — 새 채널 파이프라인을 붙이는 방법(어댑터 인터페이스: plan() / produce() / publish(approved) / receipt()). 산출물: 위 7개 파일 세트와, 도구가 실제로 호출되는 것을 보여주는 첫 실행 영수증. 공통 규칙: - 먼저 저장소를 훑고 가정을 3줄로 말한 뒤, 폴더 구조와 실행 순서를 계획으로 보여주고 내 승인을 받아라. 승인 전에는 파일을 만들지 마라. - 모든 비밀값은 .env 에서 읽고, 코드·로그·영수증에 절대 찍지 마라. .env.example 을 만들어라. - 게시(업로드)는 기본적으로 '초안/비공개' 상태로 올리고, 공개 전환은 --publish 플래그 또는 승인 파일(approve/<날짜>.txt)이 있을 때만 한다. - 매 실행 끝에 receipts/<날짜>-<작업>.md 를 남겨라: 바뀐 것 / 증거(URL, HTTP 코드, 파일 경로) / 건너뛴 것 / 되돌리기. - 실패하면 같은 작업을 반복하지 말고 pending 으로 기록하고 멈춰라. - 실제로 돌려본 것만 '완료'라고 말해라. 계정 승인·OAuth 동의·앱 심사처럼 사람이 해야 하는 단계는 '사람이 할 일' 목록으로 따로 적어라.
팁
- 자동화 키트(990원)에 같은 구성이 완성본으로 들어 있어요. 프롬프트로 직접 만들거나 키트를 설치하면 돼요.
- 자동 실행 규칙과 MCP 양쪽에서 본 배포를 막아야 한쪽이 실수해도 다른 쪽이 잡아 줘요.
- 기록(영수증)이 없는 실행은 안 한 것으로 본다는 규칙을 팀에 알려 두세요.
출처
권리: 도감 원작. 자유롭게 복사·수정해 쓰세요 (출처 표기 환영).