Community이미지github.com

Envision

실제 장소 사진을 바탕으로 리모델링, 재장식, 또는 상상 속 공간을 시각화합니다. 이미지, 폴더, 핀터레스트, 스타일 이름 등에서 영감을 받아 취향 프로필을 구축하고, 공간별로 실제 사진에 렌더링 버전을 생성하며 사용자와 반복 작업하여 최종 이미지를 확정합니다.

Envision란 무엇인가요?

Envision은 사용자가 실제 공간(집, 방, 정원, 테라스, 사무실, 상점 등)의 사진을 바탕으로 리모델링이나 재장식 아이디어를 시각화할 수 있도록 도와주는 AI 에이전트 스킬입니다. 사용자가 제공하는 다양한 형태의 영감(이미지, 폴더, 핀터레스트 보드, 스타일 이름, 텍스트 등)을 수집하여 프로젝트별 취향 프로필(taste.md)을 만들고, 선택적으로 무드 보드를 통해 시각적 검증을 거칩니다. 그런 다음 실제 사진 위에 가구 유무 등 다양한 버전의 렌더링을 생성하고, 사용자와의 반복적인 피드백을 통해 최종적으로 몇 장의 이미지를 확정합니다. 이 스킬은 Claude Code, Codex 등 다양한 플랫폼에서 사용할 수 있으며, 이미지 엔진은 플러그 앤 플레이 방식으로 설계되어 OpenAI API, 수동 모드 또는 추후 추가되는 어댑터를 쉽게 연결할 수 있습니다. 프로젝트는 로컬 폴더 구조로 관리되며, doctor.sh 스크립트가 사용 가능한 엔진을 자동으로 감지하여 사용자가 선택할 수 있도록 합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/dtazi/envision/tree/HEAD

Installed? Explore more 이미지 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

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

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

문서

Envision은(는) 무엇을 하나요?

사용자(의뢰인)와 당신(플래너) 사이의 작업 루프를 통해 실제 장소가 어떻게 변할 수 있는지 확인합니다. 가볍게 유지하세요: 이 도구는 사용과 함께 성장하도록 설계되었습니다. 사용자가 다른 것을 원할 때는 이 파일이 아닌 사용자를 따르세요. 이 내용은 규칙이 아닌 기본값입니다.

아래 경로는 이 스킬의 폴더(<skill>) 기준이며, 이 파일을 읽은 위치에서 찾을 수 있습니다.

0. 프로젝트 열기 또는 시작하기

  • 현재 폴더에 project.md가 있으면 그것이 프로젝트입니다: project.md, taste.md, 그리고 진행 중인 공간의 log.md를 읽고 중단된 지점부터 작업을 재개합니다.
  • 그렇지 않으면 프로젝트 이름을 묻고 다음 구조로 폴더를 생성합니다 (기본값 ~/Envision/<project>/ 또는 사용자가 지정한 위치). 필요한 부분만 생성합니다:
<project>/
  project.md        # 장소 설명, 엔진 선택, 공간 및 상태, 결정사항
  taste.md          # 작성된 취향 프로필 (사용자 검증 필요)
  inspiration/      # 사용자가 제공한 모든 자료: 이미지, 압축 해제된 폴더, links.md, 노트
  moodboard/        # 선택 사항, 취향 검증용
  place/            # 평면도, 지도, 전체 장소 개요 사진 (있는 경우)
  spaces/<space>/
    originals/      # 해당 공간의 실제 사진
    prompts/        # 렌더링별 프롬프트 파일
    renders/        # 출력물
    log.md          # 각 라운드: 요청사항, 생성물, 사용자 반응

project.md는 <skill>/templates/project.md로 시작하세요.

1. 도구 연결 (프로젝트 첫 번째 사용 시 또는 요청 시)

<skill>/scripts/doctor.sh를 실행합니다. 이 스크립트는 해당 머신에서 사용 가능한 이미지 엔진을 나열합니다. 목록을 일반 언어로 사용자에게 보여주고 선택하도록 합니다. 선택 사항을 project.md에 기록합니다. 사용자가 원하는 엔진이 준비되지 않은 경우, 설정 과정을 안내합니다 (각 어댑터의 헤더에 필요한 사항이 명시되어 있습니다). 비밀 값은 절대 묻거나 출력하지 마세요: 키는 사용자 자신의 셸 환경에 저장됩니다.

플래너는 당신이며, 이 스킬을 연 앱(Claude Code, Codex 등)이 무엇이든 상관없습니다. 프로젝트 페이지를 유지하기 위한 Notion 또는 다른 공간은 선택 사항입니다: 사용자가 원하고 사용 가능한 커넥터가 있다면 브리핑, 취향, 검증된 이미지를 미러링하되, 로컬 폴더가 진실의 원천(source of truth)으로 유지됩니다.

2. 취향 이해하기

