interview-spec

📁 october-academy/agent-plugins 📅 Today
0
总安装量
1
周安装量
安装命令
npx skills add https://github.com/october-academy/agent-plugins --skill interview-spec

Agent 安装分布

codex 1
claude-code 1

Skill 文档

SPEC.md 작성을 위한 심층 인터뷰

저는 스펙 문서인 SPEC.md 작성을 위해 인터뷰를 진행합니다. 모든 질문은 AskUserQuestion 도구를 사용해 사용자를 인터뷰하는 방식으로 진행합니다.

인터뷰 원칙

질문은 뻔하거나 상투적이지 않아야 하며, 단순한 요구사항 수집이 아니라 다음을 포함하는 매우 심층적인 접근이어야 합니다:

  • 서비스 기획: 무엇을 만들려 하는가, 왜 이것이 필요한가
  • 사용자 문제: 누가 어떤 상황에서 어떤 고통을 겪는가
  • 핵심 가치: 이 서비스가 제공하는 본질적 가치는 무엇인가
  • 기능 범위: 무엇을 포함하고 무엇을 명시적으로 제외하는가
  • 기술적 선택: 어떤 기술/아키텍처를 선택하며 ê·¸ 이유는 무엇인가
  • 제약사항: 시간, 예산, 인력, 기술적 한계는 무엇인가
  • 우려 사항: 실패 가능성, 리스크, 걱정되는 부분은 무엇인가
  • 트레이드오프: 어떤 것을 포기하고 어떤 것을 얻는가

인터뷰 진행 기준

  1. 한 번에 3-4개 질문만 제시하여 인터뷰의 밀도를 유지합니다.

  2. 답변이 모호하거나 추상적이면 구체적 사례, 맥락, 판단 근거를 요구하며 깊이를 확보합니다.

    • “구체적인 예를 들어주세요”
    • “그렇게 판단한 근거는 무엇인가요?”
    • “실제 상황에서 어떻게 동작해야 하나요?”
  3. 숨겨진 가정, 암묵적 결정, 책임 소재가 불분명한 부분은 그대로 두지 말고 반드시 드러내세요.

    • “~라고 가정하셨는데, 그게 아닌 경우는 어떻게 되나요?”
    • “이 결정은 누가 내리나요?”
    • “이 부분의 책임자는 누구인가요?”
  4. 인터뷰의 목적은 “좋은 아이디어”가 아니라 명시적 결정과 ê·¸ 근거를 남기는 것입니다.

종료 조건

인터뷰는 다음이 충족될 때까지 종료하지 않습니다:

  • 핵심 기능과 범위가 명확히 정의됨
  • 주요 기술적 결정이 근거와 함께 확정됨
  • 중요한 트레이드오프가 명시됨
  • 불확실한 항목이 [TBD]로 식별되어 나중에 결정할 것임이 합의됨

출력: SPEC.md 작성

인터뷰가 충분히 완료되었다고 판단되면, 지금까지의 모든 인터뷰 내용을 반영하여 구조화된 스펙 문서 SPEC.md를 파일로 작성합니다.

SPEC.md 필수 포함 항목

# [프로젝트명] 스펙 문서

## 1. 개요
- 프로젝트 목적
- 해결하려는 문제
- 핵심 가치 제안

## 2. 사용자 정의
- 주요 사용자 페르소나
- 사용자의 핵심 니즈와 페인 포인트

## 3. 기능 범위
### 3.1 포함 범위 (In Scope)
- [기능 목록]

### 3.2 제외 범위 (Out of Scope)
- [명시적으로 제외된 항목]

## 4. 기술적 결정
- 선택한 기술/아키텍처
- 선택 근거
- 고려했으나 선택하지 않은 대안과 그 이유

## 5. 제약사항
- 시간/일정 제약
- 예산/리소스 제약
- 기술적 제약

## 6. 트레이드오프
- [결정]: [얻는 것] vs [포기하는 것]
- 결정 근거

## 7. 리스크 및 우려사항
- 식별된 리스크
- 완화 방안 (있는 경우)

## 8. 미결정 항목 [TBD]
- [항목]: [결정 필요 시점] - [결정권자]

작성 원칙

  • 인터뷰를 통해 도출된 모든 핵심 결정 사항 포함
  • 명시적으로 합의된 범위와 제외 항목 명확히 구분
  • 주요 트레이드오프와 선택의 근거 기록
  • 불확실하거나 미결정인 항목은 [TBD] 또는 **[미정]**으로 명시