Harvest Automation

Harvest Automation skill 개요

Harvest Automation이 하는 일

Harvest Automation은 Rube MCP server와 Composio Harvest toolkit을 사용해 자연어로 Harvest를操作할 수 있게 해주는 Claude Code skill입니다. 터미널에서 Harvest UI로 이동하지 않고도 시간 기록을 남기고, time entry를 조회·수정하며, project, client, task를 관리하고, 청구나 리포팅에 필요한 데이터를 가져올 수 있습니다.

이 Harvest Automation skill은 이미 Harvest로 업무 시간을 관리하고 있으며 더 빠르고 마찰이 적은 workflow automation을 원하는 프리랜서, 에이전시, 엔지니어링 팀, 컨설턴트, 운영 담당자에게 잘 맞습니다.

잘 맞는 작업과 사용자

Harvest Automation은 “project X와 task Y에 3.5시간 기록해 줘”, “이번 주에 아직 제출하지 않은 시간을 보여 줘”, “기존 project에 task를 만들어 줘”, “인보이스 검토용 time entry를 가져와 줘”처럼 대상이 구체적이고 Harvest 계정 데이터가 필요한 작업에 적합합니다. Harvest 데이터나 실제 작업이 필요 없는 막연한 계획 수립에는 상대적으로 덜 유용합니다.

가장 잘 맞는 영역은 정확도가 중요한 반복 행정 업무입니다. 예를 들어 time entry 정리, project/task 조회, invoice 준비, client/project 유지관리 같은 작업입니다.

도입 전에 확인해야 할 요구사항

이 저장소에는 SKILL.md 하나만 들어 있습니다. helper script, rules 폴더, 번들 reference file은 없습니다. 핵심 요구사항은 MCP 접근입니다. 이 skill은 rube를 필수로 선언하며, https://rube.app/mcp의 Rube MCP server를 추가한 뒤 Harvest 계정을 인증하는 흐름을 전제로 합니다.

설치하기 전에 사용 환경이 Claude Code skills와 MCP servers를 지원하는지, 그리고 실제 Harvest workspace에 대한 tool access를 부여해도 되는지 확인하세요.

Harvest Automation skill 사용 방법

Harvest Automation 설치 및 설정 경로

사용 중인 skill manager로 원본 저장소에서 skill을 설치합니다. 예를 들면 다음과 같습니다.

npx skills add ComposioHQ/awesome-claude-skills --skill "Harvest Automation"

그다음 Claude Code가 Rube MCP server를 사용하도록 설정합니다.

1. MCP server URL을 추가합니다: https://rube.app/mcp
2. Claude가 Harvest 접근 권한을 요청하면 인증 링크를 따라 진행합니다
3. record를 생성하거나 수정하기 전에 read-only 요청으로 먼저 테스트합니다

먼저 composio-skills/harvest-automation/SKILL.md를 읽어 보세요. 이 skill에는 별도의 README.md, metadata.json, script, reference가 없으므로, 지원되는 workflow와 tool 이름을 확인하는 기준 문서는 SKILL.md입니다.

skill이 안정적으로 동작하는 데 필요한 입력

Harvest Automation은 실제 Harvest identifier와 날짜 정보를 제공할수록 훨씬 안정적으로 동작합니다. time entry 작업에는 다음 정보가 필요할 수 있습니다.

• project_id
• task_id
• spent_date 형식: YYYY-MM-DD
• duration 기반 계정의 경우 hours
• timestamp 기반 계정의 경우 started_time 및 ended_time
• 작업 내용을 설명하는 notes

좋지 않은 프롬프트 예시는 다음과 같습니다. “오늘 개발 시간 기록해 줘.”

더 나은 프롬프트는 다음과 같습니다. “Use Harvest Automation to log 3.5 hours for 2026-01-15 on project 12345, task 67890, notes: Implemented OAuth callback handling and tests. If the project-task pairing is invalid, stop and tell me before creating anything.”

더 안전한 자동화를 위한 실무 workflow

생성, 수정, invoice 인접 작업에는 2단계 workflow를 사용하세요.

1. Harvest Automation에 관련 project, task, client 또는 time entry를 먼저 목록으로 보여 달라고 하거나 조회하게 합니다.
2. 무엇을 생성하거나 수정하기 전에 정확한 record ID를 확인합니다.

이렇게 하면 비슷한 project 이름, 오래된 task 배정, 모호한 날짜 때문에 생기는 실수를 줄일 수 있습니다. 리포팅과 invoicing 검토를 할 때는 먼저 “월요일부터 금요일까지 client X의 time entry를 나열해 줘”처럼 필터링된 목록을 요청하고, raw entry가 맞는지 확인한 뒤에만 요약을 요청하세요.

출력 품질을 높이는 프롬프트 패턴

좋은 프롬프트는 의도, 제약 조건, 확인 방식을 함께 담습니다.

