TCS Wiki
Jira 워크로그 작성 & Confluence 문서 업로드를 위한 VS Code / Cursor 확장 프로그램입니다.
기능
📊 JIRA 대시보드
- 진행 중인 이슈 및 마감 임박/지연 이슈 한눈에 보기
- 테이블 정렬 기능 (제목, 상태, 업데이트, 마감일 등)
- 워크로그 작성 및 추출 기능 통합
🕐 Jira 워크로그 작성
- 최근 작업한 티켓 목록에서 빠르게 선택
- 날짜/시간 선택 (QuickPick)
- Work Description 입력 방식:
- 선택된 텍스트 사용
- 클립보드에서 붙여넣기
- 새 에디터에서 작성 (Git commit 스타일)
- 직접 입력
- 코멘트 없이
📄 Confluence 업로드
- Markdown 파일을 Confluence Storage Format으로 변환
- 부모 페이지 아래에 자식 페이지로 생성
- 기존 페이지 업데이트 지원
설치
확장 프로그램 설치
# 빌드 및 설치 (한 번에)
build_and_install.bat
또는 개별 실행:
# 빌드만
build.bat
# 설치만
install.bat
Pandoc 설치 (Confluence 업로드에 필요)
Confluence에 Markdown 파일을 업로드하려면 Pandoc이 필요합니다.
Windows
방법 1: Chocolatey 사용 (추천)
choco install pandoc
방법 2: 설치 파일 다운로드
- Pandoc 공식 사이트에서 Windows 설치 파일 다운로드
- 설치 파일 실행 (관리자 권한 필요 없음)
- 설치 경로가 시스템 PATH에 자동으로 추가됨
방법 3: Portable 버전
- Pandoc GitHub Releases에서
pandoc-X.X.X-windows-x86_64.zip 다운로드
- 압축 해제 후
pandoc.exe를 원하는 폴더에 배치
- 해당 폴더를 시스템 PATH에 추가
Linux (Ubuntu/Debian)
sudo apt-get install pandoc
macOS
brew install pandoc
Pandoc 설치 확인
터미널/PowerShell에서 다음 명령어로 설치 확인:
pandoc --version
설정
이 확장 프로그램을 사용하기 위해서는 Jira와 Confluence의 API 토큰을 설정해야 합니다.
1. settings.json 열기
VS Code / Cursor에서 Ctrl+Shift+P → "Preferences: Open User Settings (JSON)" 실행
또는 직접 파일 열기:
- Windows:
%APPDATA%\Code\User\settings.json (VS Code) 또는 %APPDATA%\Cursor\User\settings.json (Cursor)
- macOS:
~/Library/Application Support/Code/User/settings.json (VS Code) 또는 ~/Library/Application Support/Cursor/User/settings.json (Cursor)
- Linux:
~/.config/Code/User/settings.json (VS Code) 또는 ~/.config/Cursor/User/settings.json (Cursor)
2. 필수 설정 추가
settings.json 파일에 다음 설정을 추가하세요:
{
"tcswiki.jiraUrl": "https://tcs.telechips.com",
"tcswiki.jiraToken": "YOUR_JIRA_PERSONAL_ACCESS_TOKEN",
"tcswiki.confluenceUrl": "https://wiki.telechips.com",
"tcswiki.confluenceToken": "YOUR_CONFLUENCE_PERSONAL_ACCESS_TOKEN",
"tcswiki.confluenceSpaceKey": ""
}
참고: 위 예시의 YOUR_JIRA_PERSONAL_ACCESS_TOKEN과 YOUR_CONFLUENCE_PERSONAL_ACCESS_TOKEN 부분을 아래 방법으로 발급받은 실제 토큰으로 교체해야 합니다.
설정 항목 설명:
tcswiki.jiraUrl: Jira 서버 URL (예: https://tcs.telechips.com)tcswiki.jiraToken: Jira Personal Access Token (아래 참고)tcswiki.confluenceUrl: Confluence 서버 URL (예: https://wiki.telechips.com)tcswiki.confluenceToken: Confluence Personal Access Token (아래 참고)tcswiki.confluenceSpaceKey: 기본 Confluence Space Key (선택사항, 빈 문자열 가능)
3. API 토큰 발급 방법
Jira Personal Access Token 발급
- Jira에 로그인
- 우측 상단 프로필 아이콘 클릭
- "Account settings" 또는 "Personal Access Tokens" 메뉴 선택
- "Create token" 버튼 클릭
- 토큰 이름 입력 (예: "VS Code Extension")
- "Create" 클릭
- 생성된 토큰을 즉시 복사 (한 번만 표시됨!)
- 복사한 토큰을
tcswiki.jiraToken에 붙여넣기
Confluence Personal Access Token 발급
- Confluence에 로그인
- 우측 상단 프로필 아이콘 클릭
- "Settings" → "Personal Access Tokens" 선택
- "Create token" 버튼 클릭
- 토큰 이름 입력 (예: "VS Code Extension")
- "Create" 클릭
- 생성된 토큰을 즉시 복사 (한 번만 표시됨!)
- 복사한 토큰을
tcswiki.confluenceToken에 붙여넣기
4. 설정 저장 및 확인
settings.json 파일 저장 (Ctrl+S)- VS Code / Cursor 재시작 (선택사항, 대부분 자동 반영)
Ctrl+Shift+P → "TCS Wiki: 워크로그 작성" 실행하여 연결 테스트
⚠️ 보안 주의사항
- 토큰은 절대 공유하지 마세요! 개인 계정의 모든 권한을 가집니다.
settings.json 파일을 Git에 커밋하지 마세요 (.gitignore에 추가 권장)- 토큰이 유출된 경우 즉시 Jira/Confluence에서 토큰을 삭제하세요.
사용법
데모 영상
JIRA 대시보드
Ctrl+Shift+P → "TCS Wiki: JIRA 대시보드"- 진행 중인 이슈, 마감 임박/지연 이슈 확인
- 테이블 헤더 클릭으로 정렬 가능
- "워크로그 다운로드" 버튼으로 워크로그 추출
워크로그 작성
- JIRA 대시보드에서 이슈 클릭 또는
Ctrl+Shift+P → "TCS Wiki: 워크로그 작성"
- 티켓 선택 → 날짜 선택 → 시간 선택 → 작업 시간 입력 → 코멘트 입력
- 확인 후 작성 완료!
Confluence 업로드
- Markdown 파일 열기
Ctrl+Shift+P → "TCS Wiki: Confluence에 업로드"- 업로드 위치 선택 (부모 페이지 / Space 최상위)
- 페이지 제목 입력 → 업로드 완료!
요구사항
- VS Code 1.74.0 이상 또는 Cursor
- Node.js 16 이상
- Pandoc (Confluence 업로드 시 필수)
트러블슈팅
Confluence 업로드 실패
"Pandoc이 설치되지 않았습니다" 오류:
- 위의 "Pandoc 설치" 섹션을 참고하여 Pandoc 설치
- 설치 후 VS Code / Cursor 재시작
pandoc --version 명령어로 설치 확인
"부모 페이지를 찾을 수 없습니다" 오류:
- 부모 페이지 제목이 정확한지 확인
- Confluence Space Key가 올바른지 확인
- 해당 Space에 접근 권한이 있는지 확인
Jira 연결 실패
- Jira URL이 올바른지 확인 (예:
https://jira.company.com)
- Personal Access Token이 유효한지 확인
- 네트워크 연결 상태 확인
라이선스
MIT
