Communitygithub.com

jasonjgarcia24/gantt-chart

Python CLI + Claude skill로 Google Sheets에서 간트 차트 프로그램 계획을 관리합니다. 캐스케이드 계산, 임계 경로, 자연어 라우팅을 지원합니다.

gantt-chart란 무엇인가요?

이 스킬은 Python CLI와 Claude 에이전트를 결합하여 Google Sheets 기반의 간트 차트 프로그램 계획을 자동화합니다. 사용자는 자연어 명령을 통해 작업을 추가, 업데이트, 조회할 수 있으며, 종속 관계에 따른 캐스케이드 계산과 임계 경로 분석을 지원합니다. 주로 개발자, 프로젝트 매니저, AI 에이전트 사용자를 대상으로 하며, Claude Code, Cursor, Codex와 같은 플랫폼에서 활용 가능합니다. SKILL.md 문서는 간트 차트 생성, 작업 간 의존성 관리, 일정 자동 조정 및 시각화 방법을 상세히 설명하며, Google Sheets API를 통해 실시간 협업과 데이터 동기화를 가능하게 합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add jasonjgarcia24/gantt-chart

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

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

문서

gantt-chart은(는) 무엇을 하나요?

Python CLI + Claude 스킬로 Google Sheets에서 간트 차트 프로그램 계획을 관리합니다. 캐스케이드 계산, 임계 경로, 자연어 라우팅을 지원합니다.

개요

이 스킬은 Python CLI 도구와 Claude 에이전트를 통합하여 Google Sheets에서 간트 차트를 생성하고 관리하는 방법을 제공합니다. 주요 기능은 다음과 같습니다:

  • 캐스케이드 계산: 작업 종속 관계에 따라 일정을 자동으로 업데이트합니다.
  • 임계 경로 분석: 프로젝트의 전체 일정에 영향을 미치는 중요한 작업 체인을 식별합니다.
  • 자연어 라우팅: 자연어 명령을 사용하여 간트 차트를 조작하고 질의합니다.

지원 플랫폼

  • Claude Code
  • Cursor
  • Codex
  • 모든 Claude 에이전트 호환 환경

설치

pip install gantt-chart-cli

또는 저장소를 복제합니다:

git clone https://github.com/jasonjgarcia24/gantt-chart.git
cd gantt-chart
pip install -r requirements.txt

설정

  1. Google Sheets API 사용 설정 및 서비스 계정 키(credentials.json)를 다운로드합니다.
  2. 환경 변수를 설정합니다:
export GOOGLE_APPLICATION_CREDENTIALS="/path/to/credentials.json"
export SPREADSHEET_ID="your-google-sheet-id"

사용법

CLI 명령어

gantt create --name "새 프로젝트" --start 2024-01-01 --end 2024-06-30
gantt add-task --project "새 프로젝트" --name "작업명" --duration 10 --depends-on "이전 작업"
gantt update --project "새 프로젝트" --task "작업명" --duration 15
gantt critical-path --project "새 프로젝트"
gantt view --project "새 프로젝트" --format table

Claude 자연어 명령

Claude 에이전트 내에서 다음과 같은 명령을 사용할 수 있습니다:

  • "새 간트 차트를 만들어줘. 프로젝트명은 '출시 계획', 시작일은 2024-03-01, 종료일은 2024-06-30으로 해줘."
  • "작업 '디자인 완료'의 기간을 14일로 업데이트해줘."
  • "현재 프로젝트의 임계 경로를 보여줘."
  • "간트 차트를 표 형식으로 출력해줘."

기능 상세

작업 구조

  • 각 작업에는 name, start_date, end_date, duration, depends_on 필드가 있습니다.
  • depends_on은 쉼표로 구분된 이전 작업 이름 목록입니다.
  • 캐스케이드 계산은 종속 관계를 따라 일정을 자동으로 조정합니다.

Google Sheets 연동

  • 스프레드시트는 각 프로젝트에 대해 별도의 시트를 사용합니다.
  • 헤더 행: 작업명, 시작일, 종료일, 기간(일), 의존 작업, 임계 경로
  • 업데이트는 실시간으로 동기화됩니다.

예제

다음은 작업 계획의 예입니다:

작업명시작일종료일기간(일)의존 작업
기획2024-01-012024-01-1515-
디자인2024-01-162024-01-3116기획
개발2024-02-012024-03-1543디자인
테스트2024-03-162024-03-3116개발
배포2024-04-012024-04-055테스트

문제 해결

  • API 인증 오류: credentials.json 파일 경로와 SPREADSHEET_ID 환경 변수가 올바르게 설정되었는지 확인합니다.
  • 날짜 형식: 모든 날짜는 YYYY-MM-DD 형식을 사용합니다.
  • 종속성 순환: 작업 의존 관계에 순환이 없는지 확인합니다.

라이선스

MIT

관련 스킬