• “List time entries for project 12345 from 2026-01-01 to 2026-01-31; group by task and flag entries missing notes.”
• “Create a Harvest project for client Acme, name Website Retainer Q1, but show me the proposed fields before calling the create tool.”
• “Update time entry 98765 to 2.25 hours and notes Bug triage and hotfix review; do not change the date, project, or task.”

이런 프롬프트는 에이전트가 넓은 요청을 추측으로 처리하지 않고, 올바른 Harvest tool을 선택하는 데 도움이 됩니다.

Harvest Automation skill FAQ

Harvest Automation은 Workflow Automation용인가요?

네. Workflow Automation을 위한 Harvest Automation은 Harvest가 반복적인 운영 프로세스의 일부일 때 가장 큰 가치를 냅니다. 예를 들어 매일 시간 기록, 주간 timesheet 검토, project 설정, task 유지관리, invoice 준비 같은 작업입니다. 청구 판단 자체를 대신해 주지는 않지만, 수동 탐색과 복사·붙여넣기 작업은 줄여 줄 수 있습니다.

일반 프롬프트와 무엇이 다른가요?

일반 프롬프트는 Harvest 사용 방법을 설명해 줄 수 있습니다. Harvest Automation skill은 계정 인증이 되어 있고 필요한 tool 권한이 제공되는 경우, Rube MCP 연결을 통해 Harvest 관련 tool을 호출할 수 있습니다. 따라서 Harvest record를 나열하고, 생성하고, 조회하고, 수정하는 실제 작업에 사용할 수 있습니다.

초보자도 쓰기 쉬운가요?

이미 Harvest workspace 구조를 알고 있다면 초보자도 비교적 쉽게 사용할 수 있습니다. 다만 Harvest를 처음 쓰는 사용자는 project ID, task ID, client 관계, 날짜 형식이 중요하기 때문에 어려움을 겪을 수 있습니다. read-only 목록 조회 요청으로 시작해 정확한 ID를 익힌 뒤, 생성이나 수정 작업으로 넘어가세요.

언제 사용하지 않는 것이 좋나요?

대상 client, project, task, time entry를 검증할 수 없다면 이 skill을 사용하지 마세요. 먼저 변경안 목록을 요청하지 않은 상태에서 “내 timesheet 전부 고쳐 줘” 같은 넓은 명령은 피해야 합니다. 민감한 청구 변경, invoice 생성, 대량 batch update의 경우 실행 전에 반드시 확인 단계를 요구하세요.

Harvest Automation skill 개선 방법

더 나은 context로 Harvest Automation 결과 개선하기

가장 유용한 context는 길고 자세한 설명이 아니라 운영에 필요한 정확한 정보입니다. 정확한 날짜 범위, workspace에서 쓰는 용어, record ID, 청구 목적, 요청이 read-only인지 write-enabled인지 포함하세요. ID를 모른다면 이름으로 추론하게 만들기보다, 먼저 후보를 찾게 하세요.

예시: “Find active projects matching Acme and list their tasks with IDs. Do not create or update anything yet.”

예방해야 할 일반적인 실패 유형

가장 큰 위험은 모호함입니다. 비슷한 project 이름, 여러 project에서 재사용되는 task 이름, “지난 금요일”처럼 불명확한 날짜, duration 방식과 start/end-time 방식의 계정 설정 차이가 문제를 만들 수 있습니다. 또 다른 흔한 문제는 entry의 notes와 task 배정이 정확한지 확인하기 전에 invoice-ready 요약을 요청하는 것입니다.

이를 방지하려면 skill이 손대려는 record를 먼저 보여 주게 하고, 상대 날짜 대신 절대 날짜를 사용하세요.

첫 출력 이후에 반복 개선하기

첫 응답 이후에는 처음부터 다시 시작하기보다 workflow를 다듬으세요. skill이 entry 목록을 보여 줬다면 notes가 빠진 항목만 필터링하거나, project별로 묶거나, 확인용 표를 준비해 달라고 요청할 수 있습니다. task가 project에 배정되어 있지 않아 생성 요청이 실패했다면, 재시도하기 전에 해당 project에서 유효한 task를 먼저 나열해 달라고 하세요.

좋은 반복 프롬프트 예시는 다음과 같습니다. “From the entries you just listed, show only records over 8 hours or missing notes, then suggest corrections without applying them.”

maintainer를 위한 저장소 개선 아이디어

Harvest Automation skill은 지원되는 각 action별 예시 프롬프트, read-only 작업과 write-action 작업에 대한 안내, MCP 인증, 잘못된 project-task pairing, 날짜 형식 문제를 다루는 짧은 troubleshooting 섹션이 있으면 더 강력해질 수 있습니다. destructive하거나 billing-sensitive한 update를 위한 간단한 안전 체크리스트도 팀이 이 skill 설치 여부를 평가하는 데 도움이 됩니다.