affinity-automation

affinity-automation skill 개요

affinity-automation의 용도

affinity-automation은 Composio의 Rube MCP server를 통해 Affinity CRM 작업을 실행하기 위한 Claude skill입니다. 에이전트가 현재 Affinity tool schema를 확인하고, 사용자의 Affinity 연결 상태를 검증한 뒤, 자유 형식 프롬프트보다 추측을 줄여 CRM 작업을 수행해야 하는 상황에 맞게 설계되었습니다.

가장 적합한 사용자와 업무

affinity-automation skill은 이미 Affinity를 사용하고 있으며 반복적인 운영 업무에 AI 에이전트를 활용하려는 CRM Operations, sales operations, investor relations, recruiting operations, 데이터 팀에 잘 맞습니다. 대표적인 업무로는 적절한 Affinity tools 찾기, list 또는 organization 업데이트 준비, 연결 상태 확인, 그리고 “실행 전에 먼저 탐색”하는 안전한 워크플로로 에이전트를 안내하는 작업이 있습니다.

이 skill이 다른 점

핵심 차별점은 하드코딩된 Affinity 명령어를 길게 모아둔 라이브러리가 아니라는 점입니다. 이 skill은 에이전트가 먼저 RUBE_SEARCH_TOOLS를 사용하도록 안내해, Rube MCP에서 현재 tool slug, schema, 실행 계획, 주의점을 가져오게 합니다. MCP tool schema는 바뀔 수 있기 때문에 중요합니다. 오래된 parameter 이름을 전제로 한 프롬프트는 실패하거나 잘못된 CRM 데이터를 기록할 수 있습니다.

도입 전에 확인해야 할 사항

affinity-automation을 설치하거나 업무에 사용하기 전에, 사용 중인 AI client가 MCP를 지원하고 Rube MCP가 설정되어 있는지 확인하세요. 원본 skill은 mcp: [rube], RUBE_MANAGE_CONNECTIONS를 통한 활성 Affinity 연결, 그리고 affinity toolkit 접근 권한을 요구합니다. Rube MCP를 연결할 수 없거나 Affinity 권한 부여를 완료할 수 없다면, 이 skill은 실질적인 작업을 수행하지 못합니다.

affinity-automation skill 사용 방법

affinity-automation 설치 환경

Composio skill collection에서 skill을 설치한 다음, 사용 중인 client에서 Rube MCP를 별도로 설정하세요. 일반적인 설치 명령은 다음과 같습니다.

npx skills add ComposioHQ/awesome-claude-skills --skill affinity-automation

그런 다음 client 설정에 https://rube.app/mcp를 MCP server로 추가합니다. upstream skill에서는 endpoint 자체에 API key가 필요하지 않다고 설명하지만, 활성 Affinity 연결은 여전히 필요합니다. 먼저 RUBE_SEARCH_TOOLS를 사용할 수 있는지 확인한 뒤, toolkit affinity와 함께 RUBE_MANAGE_CONNECTIONS를 사용하세요. 연결 상태가 ACTIVE가 아니라면 반환된 authorization flow를 완료해야 합니다.

skill이 사용자에게 필요로 하는 입력

affinity-automation을 제대로 활용하려면 에이전트에게 비즈니스 목표, Affinity object type, 선택 기준, 의도한 작업, 안전 규칙을 알려주세요. 약한 프롬프트의 예는 “Update Affinity.”입니다. 더 나은 프롬프트는 다음과 같습니다. “Use affinity-automation to find Affinity tools for updating organizations. Check the Affinity connection first. I need to add companies from list X to list Y only if they are not already present. Do not overwrite existing owner, status, or notes fields. Show the discovered tool schema before executing.”

이렇게 입력하면 skill이 작업이 people, organizations, lists, opportunities, notes 중 무엇에 해당하는지 추측하지 않고, 사용자의 운영 목표를 현재 Rube tools에 더 정확히 매핑할 수 있습니다.

권장 워크플로

모든 실행은 tool discovery로 시작하세요. 에이전트에게 단순히 “Affinity operations”가 아니라, 구체적인 Affinity 작업에 대해 RUBE_SEARCH_TOOLS를 호출하라고 요청합니다. 가능하면 반환된 session을 재사용하고, 발견된 schema를 검토한 뒤, RUBE_MANAGE_CONNECTIONS로 Affinity 연결을 확인하세요. 그 다음에야 에이전트가 실행 tools를 호출해야 합니다. 쓰기 작업의 경우, 실행 전에 간단한 preflight summary를 요청하세요. 대상 레코드, 변경할 필드, 건너뛸 레코드, rollback 또는 review 제한 사항이 포함되어야 합니다.

