Specnote
문서 홈으로
사용 가이드
Markdown 원문

AI에게 시킬 수 있는 일 모음

Specnote를 연결한 AI에게 어떤 일을 말로 시킬 수 있는지, 상황별 예시 문장과 함께 한눈에 정리했어요. 이 문서를 통째로 AI에게 읽혀 두면 더 잘 알아듣습니다.

Specnote를 내 AI에 연결해 두면, 아래 일들을 전부 말 한마디로 시킬 수 있어요. 도구 이름을 외울 필요는 전혀 없습니다 — 하고 싶은 일을 평소 말투로 적으면 AI가 알아서 맞는 도구를 골라 써요.

요령 하나: 이 문서 오른쪽 위의 Markdown 복사를 눌러 통째로 AI에게 붙여넣어 두면, AI가 Specnote로 할 수 있는 일을 더 정확하게 알아듣습니다.

워크스페이스 관리

이렇게 말해 보세요무슨 일이 일어나요
"내 Specnote 워크스페이스 목록 보여 줘"만들어 둔 워크스페이스를 조회해요
"'우리 쇼핑몰' 워크스페이스 만들어 줘"새 워크스페이스를 만들어요
"이 워크스페이스 한 줄 소개를 바꿔 줘"제목·소개를 고쳐요

테스트 만들기와 다듬기

테스트 만드는 4가지 방법의 네 가지가 전부 여기에 해당해요.

이렇게 말해 보세요무슨 일이 일어나요
"회원가입하면 환영 메일 오는지 테스트 만들어 줘"한 문장으로 테스트를 만들고, 실제 화면을 둘러보며 단계를 채워요
"이 기획 문서로 테스트 만들어 줘"문서를 서비스 지식으로 보관하고, 근거 삼아 테스트 초안을 만들어요
"방금 바꾼 파일들 기준으로 테스트 손봐 줘"바뀐 범위만 다시 실측해 테스트를 갱신해요
"코드 보고 어떤 테스트가 필요한지 제안해 줘"테스트 후보를 이유와 함께 제안하고, 고른 것만 만들어져요
"이 테스트 이름 바꿔 줘 / 단계 순서 바꿔 줘"테스트와 단계를 정리해요
"비슷한 테스트끼리 영역으로 묶어 줘"테스트를 영역별로 정리해요

검증 묶음 시작하기 — PRD 승인 플로우

새 검증 묶음(회차)은 사람이 승인한 검토안(PRD) 위에서만 시작돼요. AI에게 이렇게 부탁하면 됩니다.

이렇게 말해 보세요무슨 일이 일어나요
"이 워크스페이스 검증 묶음 시작해 줘"무엇을 어떤 규칙으로 검증할지 기획 검토안(PRD)을 정리해 보여줘요
"이 PRD 승인해 줘"내가 명시적으로 시켰을 때만 — 검토안을 대신 승인해 줘요 (결정은 사람 몫)
"승인된 PRD로 테스트 제출해 줘"승인된 검토안대로 테스트를 제출하고 첫 검증을 자동으로 돌려요

검증 돌리기와 결과 읽기

이렇게 말해 보세요무슨 일이 일어나요
"이 테스트 검증 돌려 줘"실제 브라우저로 검증을 시작해요
"전부 다시 검증해 줘"기존 묶음 자리에서 여러 테스트를 다시 검증해 통과율을 갱신해요
"마지막 검증 결과 알려 줘"통과·실패와 회차 리포트를 읽어 와요
"실패한 이유 분석해 줘"수정 리포트(어디서·왜·어떻게)를 받아 와요 — 그대로 수정까지 이어 시키면 돼요
"이 실패 고칠 방법 제안해 줘"실패 원인 기반의 수정 제안을 받아요

코드 연결과 동기화

이렇게 말해 보세요무슨 일이 일어나요
"지금 코드 Specnote로 보내 줘"비밀을 가린 코드를 보내요 (깃허브 미연결이거나 아직 안 올린 코드까지 반영하고 싶을 때)
"이번 변경이 어떤 테스트에 영향 주는지 분석해 줘"바뀐 부분과 맞닿은 테스트·단계를 짚어 줘요

테스트 환경·계정·시크릿

테스트 환경과 계정 설정에서 화면으로 하는 일들을 말로도 할 수 있어요.

이렇게 말해 보세요무슨 일이 일어나요
"테스트 환경 등록해 줘. 주소는 ○○○"테스트할 사이트 주소를 등록해요
"스테이징을 기본 환경으로 해 줘"기본 환경을 바꿔요
"테스트 계정 ○○○ 등록해 줘"검증이 로그인할 계정을 등록해요 (즉시 암호화 보관)
"이 테스트는 회원으로 검증해 줘"테스트의 로그인 여부(회원/방문자)를 정해요

CI 자동 검증

CI 자동 검증 연결하기의 연결 작업을 통째로 맡길 수 있어요.

이렇게 말해 보세요무슨 일이 일어나요
"이 저장소에 Specnote 자동 검증 연결해 줘"CI 전용 토큰을 발급하고 워크플로우 파일을 만들어 줘요
"CI 검증 상태 알려 줘"최근 CI 검증이 어떻게 됐는지 읽어 와요

서비스 지식과 문서

이렇게 말해 보세요무슨 일이 일어나요
"이 정책 문서 Specnote에 보관해 줘"기획·정책 문서를 워크스페이스의 밑바탕 지식으로 저장해요
"이 서비스가 어떤 서비스인지 정리해 줘"코드를 근거로 서비스 설명 초안을 만들어 줘요

AI가 못 하는 일 (사람만 하는 결정)

말로 다 시킬 수 있지만, 세 가지만은 사람이 화면에서 직접 정해요. 일부러 그렇게 만들어 두었습니다.

  • 검증 검토안(PRD) 승인 — 새 검증 묶음을 시작하기 전에 "무엇을 어떤 규칙으로 검증할지"를 확정하는 승인이에요. 이것만큼은 본인이 AI에게 "승인해 줘"라고 명시적으로 시키면 AI가 대신 눌러 줄 수도 있어요(그래도 결정은 사람 몫이에요).
  • 통과 조건 승인 — "무엇을 성공으로 볼지" 확정하는 승인은 사람만 할 수 있어요.
  • CI 포함 켜고 끄기 — 배포를 막을 수도 있는 기준이라, 사람만 정해요.

왜 이런 원칙인지는 검증은 어떻게 작동하나요에서 다뤄요. 연결이 아직이라면 내 AI 연결하기 (MCP 설치)부터 시작해 보세요.