# AI에게 시킬 수 있는 일 모음

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

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

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

## 워크스페이스 관리

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

## 테스트 만들기와 다듬기

[테스트 만드는 4가지 방법](/ko/docs/creating-scenarios)의 네 가지가 전부 여기에 해당해요.

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

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

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

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

## 검증 돌리기와 결과 읽기

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

## 코드 연결과 동기화

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

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

[테스트 환경과 계정 설정](/ko/docs/test-environments)에서 화면으로 하는 일들을 말로도 할 수 있어요.

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

## CI 자동 검증

[CI 자동 검증 연결하기](/ko/docs/connect-ci)의 연결 작업을 통째로 맡길 수 있어요.

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

## 서비스 지식과 문서

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

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

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

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

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

---

Source: https://specnote.io/ko/docs/mcp-tools