Communitygithub.com

yingzhengzhang06-sys/requirement-clarifier

모호한 요청을 분석하고, 작업 우선순위를 정하며, 개선 방향을 제시하는 3가지 모드(Grow/Change/Improve)의 트라이지 스테이션입니다. 중국어 시나리오에 특화되어 있으며, 30개 이상의 Skill 라우팅 테이블을 포함합니다.

requirement-clarifier란 무엇인가요?

이 Skill은 '분진대(分診台)' 역할을 하는 AI 라우터입니다. 사용자의 모호한 아이디어나 작업 목록을 받아 '무엇을 원하는지(growme)', '어디서부터 시작할지(change)', '현재 계획을 어떻게 개선할지(improve)'라는 세 가지 본질적인 질문에 답합니다. Claude Code, Cursor 등 다양한 AI 에이전트 환경에서 사용할 수 있으며, Skill 자체는 어떤 작업도 직접 실행하지 않고, 분석 결과에 따라 적절한 실행 Skill로 라우팅하는 데 집중합니다. 30개 이상의 Skill 라우팅 테이블을 기반으로 사용자의 요청을 분석하여 가장 적합한 Skill을 추천하고, Grow→Change→Improve 순서로 직렬 연결하여 작업의 명확성과 효율성을 높입니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add yingzhengzhang06-sys/requirement-clarifier

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

요구사항 명확화 및 업무 분진 (Grow / Change / Improve)

한 줄 요약: 일단 손대지 마세요—손대기 전에 '사용자가 진짜 원하는 것, 복잡도, 시작점'이라는 세 가지 질문에 답하세요.

이것은 '분진대'입니다—영역을 가정하지 않고, 당신을 대신해 실행하지도 않습니다. 모호한 아이디어를 구조화된 요구사항으로, 작업 더미를 라우팅 가능한 실행 순서로, 기존 솔루션을 개선 가능한 목록으로 바꿉니다. 그런 다음 사용해야 할 다음 Skill을 명확히 지시하며, 스스로 작업을 수행하지는 않습니다.

이 Skill은 라우터로서, 사용자 질문에 따라 세 가지 하위 Skill로 분배합니다:

  • growme-mode — 요구사항 명확화 ('생각을 도와줘')
  • change-mode — 업무 분진 ('어느 것을 먼저 할까')
  • improve-mode — 구조 최적화 ('어떻게 고칠까')

핵심 포지셔닝

'어디서부터 시작해야 할지 잘 모르겠는' 요청은 모두 먼저 이 Skill을 거치도록 합니다. 세 가지 동작:

  1. 명확화 (growme): 모호한 아이디어를 실행 가능한 요구사항으로 변환
  2. 분진 (change): 작업 더미를 실행 순서로 정렬
  3. 개선 (improve): 기존 솔루션을 최적화 가능한 목록으로 전환

사용자의 세 가지 본질적인 질문에 답합니다:

  • 당신이 진짜 원하는 것은 무엇인가? (growme가 '요구사항 명세' 출력)
  • 어디서부터 시작해야 하는가? (change가 '실행 순서' 출력)
  • 지금 이대로 괜찮은가? (improve가 '개선점' 출력)

라우팅 분배 규칙

사용자 입력을 받은 후, 먼저 어떤 모드에 해당하는지 판단합니다 (다중 선택 및 직렬 연결 가능):

사용자 특징모드예시라우팅 대상
결과는 표현했지만 경로가 불명확함growme'AI 교육 Skill을 만들고 싶어요'growme-mode
정렬이나 선택이 필요한 여러 작업이 있음change'다듬어야 할 Skill이 8개 있어요'change-mode
기존 계획이 있지만 최적인지 확신하지 못함improve'이 SKILL.md가 제대로 작성되었는지 봐주세요'improve-mode

판단 원칙:

  • 대부분의 요청은 먼저 growme (명확화)를 수행한 후, change / improve를 직렬 연결할지 결정
  • 직렬 순서: growme → change → improve (무엇을 원하는지 먼저 파악한 후, 정렬하고, 계획 검토)
  • 현재 판단된 모드를 사용자에게 명확히 알리고 확인 또는 수정을 요청
  • 분진이 필요하지 않은 경우에는 '필요 없음'이라고 명확히 말하고, Skill을 억지로 사용하지 않음
  • 단일 대화 내에서 여러 모드가 관련될 수 있음—필요에 따라 직렬로 호출

자기 자신으로 라우팅하지 마세요: 분진 후에는 반드시 다른 실행 Skill을 가리켜야 하며, 'A를 완료한 후 requirement-clarifier로 명확화'하는 것을 허용하지 않음.


트리거 시나리오

강력 트리거 (직접 호출):

  • '생각을 도와줘 / 어떻게 해야 할지 모르겠어 / 아이디어가 있어' → growme-mode
  • '이 작업들을 어떻게 정렬하지? / 무엇을 먼저 할까? / 어떤 구현 경로가 있나? / 분진해줘' → change-mode
  • '어떻게 최적화하지? / 또 다른 문제는? / 이 계획을 봐줘 / 검토해줘' → improve-mode

약한 트리거 (컨텍스트에 '불확실함' 의미가 있을 때 호출):

  • 한 문장으로 된 요구사항 + 수용 기준 없음
  • 작업 더미 + 의존 관계 설명 없음
  • 기존 계획 + 사용자가 '뭔가 이상하다'고 표현
  • 팀 구성원 간 동일 목표에 대한 설명이 일치하지 않음

