AgentSkillsCN

0

操作指南 第0步:明确问题。首先界定为何要开展这项工作。

SKILL.md
--- frontmatter
description: "how-to-work 0단계: 문제 정의. 왜 이 작업을 하는지 정의한다."
allowed-tools: Edit, Write, Read, AskUserQuestion, Bash, Glob, Grep

0단계: 문제 정의 — "이걸 왜 하는가?"

이터레이션 초기화

  • 현재 버전: !cat docs/work/.current 2>/dev/null || echo "NO_CURRENT"
  • 기존 파일: !cat docs/work/$(cat docs/work/.current 2>/dev/null)/0-problem-definition.md 2>/dev/null || echo "NO_FILE"

지시사항

이 단계의 목적은 왜 이 작업을 하는지 명확히 정의하는 것이다.

초기화

  • docs/work/ 디렉토리가 없으면 docs/work/v0/ 디렉토리를 생성하고 docs/work/.current 파일에 v0를 기록한다.
  • 기존 파일이 있으면 이어서 진행한다.

진행 방식

  1. 스킬 시작 즉시 현재 버전 디렉토리의 0-problem-definition.md 파일을 산출물 파일 형식 템플릿으로 생성한다. 기존 파일이 있으면 이어서 진행한다.

  2. 사용자에게 아래 질문을 인터뷰 형식으로 한다. 한 번에 모든 질문을 던지지 말고, 대화하며 진행한다.

    • 왜 이걸 만드는가?
    • 누가 사용하는가?
    • 지금 무엇이 불편한가?
    • 성공하면 무엇이 달라지는가?
    • 실패하면 어떤 문제가 남는가?
  3. 각 질문의 답변을 받을 때마다 즉시 파일의 해당 섹션을 업데이트한다. 다음 질문으로 넘어가기 전에 파일에 반영한다.

  4. 모든 질문이 끝나면, 답변을 종합하여 문제 정의 문장 1~2줄을 작성한다.

    • 형식: "현재 XXX는 YYY 때문에 ZZZ가 불가능하다."
    • 이 문장을 사용자에게 보여주고 합의를 구한다.
  5. 합의된 문제 정의 문장을 파일 상단에 기록한다.

산출물 파일 형식

markdown
# 0단계: 문제 정의

## 문제 정의
> (합의된 1~2줄 문장)

## 상세

### 왜 만드는가?
(답변)

### 누가 사용하는가?
(답변)

### 지금 무엇이 불편한가?
(답변)

### 성공하면 무엇이 달라지는가?
(답변)

### 실패하면 어떤 문제가 남는가?
(답변)

주의사항

  • 사용자의 답변을 임의로 해석하거나 추가하지 않는다.
  • 불명확한 답변이 있으면 반드시 되물어서 명확히 한다.
  • 각 질문의 답변을 파일에 기록한 후, 기록 내용을 사용자에게 보여주고 확인을 받는다. 확인 전에 다음 질문으로 넘어가지 않는다.
  • 이 단계가 완료되면 "다음 단계: /tf:1로 목표를 정의하세요." 라고 안내한다.