Codex Skill: Mission Completion Harness

모호하거나 여러 단계로 이어지는 요청을 Codex가 중간마다 멈추지 않고 끝까지 완수하도록 돕는 Codex skill입니다.

English version: README.en.md

왜 만들었나요?

AI coding agent를 쓰다 보면 이런 일이 자주 생깁니다.

이거 알아서 끝까지 해줘.
중간에 사소한 선택지 묻지 말고, 네가 판단해서 완성해줘.

그런데 실제 작업은 중간에 계속 갈라집니다.

• 어떤 기본값을 고를지
• 어느 정도까지 고칠지
• 어디에 상태를 남길지
• 어떤 검증을 할지
• 언제 사용자 확인을 받아야 할지

mission-completion-harness는 이 상황에서 Codex가 매번 “어떻게 할까요?”로 멈추지 않도록 합니다.

대신 안전한 기본값을 정하고, 실제 파일과 검증 결과를 만들고, 긴 작업이면 작은 goal state 파일에 현재 상태를 남기게 합니다.

이 스킬은 무엇인가요?

mission-completion-harness는 “질문을 절대 하지 않는 스킬”이 아닙니다.

핵심은 이겁니다.

• 질문이 필요한 것처럼 보여도 먼저 안전한 기본값을 고릅니다.
• 계획, 구현, 검증, 리뷰를 하나의 흐름으로 묶습니다.
• 긴 작업은 goal state 파일에 현재 목표와 다음 행동을 남깁니다.
• 가능한 검증을 실행한 뒤 완료를 말합니다.
• 보안, 결제, 공개 발행, 파괴적 변경처럼 사람 승인이 필요한 일은 멈춥니다.

즉, 사용자가 “끝까지 해줘”라고 했을 때 Codex가 더 오래 일할 수 있게 해주는 상위 실행 하네스입니다.

어떤 상황에서 쓰나요?

이런 요청에 잘 맞습니다.

• 여러 단계짜리 작업을 한 번에 끝내고 싶을 때
• 중간 선택지는 Codex가 보수적으로 판단해도 될 때
• 계획만 보고 끝나는 것이 아니라 실제 결과물까지 원할 때
• context가 길어질 수 있어서 현재 목표와 체크포인트를 남겨야 할 때
• “계속 물어보지 말고 네가 안전하게 판단해서 진행해”가 핵심일 때

이런 경우에는 멈춰야 합니다.

• 공개 게시, GitHub push, PR merge, production deploy
• 결제, 구독, 광고비 지출
• 비밀번호, 토큰, 2FA, 캡차
• 대량 삭제, 권한 변경, 되돌리기 어려운 명령
• 법률, 의료, 금융처럼 사용자의 명시 판단이 필요한 일

어떻게 작동하나요?

Codex가 이 skill을 읽으면 대략 이런 순서로 움직입니다.

1. 요청을 내부 brief로 좁힙니다.
2. 막히는 선택지가 있으면 안전한 기본값을 고릅니다.
3. 필요한 하위 skill을 최소한으로 고릅니다.
4. 실제 파일, 패치, 문서, 체크리스트 같은 첫 결과물을 만듭니다.
5. 긴 작업이면 goal state 파일을 만들거나 갱신합니다.
6. 테스트, lint, build, 링크 확인, 파일 존재 확인 같은 검증을 실행합니다.
7. 완료 상태와 남은 hard stop을 짧게 보고합니다.

빠른 예시

사용자 요청:

이 기능 끝까지 정리해줘. 중간에 사소한 선택지는 알아서 하고, 검증까지 해줘.

mission-completion-harness가 잡는 내부 기준:

Objective:
- 기능 정리, 구현, 검증까지 한 흐름으로 완료한다.

Success Criteria:
- 실제 파일 변경이 있다.
- 가능한 검증 명령을 실행한다.
- 남은 위험이나 사용자가 직접 확인해야 할 일을 마지막에 남긴다.

Default Decisions:
- 기존 코드 스타일을 따른다.
- 범위는 가장 작게 잡는다.
- 되돌리기 쉬운 변경을 우선한다.

긴 작업이면 이런 goal state 파일을 남길 수 있습니다.

# Mission Goal

## Objective
- <완료할 목표 한 문장>

## Success Criteria
- <검증 가능한 완료 조건>

## Budget
- Time: this turn
- Scope: smallest useful change
- Risk: stop before public, destructive, or payment actions

## Status
- active

## Checkpoint
- Done: source inspected
- Current: implementation
- Next: verification

## Resume Rule
- continue from the latest checkpoint before making new assumptions

더 자세한 예시는 examples/before-after.md를 보세요.

설치 방법

이 저장소를 받은 뒤 mission-completion-harness/ 폴더를 Codex skills 폴더로 복사합니다.

mkdir -p ~/.codex/skills
cp -R mission-completion-harness ~/.codex/skills/mission-completion-harness

Git으로 계속 관리하고 싶다면 symlink로 연결할 수도 있습니다.

mkdir -p ~/.codex/skills
ln -s /path/to/codex-skill-mission-completion-harness/mission-completion-harness ~/.codex/skills/mission-completion-harness

Codex에 바로 보이지 않으면 Codex를 다시 시작해 보세요.

사용 방법

Codex에서 명시적으로 호출합니다.

$mission-completion-harness

또는 이렇게 말해도 됩니다.

이 작업 mission-completion-harness로 끝까지 완수해줘.
중간 선택지는 네가 안전한 기본값으로 정하고, 검증까지 해줘.

한국어로는 이렇게 요청해도 됩니다.

임무완수 하네스로 끝까지 해줘.
공개 게시나 위험한 단계만 내 확인을 받고, 나머지는 네가 판단해서 진행해줘.

내 방식에 맞게 커스터마이징하기

이 repo에는 Codex가 읽을 수 있는 커스터마이징 가이드가 들어 있습니다.

• CUSTOMIZE_WITH_CODEX.md
• AGENTS.md

이 repo를 Codex에서 열고 이렇게 말해 보세요.

Read CUSTOMIZE_WITH_CODEX.md and help me adapt mission-completion-harness for my own workflow.

한국어로는 이렇게 요청해도 됩니다.

CUSTOMIZE_WITH_CODEX.md를 읽고, 내 작업 방식에 맞게 mission-completion-harness를 커스터마이징해줘.
수정 전에 어떤 기본값과 hard stop을 바꿀지 먼저 계획을 보여줘.

파일 구조

mission-completion-harness/
  SKILL.md
  agents/openai.yaml
examples/
  before-after.md
CUSTOMIZE_WITH_CODEX.md
AGENTS.md
CONTRIBUTING.md
PUBLIC_RELEASE_HANDOFF.md
scripts/security-scan.sh

먼저 바꿔볼 만한 곳

내 workflow에 맞게 바꾸고 싶다면 mission-completion-harness/SKILL.md에서 아래 섹션부터 보면 됩니다.

• When to use
• Core Flow
• Goal State File
• Hard Stop Gates
• Default Decision Rules
• Output Contract

공개 안전성

이 repo에는 아래 항목을 넣지 않는 것을 원칙으로 합니다.

• API key
• token
• 비밀번호
• 개인 로컬 경로
• 사내/고객 정보
• 특정 개인 프로젝트에만 맞는 비공개 지시

라이선스

MIT