트리거하지 않음 (명확한 경계):

  • 정보가 완전히 명확함 → 바로 실행, Skill을 억지로 사용하지 마세요
  • 단일 명확한 소문제 ('X를 어떻게 사용하나요?') → AskUserQuestion로 직접 질문
  • 이미 구체적인 도메인 문제 ('프론트엔드 버튼을 어떻게 작성하나요?') → frontend-design / ui-ux-pro-max 등 도메인 Skill로 라우팅
  • 순수 작성 / 순수 번역 / 순수 생성 → original-writing / humanizer / content-rewrite로 라우팅

출력 형식 (라우터 관점)

모드 판단: growme / change / improve (조합 가능)

【growme】 → growme-mode 로드 (요구사항 명확화 실행)
【change】  → change-mode 로드 (업무 분진 실행)
【improve】 → improve-mode 로드 (구조 최적화 실행)

다음 단계 제안: [구체적으로 XX Skill로 라우팅 / 직접 실행 / 추가 명확화]

파일 구조 (본 키트)

requirement-clarifier/             ← 라우터 (현재 위치)
├── SKILL.md                       ← 본 파일: 라우팅 + 트리거 + 경계
├── growme-mode/                   ← 하위 Skill 1: 요구사항 명확화
│   ├── SKILL.md
│   └── references/
│       ├── seven-dimensions.md    ← 7대 질문 차원
│       ├── ask-question-toolkit.md ← AskUserQuestion 사용 팁
│       └── red-flags.md           ← 일반적인 잘못된 명확화 반례
├── change-mode/                   ← 하위 Skill 2: 업무 분진
│   ├── SKILL.md
│   └── references/
│       ├── complexity-rubric.md   ← 복잡도 판단 기준
│       ├── priority-matrix.md     ← P0/P1/P2/P3 매트릭스
│       ├── routing-table.md       ← 30+ Skill 라우팅 대조표
│       └── parallel-dependency.md ← 의존성 및 병렬 처리
├── improve-mode/                  ← 하위 Skill 3: 구조 최적화
│   ├── SKILL.md
│   └── references/
│       ├── seven-leverage-points.md ← 7가지 개선 포인트
│       ├── smart-criteria.md      ← SMART 원칙
│       └── red-flags.md           ← 잘못된 개선 반례
├── examples/                      ← 실제 사례
│   ├── fake-clarification.md      ← 잘못된 명확화 반례 샘플
│   ├── fake-triage.md             ← 잘못된 분진 반례 샘플
│   └── fake-improve.md            ← 잘못된 개선 반례 샘플
├── test-prompts.json              ← 6개의 라이브 테스트 샘플 + 자체 점검 질문
├── README.md                      ← 키트 소개 (하우스 스타일 템플릿)
├── LICENSE                        ← MIT
└── .claude-plugin/
    └── marketplace.json           ← plugin 이중 채널

연마 보고서는 精修skills/13-메타스킬과 거버넌스/연마 보고서/requirement-clarifier-打磨报告.md로 이동했습니다 (중앙 보관, 모든 Skill 연마 상황 확인 용이).


주의사항 (라우터 계층)

❌ 하지 말아야 할 일

  1. '대신 실행'하지 마세요—이 Skill은 '분진대'이지 '수술실'이 아닙니다. 명확화와 분진 완료 후 명확히 다음 실행 Skill을 가리킵니다
  2. '억지로 사용'하지 마세요—사용자 입력이 이미 충분히 명확하다면 확인만 하면 됩니다
  3. '도메인을 가정'하지 마세요—프론트엔드, 백엔드, 콘텐츠, 비즈니스 등 어떤 도메인도 가정하지 않습니다
  4. '자기 자신으로 라우팅'하지 마세요—분진 후 requirement-clarifier를 가리키지 않고, '분진→실행→검증' 사이클을 완성
  5. 'growme을 건너뛰고 바로 change'하지 마세요—작업 더미의 전제는 '무엇을 원하는지 이미 알고 있음'이며, 그렇지 않으면 먼저 명확화합니다
  6. '한 번에 5개 이상 질문'하지 마세요—5개 이상이면 핵심을 잡지 못하고 있다는 의미입니다
  7. '개선점이 7개 이상'이 되지 않도록—7개 이상이면 정렬하지 않고 나열하고 있다는 의미입니다

✅ 완료도 판단 기준

출력하기 전에 스스로에게 물어보세요:

'사용자가 이 출력을 가지고 바로 실행에 들어갈 수 있는가?'

  • 가능 → 완료
  • 불가능 → 어느 단계가 부족한가? 돌아가서 보완
  • 확실하지 않음 → '사용자가 XX를 확인한 후 실행'이라고 표시

하위 Skill 읽기 시점

  • growme 관련 요청 → growme-mode/SKILL.md + references/seven-dimensions.md 로드
  • change 관련 요청 → change-mode/SKILL.md + references/priority-matrix.md + references/routing-table.md 로드
  • improve 관련 요청 → improve-mode/SKILL.md + references/seven-leverage-points.md 로드
  • 완료도 자체 점검 → 본 파일의 주의사항 절 읽기

분량 및 구조

  • SKILL.md 본체 (라우터): ≤ 200줄 (현재 ~150줄, 기준 충족)
  • 하위 Skill SKILL.md: ≤ 250줄
  • 하위 Skill references/: 필요 시 로드, 주 컨텍스트에 넣지 않음
  • 총 골격 파일 수: ≤ 20개

관련 스킬