Community코딩 & 개발github.com

RafaelFerSilva/refinement-agent-skills

사용자 스토리를 테스트 관점에서 검토하고 테스트 계획 기준(조건, 선언된 기법, 위험 수준, 테스트 레이어, 자동화 차단 요소, 지정된 수신자별 질문)을 게시합니다.

refinement-agent-skills란 무엇인가요?

이 스킬은 사용자 스토리를 소크라테스식 검토(Socratic examination)를 통해 분석하여 QA(테스트) 관점에서 검증 가능한 테스트 계획 기준을 도출합니다. 주어진 명세에서 직접 도출된 조건 (`[SPECIFIED]`), 테스트 설계 기법을 적용한 조건 (`[DERIVED]`), 명세가 불명확하여 질문이 필요한 조건 (`[UNDEFINED]`)으로 구분하여 테스트 매트릭스를 구성합니다. 각 조건은 위험도 우선순위와 테스트 레이어(단위, 통합, E2E 등)가 할당되며, PO(제품 책임자)와 DEV(개발팀) 대상 질문을 별도로 관리하여 의사결정 지연을 최소화합니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 AI 에이전트 플랫폼에서 동작하며, `docs/agents/refinement.md`에 정의된 운영 모드(코드 유무)와 언어 설정을 따릅니다. 코드 모드에서는 DEV 질문을 코드베이스 분석을 통해 직접 해결하고, 무코드 모드에서는 설문지를 통해 DEV 팀에 질문을 전달합니다. 최종 산출물은 TEMPLATE.md 형식의 테스트 계획, Gherkin 시나리오, 자동화 감사, 회귀 영향 분석, 남은 질문 목록을 포함합니다. 핵심 가치는 '숨겨진 결함을 드러내는 것'으로, 모든 테스트 조건은 명시적인 출처(명세 인용, 설계 기법 이름, 질문 번호)를 가져야 하며, 출처를 알 수 없는 조건은 계획에 포함되지 않습니다. 이 스킬은 스토리의 명세가 불완전할 때 체계적으로 질문을 생성하고 우선순위를 지정하여 QA 엔지니어가 바로 실행할 수 있는 실용적인 테스트 기준선을 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/RafaelFerSilva/refinement-agent-skills/tree/HEAD/skills/qa-plan

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

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

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

문서

QA 계획

사용자 스토리에 대한 기준 테스트 계획을 소크라테스식 검토를 통해 도출합니다: 선언된 설계 기법이 있는 테스트 조건, 명세가 뒷받침할 때만 단언되는 예상 결과, 그리고 나머지를 해결할 수 있는 사람에게 전달되는 질문. "이 스토리가 잘 작성되었나요?"라고 묻지 않습니다. 그것은 /refine-story의 역할입니다. 당신이 답할 것은: 무엇이 깨질 수 있는가, 어떻게 작동함을 증명할 것인가, 그리고 그 증명을 실행하기 위해 무엇이 존재해야 하는가입니다.

중급 QA 엔지니어는 이 결과물에서 직접 테스트를 구현할 수 있어야 하며, 선임 QA 엔지니어는 그 우선순위에 동의할 수 있어야 합니다.

US: $ARGUMENTS

3계층 경계

문서화되지 않은 조건을 도출하는 것은 QA의 핵심이며, 정해진 방법을 따르는 경우에만 가능합니다. 따라서 여기서의 경계는 세 계층에 걸쳐 운영됩니다. 기본은 requirements-rigor로 유지됩니다. 계획의 모든 조건은 정확히 하나의 계층에 속합니다:

  • [SPECIFIED: excerpt] (pt-BR: [ESPECIFICADO: trecho]): 조건과 예상 결과가 텍스트에서 직접 비롯됩니다. 출처를 인용하세요.
  • [DERIVED: technique] (pt-BR: [DERIVADO: técnica]): 조건은 명세된 내용에 적용된 테스트 설계 기법에서 비롯됩니다. 항상 기법 이름을 명시하십시오. 선언된 기법이 없는 조건은 추측이며 포함되어서는 안 됩니다. 예상 결과는 명세에서 논리적으로 도출될 때만 단언할 수 있습니다.
  • [UNDEFINED -> Question n] (pt-BR: [INDEFINIDO → Pergunta n]): 명세가 예상 결과를 정의하지 않은 정당한 조건입니다. 조건은 매트릭스에 포함됩니다. 결과는 번호가 매겨진 질문이 됩니다.

빠른 테스트: "이 조건은 어떤 기법에서 생성되었으며, 어떤 발췌문에서 비롯되었습니까?" 둘 중 하나라도 답할 수 없으면 계획에서 제외하십시오.

시작 전

작업 공간에서 docs/agents/refinement.md 파일을 읽으십시오: 운영 모드(코드 유무), 언어(en-US 또는 pt-BR, 기본값 en-US), 게시 경로를 정의합니다. 모드는 아키텍처 질문에 누가 답변하는지를 결정합니다. 코드 모드에서는 코드베이스를 검사하여 해결하고, 무코드 모드에서는 엔지니어링 팀이 설문지를 통해 해결합니다. 소크라테스식 검토와 QA 계획은 설정된 언어로 작성됩니다. 파일이 없으면 /configure-refinement을 요청하고 중단하십시오.