사용자가 제공하는 모든 것을 어떤 형태로든 가져옵니다: 채팅의 이미지, zip 파일이나 폴더, 핀터레스트 보드 또는 핀, 링크, 명명된 스타일 ("스페인 아시엔다", "자판디"), 음성 메모, 일반 텍스트. 자료를 inspiration/에 저장합니다. 모든 이미지를 살펴보고, 링크의 경우 접근 가능한 내용을 읽고 접근할 수 없었던 부분을 명확히 말합니다.

<skill>/templates/taste.md를 기반으로 taste.md를 작성합니다: 한 줄 요약, 반복적으로 등장하는 요소 (재료, 색상, 조명, 가구, 식물, 분위기), 사용자가 공간에서 생활하는 방식 (사용자의 말에서), 원하지 않는 것, 그리고 열린 질문들. 각 주장을 출처와 연결합니다 (예: "테라코타 바닥: 이미지 40장 중 6장 + 사용자 발언"). 그런 다음 사용자에게 수정을 요청합니다. 이 파일은 살아있는 파일입니다: 라운드 진행 중 새로운 것을 배울 때마다 업데이트합니다 ("흰색 소파를 계속 거절함").

3. 무드 보드 (선택 사항)

제안하되, 사용자가 취향을 시각적으로 검증하려는 경우에만 수행합니다. 사용자가 요청한 것을 충족하는 가장 저렴한 방법을 선택합니다: 자신의 이미지나 핀 선택 (무료), 볼 링크 (무료), 또는 생성된 이미지 (비용/할당량 발생: 먼저 알림). 결과를 moodboard/에 저장하고, 사용자가 검증하거나 거절한 내용을 taste.md에 기록합니다.

4. 장소

평면도, 지도 또는 전체 사진 세트가 있다면 place/에 저장하고 project.md에 공간 목록과 그 연결 관계를 작성하여, 방 전체에서 일관된 버전(동일한 바닥재, 동일한 팔레트)이 유지되도록 합니다. 그렇지 않으면 사용자가 보내는 사진을 기준으로 공간별로 작업합니다. 각 공간에 대해 spaces/<space>/를 생성하고 원본 사진을 originals/에 넣습니다. 첫 번째 렌더링 전에 실제로 있는 것(벽, 개구부, 바닥, 천장, 조명, 보존할 가치가 있는 것)을 설명하여 사용자가 수정할 수 있도록 합니다.

5. 라운드

사용자가 무언가를 요청합니다 ("테라스 버전 4개, 가구 없이", "같은데 바 추가"). 각 버전에 대해:

  1. 프롬프트를 spaces/<space>/prompts/<render-name>.txt에 작성합니다. 사용자의 요청과 taste.md에서 시작하고, 도움이 될 때 0-5개의 영감 이미지를 스타일 참조로 전달합니다. 버전이 실제 장소를 유지해야 하는 경우 프롬프트에 명시적으로 언급합니다: 동일한 벽, 개구부, 비율, 카메라 각도 및 프레임; 움직이면 안 되는 것(나무, 계단)을 지정합니다. 변경되는 것과 변경되지 않는 것을 말합니다.
  2. 기본 이미지를 선택하고 사용자에게 알립니다: 장소에 충실하기 위해 실제 사진을 사용하거나, 사용자가 마음에 들어 한 이전 렌더링을 사용합니다. 큰 변경은 일반적으로 실제 사진으로 돌아가고, 작은 조정은 렌더링 위에 구축할 수 있습니다.
  3. 렌더링: <skill>/scripts/render.sh <engine> --base <img> --prompt <file> --out <png> [--ref <img>]... (독립적인 버전은 병렬로 실행 가능). 렌더링 이름은 정렬되고 내용을 알 수 있도록 지정합니다 (예: r2-03-no-furniture-bar.png).
  4. 각 결과를 보여주기 전에 직접 확인합니다. 실제 장소와 다른 점(카메라 이동, 나무 사라짐)을 정직하게 말합니다. 이미지를 채팅으로 보냅니다.
  5. 라운드를 log.md에 기록합니다: 요청, 각 렌더링의 기본 이미지, 참조 이미지, 프롬프트 파일 및 관찰 내용, 그리고 사용자의 반응.

사용자가 반응합니다: "이건 유지, 저건 제거, 이 두 개가 마음에 들어, 이것들 위주로 더 만들어 봐". 이를 다음 라운드에 반영합니다 (취향에 관한 내용이면 taste.md에도 반영). 사용자가 몇 개의 이미지를 검증할 때까지 계속합니다. 검증된 이미지는 log.md에 validated로 표시하고 project.md에 나열한 후, 다음 공간이나 해당 공간의 다음 부분으로 이동합니다.

엔진

모든 엔진은 동일한 계약(contract)을 따르는 <skill>/engines/ 디렉토리의 실행 파일 하나입니다 (engines/README.md 참조). 새로운 엔진(다른 API, 로컬 모델, 수동으로 구동되는 웹 앱 등)을 추가하려면 해당 디렉토리에 파일을 추가하기만 하면 됩니다. 다른 것은 변경되지 않습니다.

관련 스킬