이온디

plan-skill는 반복 업무를 더 안정적으로 처리하기 위한 AI 에이전트 스킬입니다.

사용자가 “플랜 스킬 사용해줘”, “구현 계획을 세워줘”, “수정 전에 작업 순서를 정리해줘”라고 요청할 때 사용한다. 현재 상태와 확정된 요구사항을 조사해 실행 가능한 계획을 만들며, 이 단계에서는 파일을 수정하지 않는다.

사용 방법

Codex나 호환되는 AI 에이전트의 스킬 폴더에 아래 SKILL.md 내용을 저장한 뒤, 설명에 포함된 트리거 문장으로 호출하세요.

사용 예:
plan-skill 스킬 사용해줘.
이 작업은 plan-skill 기준으로 진행해줘.

원본 위치

.codex/skills/plan-skill/SKILL.md

SKILL.md

---
name: plan-skill
description: 사용자가 “플랜 스킬 사용해줘”, “구현 계획을 세워줘”, “수정 전에 작업 순서를 정리해줘”라고 요청할 때 사용한다. 현재 상태와 확정된 요구사항을 조사해 실행 가능한 계획을 만들며, 이 단계에서는 파일을 수정하지 않는다.
---

# Plan Skill

## 목적

- 확정된 요구사항을 실제로 실행할 수 있는 작업 순서로 바꾼다.
- 수정 전에 영향 범위와 완료 기준을 확인해 시행착오를 줄인다.
- 다음 작업자가 계획만 보고도 무엇을 왜 바꾸는지 이해할 수 있게 한다.

## 절대 규칙

- 이 스킬에서는 코드와 파일을 수정하지 않는다.
- 관련 자료와 현재 상태를 조사한 뒤 계획을 작성한다.
- 중요한 요구사항이 미확정이면 계획을 추측해서 채우지 않는다.
- 사용자가 요청하지 않은 기능, 리팩터링과 확장을 계획에 넣지 않는다.
- 계획의 상세함은 작업 규모와 위험에 맞춘다. 작은 수정에 과도한 절차를 만들지 않는다.

## 진행 순서

### 1. 목표와 확정 사항 정리

- 사용자가 얻으려는 결과를 한 문장으로 정리한다.
- 이전 논의에서 확정된 범위, 제약과 완료 기준을 모은다.
- 프로젝트나 작업 폴더에 지침 문서가 있다면 우선 확인한다.

### 2. 현재 상태 조사

- 관련 파일, 데이터, 문서와 기존 패턴을 확인한다.
- 새 파일이 필요한지 기존 파일을 확장하면 되는지 판단한다.
- 다른 영역에 영향을 줄 수 있는 연결 지점을 확인한다.
- 실제로 존재하지 않는 파일, 명령과 모듈을 계획에 넣지 않는다.

### 3. 모호점 확인

- 계획을 달라지게 만드는 미확정 사항이 있다면 질문한다.
- 질문은 꼭 필요한 것만 번호를 매겨 제시한다.
- 선택이 필요하면 2~3개의 대안과 1~100점, 추천 근거를 제공한다.
- 조사로 확인할 수 있는 내용이나 중요하지 않은 선호는 묻지 않는다.

### 4. 실행 계획 작성

계획에는 다음 내용을 포함한다.

1. **목표**: 무엇을 해결하고 어떤 결과를 만들지
2. **영향 범위**: 사용자가 보게 될 변화와 유지해야 할 기존 동작
3. **변경 파일**: 각 파일을 왜 수정하거나 추가하는지
4. **작업 순서**: 의존 관계를 고려한 구체적인 단계
5. **확인 방법**: 결과가 완료되었다고 판단할 테스트와 수동 확인
6. **주의점**: 실제 가능성이 있는 위험이나 되돌리기 어려운 작업

## 계획 작성 기준

- 작업 단계는 행동이 명확한 문장으로 작성한다.
- 각 단계는 가능하면 하나의 책임만 갖게 한다.
- 단순한 작업은 3~6단계 정도로 짧게 작성한다.
- 복잡한 작업은 필요한 만큼 나누되 우선순위와 선행 조건을 표시한다.
- 테스트는 작업 위험에 비례해 제안한다. 모든 작업에 같은 수준의 테스트를 강제하지 않는다.
- 외부 배포, 데이터 삭제, 권한 변경처럼 되돌리기 어려운 작업은 별도로 표시한다.
- 기존 구조의 문제가 이번 작업을 직접 방해할 때만 리팩터링을 제안한다.

## 출력 예시

```text
목표
- 사용자가 요청한 결과를 한 문장으로 설명

변경 파일
- path/to/file: 어떤 책임을 수정하는지

작업 순서
1. 현재 데이터를 읽는 부분을 정리합니다.
2. 화면에 필요한 상태를 연결합니다.
3. 오류와 빈 상태를 처리합니다.
4. 관련 테스트와 실제 화면을 확인합니다.

완료 기준
- 핵심 동작이 정상적으로 실행됨
- 기존 관련 기능이 유지됨
```

계획이 완성되면 사용자가 실행 여부를 명확하게 선택할 수 있도록 다음 행동을 안내한다.