먼저 읽어볼 repository 파일

이 skill은 간결합니다. 우선 확인할 핵심 파일은 composio-skills/affinity-automation/SKILL.md입니다. 현재 repository preview에는 bundled scripts, references, rules, README 파일이 없으므로, 대부분의 구현 세부사항은 skill 본문과 live Rube MCP tool discovery response에 담겨 있습니다. 설치 여부를 판단하려면 prerequisites, setup, tool discovery, core workflow 섹션을 먼저 읽어보세요.

affinity-automation skill FAQ

affinity-automation은 CRM Operations용인가요?

네. CRM Operations에서 affinity-automation은 Affinity 작업에 대해 일관된 에이전트 워크플로가 필요할 때 가장 유용합니다. 즉, tools를 탐색하고, 연결을 확인하고, schema를 검토한 뒤 실행하는 흐름입니다. 데이터 품질이 중요하고, 에이전트가 필드를 지어내거나 오래된 API 가정에 기대면 안 되는 상황에서 특히 적합합니다.

일반 프롬프트보다 나은 점은 무엇인가요?

일반 프롬프트도 “use Affinity”라고 지시할 수는 있지만, 에이전트가 현재 Rube tool schema를 반드시 탐색하도록 강제하지는 않을 수 있습니다. affinity-automation skill은 이런 운영상의 규율을 내장합니다. schema, tool 이름, 필수 필드가 불확실한 상황에서 가치가 가장 큽니다. 실행 전에 live tool discovery를 하도록 에이전트를 유도하기 때문입니다.

초보자도 이 skill을 사용할 수 있나요?

Affinity 데이터 모델을 이해하고 MCP 설정에 도움을 받을 수 있다면 초보자도 affinity-automation skill을 사용할 수 있습니다. 보통 어려운 부분은 skill 문구 자체가 아니라, 어떤 레코드를 수정해야 하고 무엇은 절대 바꾸면 안 되는지 판단하는 일입니다. 신규 사용자는 광범위한 쓰기 작업을 허용하기 전에 read-only discovery와 작은 test update부터 시작하는 것이 좋습니다.

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

Rube MCP 접근 권한이 없거나, Affinity authorization을 완료할 수 없거나, AI client 없이 실행되는 standalone script가 필요하다면 이 skill을 사용하지 마세요. 또한 “fix our CRM”처럼 모호한 정리 요청에도 잘 맞지 않습니다. target objects, matching rules, field rules, review steps를 정의할 수 있어야 합니다.

affinity-automation skill 개선 방법

운영 규칙으로 affinity-automation 프롬프트 개선하기

affinity-automation 결과를 가장 빠르게 개선하는 방법은 프롬프트를 operations runbook처럼 작성하는 것입니다. Affinity object, record source, match key, allowed fields, forbidden fields, duplicate handling, 그리고 에이전트가 실행까지 해도 되는지 또는 계획만 세워야 하는지를 포함하세요. 예: “Find tools for Affinity list membership. Use company domain as the match key. Add missing organizations to the named list. If multiple matches exist, skip and report. Do not create new organizations.”

예방해야 할 흔한 실패 유형

주요 위험은 tool discovery를 건너뛰는 것, 비활성 연결, 오래된 schema 가정, 모호한 record matching, 지나치게 넓은 범위의 쓰기 작업입니다. 이를 막으려면 먼저 RUBE_SEARCH_TOOLS를 요구하고, 에이전트에게 발견된 schema를 보여달라고 요청하며, ACTIVE 연결 상태를 확인하고, 첫 실행은 작은 batch 또는 가능한 경우 dry-run 성격의 plan으로 제한하세요.

첫 출력 이후 반복 개선하기

에이전트의 첫 응답을 받은 뒤 곧바로 실행을 승인하지 마세요. 선택된 Rube tools가 작업에 맞는지, 필수 필드가 채워졌는지, 에이전트가 discovery response의 주의점을 식별했는지 확인해야 합니다. 계획 범위가 너무 넓다면 segment를 좁히세요. 예를 들어 “only records updated in the last 30 days,” “only organizations with a domain,” 또는 “only list members from this source.”처럼 제한할 수 있습니다.

팀에 맞게 skill 확장하기

affinity-automation을 반복적으로 사용하는 팀은 upstream 파일 밖에 로컬 가이드를 추가해 개선할 수 있습니다. 예를 들어 승인된 Affinity field names, naming conventions, list ownership rules, duplicate-resolution policy, 안전한 프롬프트 예시를 정리해둘 수 있습니다. 이러한 추가 내용은 secrets와 분리해 관리하고, Affinity workspace 또는 Composio tool 동작이 바뀔 때 함께 업데이트하세요.