MyWork Agent

GitLab 커밋 기반의 업무 관리 도우미 VS Code 확장 프로그램입니다. AI를 활용하여 커밋 내역을 분석하고 업무 문서를 자동으로 생성해줍니다.

주요 기능

1. 커밋 분석 및 업무 문서 생성

선택한 커밋들의 메시지와 변경사항(diff)을 AI가 분석
업무명, 업무 상세(목표, 핵심 결과), 기대 결과, 작업 흐름을 자동으로 추출
Mermaid 다이어그램을 활용한 작업 흐름 시각화
직관적인 로딩 화면으로 분석 진행 상황 확인
- 단계별 분석 과정 표시 (커밋 데이터 수집, 코드 변경사항 분석, 업무 요약 생성)
- 예상 소요 시간 안내

2. 커밋 관리

기간, 작성자 기반의 커밋 필터링
- 작성자 아이디(ID) 기준 검색 지원
- 내 커밋만 보기 기능
- 커밋 메시지 검색
다중 커밋 선택 기능
커밋 상세 정보 조회
GitLab에서 커밋 직접 보기

3. 위키 연동

분석된 업무 내용을 위키 페이지로 자동 생성
마크다운 형식의 문서 자동 포맷팅
클립보드 복사 기능

설치 방법

VS Code 마켓플레이스에서 'MyWork Agent' 검색
설치 버튼 클릭
VS Code 재시작 또는 Command Palette(Cmd/Ctrl + Shift + P)에서 'Developer: Reload Window' 실행

설치 후 반드시 VS Code 창을 리로드해야 확장 프로그램이 정상적으로 활성화됩니다.

사용 방법

초기 설정

GitLab 토큰 설정

1. Command Palette (Cmd/Ctrl + Shift + P) 열기
2. 'MyWork: GitLab 토큰 설정' 실행
3. '새 GitLab 서버 토큰 추가' 선택
4. GitLab 서버 URL 입력 (예: https://gitlab.example.com)
5. 액세스 토큰 입력

OpenAI API 토큰 설정

1. Command Palette에서 'MyWork: GitLab 토큰 설정' 실행
2. 'OpenAI 토큰 설정' 선택
3. OpenAI API 토큰 입력

위키 설정 (선택사항)

1. Command Palette에서 'MyWork: GitLab 토큰 설정' 실행
2. '위키 설정' 선택
3. 위키 서버 URL, 계정 정보, 상위 페이지 ID 입력

기본 사용법

프로젝트 선택
- 좌측 액티비티 바의 MyWork 아이콘 클릭
- 여러 Git 저장소가 있는 경우 프로젝트 선택 가능
- 프로젝트는 상위 폴더명 기준으로 그룹화되어 표시
- 각 프로젝트의 원격 저장소 URL 확인 가능
커밋 필터링 및 선택
- 필터 아이콘을 클릭하여 조회 조건 설정
  - 날짜 범위 설정 (YYYY-MM-DD 형식)
  - 작성자 선택 (아이디 기준 검색)
  - 커밋 메시지 검색
  - 내 커밋만 보기 (토글)
  - 조회할 커밋 개수 설정 (1-100)
- 커밋 목록에서 분석할 커밋들 선택
- 각 커밋은 클릭으로 선택/해제
- 커밋 항목에서 GitLab 링크 아이콘 클릭시 브라우저에서 열기
업무 분석
- 선택된 커밋이 있을 때 상단의 분석 버튼 클릭
- 분석 중에는 직관적인 로딩 화면 표시
  - 단계별 진행 상황 확인 가능
  - 예상 소요 시간 안내 (약 10-20초)
- AI가 커밋을 분석하여 업무 문서 생성
  - 업무명: 핵심 임팩트를 한 줄로 표현
  - 목표: 주요 변경사항 1-2줄 요약
  - 핵심 결과: 실제 코드 변경사항 기반 정량적 지표
  - 기대 결과: 변경사항의 실제 영향도
  - 작업 흐름: Mermaid 다이어그램으로 시각화
- 생성된 문서는 미리보기 패널에 표시
문서 활용
- '클립보드에 복사' 버튼으로 문서 내용 복사
- '위키 하위 페이지로 저장' 버튼으로 위키에 등록
- 마크다운 형식으로 포맷팅된 문서 활용

설정 옵션

설정	설명	기본값
myworkAgent.gitlabTokens	GitLab 서버별 토큰 설정	{}
myworkAgent.openaiToken	OpenAI API 토큰	-
myworkAgent.openaiModel	사용할 AI 모델	gpt-4o-mini
myworkAgent.commitsLimit	조회할 최근 커밋 수	20
myworkAgent.wikiHost	위키 서버 URL	-
myworkAgent.wikiUsername	위키 접근 계정	-
myworkAgent.wikiPassword	위키 접근 비밀번호	-
myworkAgent.wikiParentId	상위 위키 페이지 ID	-

필요 권한

GitLab 토큰 권한

api: API 접근
read_api: API 읽기
read_repository: 저장소 읽기
read_user: 사용자 정보 읽기

토큰 생성 방법:

GitLab > Preferences > Access Tokens 접속
토큰 이름 입력 (예: MyWork Agent)
만료일 설정 (선택사항)
위 권한들 체크 후 생성
생성된 토큰을 서버 URL과 함께 설정

※ URL은 반드시 프로토콜(https://)을 포함해야 합니다.

VS Code 권한

workspace 읽기/쓰기
클립보드 접근

지원 환경

VS Code 1.89.0 이상
GitLab CE/EE
Node.js 20.x

라이센스

이 프로젝트는 GNU General Public License v3.0을 따릅니다.

자세한 내용은 LICENSE 파일을 참조하세요.

문제 해결

문제가 발생하면 다음 단계를 확인해보세요:

확장 프로그램 활성화 확인
- 설치 후 VS Code 창을 리로드했는지 확인 (Cmd/Ctrl + Shift + P로 'Developer: Reload Window' 실행)
- 확장 프로그램 목록에서 MyWork Agent가 활성화되어 있는지 확인
- 활성화 문제가 지속되면 VS Code를 완전히 재시작해보기
GitLab 토큰 설정 확인
- 서버 URL이 프로토콜(https://)을 포함하는지 확인
- 토큰이 필요한 모든 권한을 가지고 있는지 확인
- 토큰이 만료되지 않았는지 확인
Git 저장소 확인
- 프로젝트 폴더가 유효한 Git 저장소인지 확인
- GitLab 원격 저장소가 올바르게 설정되어 있는지 확인
- git remote -v 명령어로 원격 저장소 URL 확인
커밋 목록 조회 문제
- 프로젝트가 올바르게 초기화되었는지 확인
- 필터 설정을 초기화해보기
- 새로고침 버튼으로 목록 갱신

MyWork Agent

juunone

MyWork Agent

주요 기능

1. 커밋 분석 및 업무 문서 생성

2. 커밋 관리

3. 위키 연동

설치 방법

사용 방법

초기 설정

기본 사용법

설정 옵션

필요 권한

GitLab 토큰 권한

VS Code 권한

지원 환경

라이센스

문제 해결