단계

  1. 로드. US, CONTEXT.md, 도메인 ADR, TEST-DESIGN.md를 읽고 requirements-rigor에 대한 Skill 도구를 호출하십시오. /refine-story에서 .scratch/<slug>/spec.md 파일이 존재하면 그것부터 시작하십시오: 해당 세션의 결정이 이미 많은 질문에 답변합니다. 이 파일이 없으면 US를 정제되지 않은 것으로 처리하십시오. Status:가 READY로 표시되어 있어도 마찬가지입니다. 완료 조건: 테스트 가능성 트라이지가 한 줄로 명시됨: TESTABLE(모든 예상 결과에 관찰 지점이 있고 보류 중인 종속성이 확인됨), TESTABLE WITH RESERVATIONS(조건은 도출 가능하지만, 적어도 하나의 결과에 관찰 지점이 없거나 확인되지 않은 종속성에 의존함), 또는 NOT TESTABLE.

  2. 트라이지. NOT TESTABLE(기준이 관찰 가능한 동작을 설명하지 못함: 모든 기준에 걸쳐 측정 항목 없이 전적으로 작업 또는 주관적 용어로만 구성됨): 무엇이 누락되었는지 설명하고, 3~5개의 최소 질문을 나열하고, /refine-story를 권장하십시오. 여기서 중단하십시오. 테스트 불가능한 자료를 분석하면 겉치레 계획만 생성됩니다. US가 정제(refinement)를 거치지 않은 경우 이를 명시하고 진행하되, 많은 질문이 /refine-story로 해결될 수 있다고 언급하십시오. 완료 조건: 트라이지가 선언됨.

  3. 조건 도출. 각 기준에 대해 TEST-DESIGN.md에서 적용 가능한 기법을 적용하고, 부적합한 기법을 강제로 적용하지 말고, 침묵하는 각도를 검토하여 적용 가능한 것만 보고하십시오. 매트릭스를 구축하십시오: 조건, 출처, 예상 결과 또는 [UNDEFINED -> Question n], 우선순위, 계층. 정의되지 않은 조건은 매트릭스에 남습니다: 보이는 미래 커버리지는 숨겨진 격차보다 훨씬 낫습니다. PO와 DEV를 통합하여 단일 시퀀스로 질문에 번호를 매기십시오. [UNDEFINED -> Question n]이 명확하게 해결되도록 합니다. 우선순위 근거(조건당 반 줄)는 테이블 내부가 아니라 위험 분석 섹션의 목록에 들어갑니다. 완료 조건: 모든 조건이 선언된 출처를 가지고 모든 [UNDEFINED]에 할당된 질문 번호가 있음.

  4. 질문하기 전에 사실을 검색하십시오. 수신자별로 질문을 분리하십시오. PO: 정의되지 않은 비즈니스 동작. DEV: 아키텍처, 관찰 가능성, 테스트 계층, 외부 종속성 격리, 시간 제어, 테스트 데이터 프로비저닝, API 오류 응답, 장애 후 지속성, 기술적 멱등성. 코드 모드에서는 하위 에이전트를 파견하여 코드를 읽음으로써 DEV 질문에 답변하십시오: 알림이 동기식인가 비동기식인가? 승인에 대한 잠금이 있는가? 외부 시스템에 대한 목(mock)이 존재하는가? 발견된 사실은 출처 인용과 함께 예상 결과 또는 정의된 계층이 됩니다. 무코드 모드에서는 검색이 하위 에이전트 없이 작업 공간 파일로 제한됩니다. 아무것도 발견되지 않으면 1차 라운드 상단에 한 줄로 명시하십시오. 완료 조건: 각 질문이 출처에 의해 답변되었거나 열려 있음으로 표시되고, 할당된 수신자가 있음.

  5. PO 검토. socratic-examination에 대한 Skill 도구를 호출하십시오. 질문 라운드는 현재 매트릭스와 함께 제공됩니다. 질문이 특정 조건을 참조하기 때문입니다. 프론티어는 PO 질문으로 구성되며, 차단 항목(P1 조건을 해제하는 항목)이 먼저 오고, 각각 명세가 근거를 제공할 때 권장 답변이 제공됩니다. 근거가 없으면 "권장 사항 없음"(또는 pt-BR에서 "sem recomendação")과 옵션을 제공하십시오. PO 답변은 즉시 매트릭스를 업데이트합니다. 용어를 용어집과 대조하여 검증하되, PO가 해결한 내용만 CONTEXT.md에 기록하십시오. 완료 조건: PO 질문 프론티어가 비어 있거나 PO가 종료를 요청함.

  6. 종합. TEMPLATE.md에 따라 계획을 작성하십시오: 매트릭스, 위험 분석, 자체 감사가 포함된 Gherkin 형식의 P1 시나리오, 자동화 가능성 감사, 기존 시스템 문서(컨텍스트가 없으면 DEV에 영향 질문을 나열)에 엄격히 기반한 회귀 영향, 수신자별 남은 질문, 커버리지 평결. 완료 조건: docs/agents/refinement.md에 정의된 경로에 최종 고지 사항이 포함된 파일이 존재함.

  7. 미해결 항목 라우팅. 무코드 모드의 미해결 DEV 질문과 답변되지 않은 PO 질문: requirements-rigor의 QUESTIONNAIRE.md에 따라 수신자별로 하나의 설문지를 작성하고, 계획과 함께 게시하며, 미해결 질문에서 파일을 연결하십시오. 완료 조건: 수신자 또는 설문지가 없는 미해결 질문이 없음.

  8. 보고. 평결, 계획이 게시된 위치, 실행 가능한 P1 조건의 수, 각 설문지가 해제하는 내용.

최종 고지 사항

⚠️ 이 출력은 테스트 계획의 분석 기준선을 제공하며, 최종 테스트 계획이 아닙니다. 커버리지, 우선순위 지정, 노력에 대한 결정은 QA 팀에 속하며, PO(정의되지 않은 동작) 및 Dev(아키텍처 및 계층)의 검증을 받습니다.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

관련 스킬