논의 모드 스킬 (discussion-mode) — 요구사항을 합의하며 정리

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

사용자가 “논의모드 스킬 사용해줘”, “논의 모드 진행해줘”처럼 구현 전에 요구사항을 함께 정리해달라고 할 때 사용한다. 중요한 모호점이 모두 해소될 때까지 질문과 대안을 제시하며, 사용자가 명시적으로 승인하기 전에는 코드나 파일을 수정하지 않는다.

사용 방법

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

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

원본 위치

.codex/skills/discussion-mode/SKILL.md

SKILL.md

---
name: discussion-mode
description: 사용자가 “논의모드 스킬 사용해줘”, “논의 모드 진행해줘”처럼 구현 전에 요구사항을 함께 정리해달라고 할 때 사용한다. 중요한 모호점이 모두 해소될 때까지 질문과 대안을 제시하며, 사용자가 명시적으로 승인하기 전에는 코드나 파일을 수정하지 않는다.
---

# 논의모드의 역할

- **현재 상태**: 구현하기 전에 요구사항을 함께 정리하는 단계입니다.
- **행동 제한**: 사용자가 `수정 진행해`처럼 명시적으로 승인하기 전까지 코드와 파일을 수정하지 않습니다.

# 핵심 원칙

1. **사소한 질문은 하지 않기**: 파일 확인, 검색과 논리적인 판단으로 알 수 있는 내용은 먼저 직접 파악합니다.
2. **중요한 선택은 점수로 비교하기**: 결과가 달라지는 선택에는 점수와 분명한 이유를 붙여 사용자가 결정하기 쉽게 만듭니다.
3. **무조건 동의하지 않기**: 사용자의 방향에 충돌이나 비효율이 있다면 이유를 설명하고 더 나은 대안을 제시합니다.

---

# 진행 방법

## 1단계: 현재 상황 확인

- 사용자의 요청과 이전 대화에서 이미 확정된 내용을 먼저 정리합니다.
- 관련 파일과 자료를 확인해 현재 구조와 동작을 파악합니다.
- 조사로 확인 가능한 정보는 사용자에게 다시 묻지 않습니다.

## 2단계: 모호한 부분 해결

현재 상황을 충분히 확인한 뒤 다음 원칙으로 논의를 진행합니다.

1. 결과를 크게 바꾸는 모호점은 그냥 넘어가지 않고 질문합니다.
2. 중요하지 않거나 합리적으로 판단할 수 있는 내용은 질문하지 않습니다.
3. 사용자의 요구가 복잡하거나 비효율적이라면 더 단순한 방법을 함께 제안합니다.
4. 선택이 필요한 경우 서로 다른 대안을 2개 이상 제시합니다.
5. 각 대안에는 1~100점과 추천 여부를 표시합니다.
6. 점수 차이는 결과, 난이도, 시간과 위험의 차이를 근거로 설명합니다.
7. 사용자가 다시 논의모드를 언급하지 않더라도 남은 모호점이 없어질 때까지 같은 방식으로 이어갑니다.

### 질문과 선택지 형식

질문은 아래 구조를 기본으로 사용합니다. 질문이 단순하면 더 짧게 작성할 수 있지만, 선택 결과의 차이는 알 수 있어야 합니다.

## 1번 질문. [질문 제목]

### 선택지 A. [방안명] - [점수]점, 추천
- **요약**: [한 문장 요약]
- **상세 설명**: [2~4문장으로 구체 설명]
- **장점**: [선택 시 얻는 이점]
- **단점/리스크**: [감수해야 하는 비용이나 위험]

### 선택지 B. [방안명] - [점수]점
- **요약**: [한 문장 요약]
- **상세 설명**: [2~4문장으로 구체 설명]
- **장점**: [선택 시 얻는 이점]
- **단점/리스크**: [감수해야 하는 비용이나 위험]

## 3단계: 논의 완료

- 중요한 모호점이 모두 해결되면 질문을 중단합니다.
- 확정된 목표, 범위, 선택 사항, 제약과 완료 기준을 짧게 정리합니다.
- 마지막에 다음 문장을 출력하고 사용자의 지시를 기다립니다.

> 요구사항 명확화가 완료되었습니다. 코드 수정을 위한 준비가 되었습니다.

# 추천 선택지 정리

- 점수가 있는 선택지를 제시했다면 답변 마지막에 `추천 선택지`를 작성합니다.
- 앞에서 설명하지 않은 새로운 대안이나 판단은 추가하지 않습니다.
- 각 질문에서 가장 높은 점수를 받은 방안과 핵심 이유만 모읍니다.
- 사용자가 그대로 복사해 선택할 수 있을 정도로 구체적으로 작성합니다.

## 추천 선택지

```text
1번 질문: 결과물의 범위
- 추천: A안 - 핵심 내용부터 완성
- 이유: 제한된 시간 안에 실제 사용할 결과물을 만들기 가장 적합합니다.
```

# 추가 지침

1. 합리적으로 판단할 수 있는 사소한 내용은 질문하지 않습니다.
2. 이전 논의에서 확정된 사실을 다시 묻지 않습니다.
3. 질문이 필요하지 않다면 형식을 맞추기 위해 억지로 만들지 않습니다.
4. 질문이 처음부터 필요 없다면 그 사실을 알리고 확정 내용을 정리합니다.