Shrimp Task Manager

# 🚀 Task Viewer v3.0.0 릴리스 노트 *릴리스 날짜: 2025년 8월 7일* ## 📑 목차 - [🎉 주요 신기능](#-주요-신기능) - [🤖 에이전트 관리 시스템](#-에이전트-관리-시스템) - [🤖 AI 기반 일괄 에이전트 배정](#-ai-기반-일괄-에이전트-배정) - [📊 작업 이력의 Git 버전 관리](#-작업-이력의-git-버전-관리) - [📊 프로젝트 히스토리 뷰](#-프로젝트-히스토리-뷰) - [🎨 템플릿 관리 시스템](#-템플릿-관리-시스템) - [🌍 국제화(i18n) 지원](#-국제화i18n-지원) - [🧭 향상된 네비게이션 및 UI](#-향상된-네비게이션-및-ui) - [🔄 주요 개선사항](#-주요-개선사항) - [작업 세부정보 네비게이션](#작업-세부정보-네비게이션) - [성능 향상](#성능-향상) - [개발자 경험](#개발자-경험) - [UI/UX 개선](#uiux-개선) - [🐛 버그 수정](#-버그-수정) - [중요 수정](#중요-수정) - [UI 수정](#ui-수정) - [데이터 처리](#데이터-처리) - [🏗️ 기술 업데이트](#️-기술-업데이트) - [새로운 의존성](#새로운-의존성) - [API 개선](#api-개선) - [아키텍처 개선](#아키텍처-개선) - [📝 호환성 변경사항](#-호환성-변경사항) - [설정 업데이트](#설정-업데이트) - [API 변경](#api-변경) - [🚀 마이그레이션 가이드](#-마이그레이션-가이드) - [🎯 요약](#-요약) ## 🎉 주요 신기능 ### 🤖 에이전트 관리 시스템 **전문화된 작업 처리를 위한 포괄적인 서브 에이전트 관리** SHRIMP-TASK-MANAGER는 이제 강력한 에이전트 관리 기능을 지원하여 다양한 유형의 작업에 대해 전문화된 AI 에이전트를 정의하고 사용할 수 있습니다. 에이전트는 최적의 실행을 위해 작업에 할당할 수 있는 전문화된 AI 성격 또는 기술 세트입니다. 이 기능은 Claude의 에이전트 시스템과 원활하게 통합되어 `.claude/agents` 폴더에 저장된 사용자 정의 에이전트를 활용할 수 있습니다. 주요 기능: - **에이전트 목록 보기**: `.claude/agents` 폴더의 모든 사용 가능한 에이전트를 자세한 정보와 함께 탐색 - **에이전트 배정**: 작업 테이블의 드롭다운을 통해 작업에 특정 에이전트 배정 - **에이전트 뷰어 팝업**: 작업 테이블의 눈 아이콘(👁️)을 클릭하여 팝업 에이전트 뷰어를 열고, 다양한 에이전트를 스크롤하며 각 작업에 적합한 에이전트 선택 - **에이전트 에디터**: 에이전트 메타데이터의 색상 커스터마이제이션이 가능한 내장 에디터 - **전역 및 프로젝트 에이전트**: 프로젝트별 및 전역 에이전트 정의 지원 - **원클릭 AI 지시사항**: 로봇 이모지를 클릭하여 에이전트별 지시사항을 클립보드로 복사 - **에이전트 목록 AI 지시사항**: 에이전트 목록에 로봇 이모지(🤖)가 있는 새로운 AI 지시사항 열로 Claude에서 직접 사용할 수 있는 `use subagent [agent-name] located in [path]:` 복사 - **에이전트 정보 모달**: 에이전트 간 네비게이션이 가능한 자세한 에이전트 정보 - **메타데이터 통합**: 에이전트 배정을 tasks.json에 직접 저장 - **색상 코딩**: 사용자 정의 색상을 사용한 에이전트 시각적 구분 #### 에이전트 배정 워크플로우: 1. **사용 가능한 에이전트 보기**: 에이전트 탭에 액세스하여 `.claude/agents` 폴더의 모든 에이전트 확인 2. **작업에 배정**: 작업 테이블의 드롭다운을 사용하여 각 작업에 에이전트 선택 3. **지시사항 복사**: 로봇 이모지를 클릭하여 복사: `use the built in subagent located in ./claude/agents/[agent-name] to complete this shrimp task: [task-id] please when u start working mark the shrimp task as in progress` 4. **에이전트 편집**: 사용자 정의 색상을 포함한 에이전트 콘텐츠 및 메타데이터 수정  *에이전트 목록 뷰는 AI 지시사항 열과 함께 모든 사용 가능한 에이전트를 표시 - 로봇 이모지(🤖)를 클릭하여 `use subagent debugger.md located in ./claude/agents to perform:`와 같은 에이전트 사용 지시사항을 클립보드로 직접 복사*  *작업 테이블의 드롭다운 선택기를 사용하여 작업에 에이전트 배정*  *눈 아이콘(👁️)을 클릭하여 에이전트 뷰어 팝업을 열고 작업 배정을 위한 사용 가능한 에이전트 탐색*  *시각적 구성을 위해 에이전트 콘텐츠를 편집하고 색상으로 사용자 정의*  *로봇 이모지를 클릭하여 에이전트별 작업 지시사항 복사*  *자세한 정보와 쉬운 네비게이션으로 에이전트 탐색*  *시스템 전체 에이전트에 액세스하기 위한 전역 Claude 폴더 경로 구성* ### 🤖 AI 기반 일괄 에이전트 배정 **OpenAI GPT-4를 사용하여 여러 작업에 가장 적절한 에이전트를 자동으로 배정** Task Viewer는 이제 OpenAI의 GPT-4와 통합되어 작업 설명과 요구사항을 기반으로 지능적으로 작업에 에이전트를 배정합니다. 이 기능은 많은 수의 작업에 적절한 에이전트를 구성하는 데 필요한 시간을 크게 줄입니다. 주요 기능: - **일괄 선택**: 작업 테이블의 체크박스를 사용하여 여러 작업 선택 - **원클릭 배정**: "AI 에이전트 배정"을 클릭하여 선택된 모든 작업에 자동으로 에이전트 배정 - **지능적 매칭**: GPT-4가 작업 설명과 에이전트 능력을 분석하여 최적의 배정 수행 - **전역 설정 통합**: 전역 설정 탭에서 OpenAI API 키 구성 - **환경 변수 지원**: `OPENAI_API_KEY` 또는 `OPEN_AI_KEY_SHRIMP_TASK_VIEWER` 환경 변수도 지원 - **오류 안내**: API 키가 구성되지 않은 경우 명확한 지침 제공 #### 설정 지침: 1. **API 키 구성**: 설정 → 전역 설정으로 이동하여 OpenAI API 키 입력 2. **작업 선택**: 체크박스를 사용하여 에이전트 배정이 필요한 작업 선택 3. **AI 배정**: 일괄 작업 표시줄의 "🤖 AI 에이전트 배정" 버튼 클릭 4. **자동 처리**: GPT-4가 작업을 분석하고 가장 적합한 에이전트 배정  *AI 기반 에이전트 배정을 위한 전역 설정에서 OpenAI API 키 구성*  *여러 작업을 선택하고 "🤖 AI 에이전트 배정(5개 작업 선택됨)"을 클릭하여 GPT-4를 사용해 적절한 에이전트를 자동으로 배정* ### 📊 작업 이력의 Git 버전 관리 **작업의 모든 변경사항을 자동 Git 커밋으로 추적** SHRIMP-TASK-MANAGER는 이제 tasks.json 파일의 모든 변경사항을 자동으로 추적하는 내장 Git 통합을 포함합니다. 이는 수동 개입 없이 작업 수정의 완전한 감사 추적을 제공합니다. 주요 기능: - **자동 Git 저장소**: 첫 사용 시 데이터 디렉토리에 Git 저장소 초기화 - **타임스탬프 커밋**: 모든 작업 작업(생성, 업데이트, 삭제)이 로컬 시간대 타임스탬프와 함께 커밋 생성 - **설명적 메시지**: 커밋에 변경 내용에 대한 명확한 설명 포함 (예: "새 작업 추가: 사용자 인증 구현") - **비차단**: Git 작업이 try-catch 블록으로 래핑됨 - Git이 실패해도 작업 작업은 정상적으로 계속 - **격리된 저장소**: Git 저장소는 작업 이력만을 위해 사용되며 프로젝트 저장소와 완전히 분리 - **병합 충돌 없음**: 단일 파일 추적과 선형 히스토리로 충돌 불가능 #### 이점: - **완전한 히스토리**: 표준 Git 도구를 사용하여 작업의 전체 진화 과정 검토 - **변경 추적**: 작업이 언제 어떻게 수정되었는지 정확히 확인 - **복구 옵션**: 필요시 이전 작업 상태 복원 - **팀 가시성**: 팀 구성원과 작업 이력 공유 Git 통합은 완전히 투명하며 구성이 필요하지 않습니다. 언제든지 다음 명령을 사용하여 히스토리를 볼 수 있습니다: ```bash cd <shrimp-data-directory> git log --oneline ``` #### 작업 히스토리 보는 방법 1. **작업 데이터 디렉토리로 이동** (`.mcp.json`에서 구성된 대로): ```bash cd <shrimp-data-directory> ``` 2. **커밋 히스토리 보기**: ```bash git log --oneline ``` 3. **특정 변경사항 보기**: ```bash git show <commit-hash> ``` 4. **버전 비교**: ```bash git diff HEAD~5 # 5개 커밋 전과 비교 ``` 5. **이전 상태 복원** (필요시): ```bash git checkout <commit-hash> -- tasks.json ``` ### 📊 프로젝트 히스토리 뷰 **프로젝트의 작업 실행 이력 추적 및 분석** SHRIMP-TASK-MANAGER는 새로운 작업 세션을 시작할 때마다 완료된 작업을 프로젝트 내 메모리 파일에 자동으로 저장합니다. 이전에는 이 귀중한 히스토리 데이터가 메모리 파일에 숨겨져 UI를 통해 접근할 수 없었습니다. 새로운 프로젝트 히스토리 뷰는 이 작업 이력을 노출하여 시간에 따른 프로젝트 진화를 탐색할 수 있게 합니다. 이 기능을 통해 다음을 수행할 수 있습니다: - **히스토리 작업 스냅샷**: SHRIMP-TASK-MANAGER가 저장한 프로젝트의 과거 상태 탐색 - **작업 진화 추적**: 다양한 세션에서 작업이 생성부터 완료까지 어떻게 진행되었는지 확인 - **메모 시스템**: 향후 참조 및 팀 지식 공유를 위한 히스토리 항목에 개인 메모 추가 - **자세한 작업 뷰**: 특정 히스토리 작업 상태를 자세히 살펴보고 과거 결정 및 구현 이해 - **시간 기반 네비게이션**: 프로젝트의 타임라인을 탐색하여 언제 무엇이 완료되었는지 확인 - **스냅샷 비교**: 다양한 시기의 작업 상태를 비교하여 프로젝트 성장 및 변화 추적   ### 🎨 템플릿 관리 시스템 **AI 작업 실행을 위한 강력한 템플릿 커스터마이제이션** 템플릿은 SHRIMP-TASK-MANAGER가 다양한 유형의 작업을 분석하고 실행하는 방법을 안내하는 핵심 지침입니다. 계획과 분석부터 구현과 검증까지 AI가 다양한 유형의 작업에 접근하는 방법을 정의합니다. MCP-TASK-MANAGER는 기본 동작을 재정의하거나 기존 템플릿에 추가 지침을 추가할 수 있는 사용자 정의 템플릿을 허용합니다. 이 새로운 템플릿 관리 인터페이스는 다음을 위한 직관적인 방법을 제공합니다: - **템플릿 에디터**: 사용자 정의 AI 지침 작성을 위한 구문 강조 기능이 있는 완전한 마크다운 에디터 - **템플릿 미리보기**: 활성화하기 전에 템플릿의 라이브 미리보기를 통해 요구사항 충족 확인 - **템플릿 복제**: 다양한 사용 사례를 위해 기존 템플릿의 변형을 쉽게 생성 - **템플릿 상태 추적**: 기본(원본), 사용자 정의(완전 교체), 사용자 정의+추가(기본에 추가) 상태를 보여주는 시각적 표시기 - **기본값으로 재설정**: 필요시 원본 템플릿을 원클릭으로 복원 - **템플릿 내보내기**: 백업, 팀 구성원과 공유 또는 버전 관리를 위해 사용자 정의 템플릿 내보내기 - **활성화 대화상자**: 실수로 변경하는 것을 방지하기 위해 템플릿 활성화 시 명확한 확인  ### 🌍 국제화(i18n) 지원 **원활한 언어 전환이 가능한 다국어 지원** - **지원하는 세 언어**: 영어(en), 중국어(중文), 스페인어(Español) - **지속적인 언어 선택**: 언어 선호도가 저장되고 기억됨 - **완전한 UI 번역**: 모든 UI 요소, 버튼, 레이블, 메시지가 완전히 번역됨 - **동적 언어 전환**: 페이지 새로고침 없이 즉시 언어 변경 - **언어 컨텍스트 제공자**: 일관된 번역을 위한 중앙집중식 언어 관리 ### 🧭 향상된 네비게이션 및 UI **현대적이고 직관적인 인터페이스 개선** - **중첩 탭 시스템**: 기본 및 보조 탭으로 구성된 네비게이션 - **URL 상태 동기화**: 현재 뷰를 반영하도록 브라우저 URL 업데이트 - **작업 세부정보 네비게이션**: 목록으로 돌아가지 않고 순차적으로 작업을 검토할 수 있는 이전/다음 버튼 - **로딩 스피너**: 데이터 로딩 중 시각적 피드백 - **토스트 알림**: 비침입적 성공/오류 메시지 - **반응형 디자인**: 향상된 모바일 및 태블릿 경험 - **모달 개선**: 더 나은 모달 레이아웃 및 상호작용 - **키보드 네비게이션**: 세부 뷰에서 더 빠른 작업 네비게이션을 위한 화살표 키 지원 ## 🔄 주요 개선사항 ### 작업 세부정보 네비게이션 **원활한 작업 검토 워크플로우** 작업 세부정보 뷰에는 이제 작업을 검토하고 처리하는 방식을 변화시키는 이전/다음 네비게이션 버튼이 포함됩니다: - **순차적 네비게이션**: 메인 목록으로 돌아가지 않고 순서대로 작업 이동 - **컨텍스트 보존**: 작업 간 전환 시 세부 뷰에서 유지 - **시각적 표시기**: 버튼에 작업 번호 표시 (예: "← 이전 (작업 3)" 및 "다음 (작업 5) →") - **스마트 경계**: 첫 번째 및 마지막 작업에서 네비게이션 버튼 비활성화 - **키보드 단축키**: 더 빠른 네비게이션을 위한 화살표 키 사용 - **효율성 향상**: 앞뒤로 클릭하는 것보다 3-5배 빠른 전체 작업 목록 검토 이 기능은 다음의 경우에 특히 유용합니다: - AI 분석에서 새로 생성된 작업 검토 - 일련의 의존적 작업 처리 - 여러 관련 작업의 구현 세부사항 확인 - 작업 감사 또는 검토 수행 ### 성능 향상 - **최적화된 재렌더링**: 더 나은 성능을 위해 React hooks 적절히 메모화 - **지연 로딩**: 더 빠른 초기 페이지 로드를 위한 온디맨드 컴포넌트 로딩 - **효율적인 상태 관리**: 불필요한 상태 업데이트 감소 - **일괄 업데이트**: 더 매끄러운 UI를 위한 다중 상태 변경 일괄 처리 ### 개발자 경험 - **포괄적인 테스트 스위트**: 통합 및 언어 기능 테스트 추가 - **테스트 체크리스트**: 구조화된 테스트 문서 - **더 나은 오류 처리**: 더 유익한 오류 메시지 - **디버그 로깅**: 개발을 위한 향상된 디버깅 기능 ### UI/UX 개선 - **개선된 작업 테이블**: 더 나은 열 크기 조정 및 텍스트 래핑 - **향상된 모달**: 일관된 모달 스타일링 및 동작 - **더 나은 타이포그래피**: 업데이트된 글꼴 크기로 가독성 개선 - **색상 체계 업데이트**: 더 접근하기 쉬운 색상 대비 - **아이콘 일관성**: 앱 전체에서 통일된 아이콘 사용 ## 🐛 버그 수정 ### 중요 수정 - **useRef Hook 오류**: 앱 크래시를 유발하는 누락된 React hook 가져오기 수정 - **번역 키**: 모든 지원 언어에 대한 누락된 번역 키 추가 - **심볼릭 링크 루프**: Screenshots 디렉토리 무한 루프 문제 해결 - **Windows 경로 처리**: Windows 11에서 file:// URI 문제 수정 - **저장소 링크**: 모든 저장소 참조 수정 ### UI 수정 - **모달 Z-index**: 모달 레이어링 문제 수정 - **탭 선택**: 페이지 새로고침 시 탭 지속성 수정 - **언어 선택기**: 상태 동기화 문제 수정 - **복사 기능**: 클립보드 작업 안정성 향상 - **반응형 레이아웃**: 모바일 뷰포트 문제 수정 ### 데이터 처리 - **프로필 로딩**: 프로필 전환 시 경쟁 조건 수정 - **작업 새로고침**: 자동 새로고침 안정성 향상 - **히스토리 로딩**: 히스토리 뷰의 페이지네이션 문제 수정 - **템플릿 저장**: 템플릿 지속성 버그 해결 ## 🏗️ 기술 업데이트 ### 새로운 의존성 - `@headlessui/react`: 현대적인 UI 컴포넌트 - `@tanstack/react-table`: 고급 테이블 기능 - `@uiw/react-md-editor`: 템플릿용 마크다운 편집 - TypeScript 지원을 위한 추가 타입 정의 ### API 개선 - **GET /api/templates**: 모든 사용 가능한 템플릿 목록 - **PUT /api/templates/:name**: 템플릿 콘텐츠 업데이트 - **POST /api/templates/:name/duplicate**: 템플릿 복제 - **GET /api/history/:profileId**: 프로젝트 히스토리 가져오기 - **향상된 오류 응답**: 더 자세한 API 오류 메시지 ### 아키텍처 개선 - **컴포넌트 모듈화**: 관심사 분리 개선 - **사용자 정의 Hooks**: 재사용 가능한 로직을 hooks로 추출 - **컨텍스트 제공자**: 중앙집중식 상태 관리 - **유틸리티 함수**: 공통 작업을 위한 공유 유틸리티 ## 📝 호환성 변경사항 ### 설정 업데이트 - **언어 설정**: 새로운 언어 선호도 저장 형식 - **템플릿 저장소**: 템플릿이 이제 사용자 홈 디렉토리에 저장 - **URL 구조**: 더 나은 네비게이션을 위한 업데이트된 URL 패턴 ### API 변경 - **프로필 엔드포인트**: 더 많은 메타데이터를 포함하도록 응답 형식 업데이트 - **작업 엔드포인트**: 추가 필터링 옵션으로 향상 - **템플릿 엔드포인트**: 템플릿 관리를 위한 새로운 엔드포인트 구조 ## 🚀 마이그레이션 가이드 ### v2.1에서 v3.0으로 1. **언어 선택**: 기본 언어는 영어이며, 새 선택기에서 선호 언어 선택 2. **템플릿**: 기존 사용자 정의 템플릿은 보존되지만 재활성화가 필요할 수 있음 3. **브라우저 캐시**: 최적의 성능을 위해 브라우저 캐시 지우기 4. **프로필 데이터**: 모든 기존 프로필은 변경 없이 계속 작동 ## 🎯 요약 버전 3.0은 Task Viewer의 주요 도약을 나타내며, 단순한 작업 시각화 도구에서 포괄적인 작업 관리 및 커스터마이제이션 플랫폼으로 변환되었습니다. 완전한 국제화 지원, 강력한 템플릿 관리, AI 기반 자동화, Git 기반 히스토리 추적 기능을 통해 이 릴리스는 팀에게 AI 지원 개발 워크플로우에 대한 전례 없는 제어를 제공합니다. 이 릴리스의 주요 하이라이트: - **AI 기반 에이전트 배정**: GPT-4를 활용하여 작업에 가장 적절한 에이전트를 자동으로 배정 - **Git 버전 관리**: 타임스탬프 커밋을 통한 모든 작업 변경사항 자동 추적 - **다국어 지원**: 영어, 중국어, 스페인어를 지원하는 완전한 국제화 - **템플릿 관리**: 템플릿 편집을 통한 AI 동작의 깊은 커스터마이제이션 - **히스토리 뷰**: Git 커밋과 메모리 스냅샷을 통한 프로젝트 진화의 완전한 가시성 세 언어 지원(영어, 중국어, 스페인어) 추가로 도구를 전 세계 사용자가 사용할 수 있게 되었으며, 템플릿 관리 시스템은 AI 동작의 깊은 커스터마이제이션을 가능하게 합니다. Git 통합은 모든 작업 수정의 영구 감사 추적을 제공하고, AI 기반 일괄 배정 기능은 작업 구성 속도를 크게 높입니다. 이 릴리스는 향후 개선의 기반을 마련하고 Task Viewer를 현대 AI 지원 개발 도구키트의 필수 도구로 자리매김합니다.