dnanexus-integration

dnanexus-integration 스킬 개요

dnanexus-integration은 DNAnexus 클라우드 유전체학 플랫폼을 다룰 때, 단순한 프롬프트보다 더 구체적인 도움이 필요할 때 유용한 실전형 스킬입니다. 앱과 애플릿 개발, 데이터 업로드·다운로드, 워크플로 실행, dxpy 기반 자동화를 통한 유전체 파이프라인 작업을 돕습니다.

이 dnanexus-integration 스킬은 누구에게 적합한가

DNAnexus를 중심으로 Backend Development 자동화를 만들거나 유지보수하는 경우 이 dnanexus-integration 스킬을 사용하세요. 예를 들면 Python 스크립트, 파이프라인 래퍼, 앱 설정, 잡 오케스트레이션 같은 작업입니다. FASTQ, BAM, VCF 같은 파일을 다루거나, 일반적인 코드 सहायता로는 놓치기 쉬운 플랫폼 특화 동작이 필요할 때 특히 유용합니다.

무엇을 해낼 수 있는가

핵심 작업은 대략적인 플랫폼 과제를 실제로 돌아가는 DNAnexus 구현으로 바꾸는 것입니다. 앱/애플릿을 만들고, 입력과 출력을 정의하고, 잡을 실행하고, 프로젝트를 관리하고, 데이터 오브젝트를 안전하게 다루는 흐름까지 연결해 줍니다. 이 dnanexus-integration 가이드는 자체적인 임의 워크플로를 만드는 대신 DNAnexus의 관례를 그대로 유지해야 할 때 특히 중요합니다.

이 스킬이 다른 이유

이 repo는 실제 운영 영역을 기준으로 구성되어 있습니다. 앱 개발, 설정, 데이터 작업, 잡 실행, Python SDK가 그 축입니다. 이런 구조가 중요한 이유는 DNAnexus 작업이 dxapp.json의 형태, 입력 연결 방식, 실행 컨텍스트, 애플릿과 앱의 차이 같은 세부 사항에서 자주 실패하기 때문입니다. dnanexus-integration 스킬은 이런 세부가 실제 실행 가능 여부를 좌우할 때 가치가 있습니다.

dnanexus-integration 스킬 사용 방법

설치하고 스킬 불러오기

로컬 skills 워크플로를 쓴다면 다음 명령으로 설치합니다:

npx skills add K-Dense-AI/claude-scientific-skills --skill dnanexus-integration

그다음에는 먼저 SKILL.md를 여세요. 이 파일이 스킬의 의도된 범위를 정의하고, 실제 작업 지침이 담긴 참고 파일로 연결해 줍니다. 더 큰 repo의 일부로 dnanexus-integration 설치를 사용하는 경우에는, 프로젝트의 폴더 구조와 배포 제약에 맞춰 조정할 수 있도록 스킬을 프로젝트 컨텍스트와 함께 두는 것이 좋습니다.

올바른 입력 형태부터 시작하기

dnanexus-integration을 가장 잘 활용하는 방법은 “DNAnexus 좀 도와줘”처럼 넓은 요청이 아니라, 구체적인 과제로 시작하는 것입니다. 객체 유형, 언어, 목표 결과를 함께 알려 주세요.

• “BAM 파일과 최소 매핑 품질값을 받아 필터링된 BAM을 출력하는 Python DNAnexus 애플릿을 만들어줘.”
• “FASTQ를 다운로드하고 QC를 실행한 뒤 결과를 업로드하는 Bash 앱용 dxapp.json 입력과 runSpec을 작성해줘.”
• “dxpy를 사용해 linked inputs로 workflow job을 실행하는 방법을 보여줘.”

이 정도로 구체적으로 주면 출력 품질이 좋아집니다. DNAnexus의 동작은 실행 모델, 파일 링크 방식, 배포 형식에 크게 좌우되기 때문입니다.

먼저 읽어야 할 파일

대부분의 사용자는 다음 순서가 가장 빠릅니다.

1. 범위와 사용 시점을 설명하는 SKILL.md
2. 빌드 구조와 applet/app 패턴을 다루는 references/app-development.md
3. dxapp.json, 메타데이터, 의존성을 다루는 references/configuration.md
4. 파일, 레코드, 오브젝트 처리를 다루는 references/data-operations.md
5. 잡 실행과 모니터링을 다루는 references/job-execution.md
6. dxpy 설치와 API 사용법을 다루는 references/python-sdk.md

막히는 지점이 있다면 실패 지점과 맞는 파일부터 읽으세요. 빌드 오류면 설정 파일, 런타임 문제면 잡 실행, 오브젝트 처리 문제면 데이터 작업 문서를 보는 식입니다.

더 나은 결과를 위한 실용적인 워크플로

dnanexus-integration은 구현 보조 도구처럼 쓰는 것이 좋습니다.

1. 만들거나 수정할 플랫폼 오브젝트를 설명합니다.
2. applet, app, script, dxpy 스니펫 중 무엇이 필요한지 밝힙니다.
3. 예상 입력, 출력, 파일 형식을 적습니다.
4. 로컬 개발, 플랫폼 실행, 또는 둘 다 필요한지 말합니다.
5. 먼저 최소 동작 버전을 요청한 뒤, 그다음 확장합니다.

이 워크플로는 추측을 줄이고, 결과를 DNAnexus 관례에 맞춰 검증하기 쉽게 만듭니다.

dnanexus-integration 스킬 FAQ

dnanexus-integration은 유전체학 작업에만 쓰이나요?

대체로 그렇습니다. 이 repository는 DNAnexus 클라우드 유전체학과 바이오인포매틱스 워크플로에 중심을 두고 있어, 그 생태계 안에서의 파이프라인 개발, 파일 작업, 플랫폼 자동화에 가장 잘 맞습니다.

DNAnexus 경험이 없어도 사용할 수 있나요?

가능하지만, 기본적인 이해가 있으면 더 좋습니다. 초보자도 구체적인 목표와 파일 유형을 제시하면 dnanexus-integration 스킬을 활용할 수 있습니다. 반면 요청이 모호하거나, applet·app·script 중 무엇이 필요한지 모를 때는 이 스킬의 도움이 크게 줄어듭니다.

일반 프롬프트 대신 왜 이것을 쓰나요?

일반 프롬프트도 코드를 초안 수준으로는 만들 수 있습니다. 하지만 dnanexus-integration은 dxapp.json, dxpy, 프로젝트·폴더 처리, applet과 app의 차이, 잡 실행 규칙처럼 플랫폼 고유 규칙이 중요한 작업에서 더 강합니다. 그래서 DNAnexus에서 실제로 실행되어야 하는 Backend Development 작업에는 더 신뢰할 수 있습니다.

언제는 사용하지 말아야 하나요?

작업이 DNAnexus와 무관하거나, 단순한 Python 조언만 필요하거나, 플랫폼 실행 없이 로컬 전용 데이터 처리만 하는 경우에는 dnanexus-integration을 쓰지 마세요. 그런 상황에서는 일반 코딩 프롬프트가 더 빠릅니다.

dnanexus-integration 스킬 개선 방법

모델이 모르는 DNAnexus 세부 정보를 알려주기

가장 큰 개선 효과는 저장소가 스스로 추론하지 못하는 정보를 채워 주는 데서 나옵니다. 파일 유형, 입력 이름, 출력 위치, 실행 언어, 그리고 잡이 플랫폼에서 도는지 외부 스크립트에서 도는지까지 명시하세요. dnanexus-integration 사용에서 “VCF 파일을 처리하는 workflow”보다 “VCF, sample name, Boolean flag를 받아 /out에 결과를 쓰는 Python 애플릿”이 훨씬 낫습니다.

자주 실패하는 지점을 주의하기

출력이 나쁜 경우는 대부분 실행 가정이 너무 부족해서 생깁니다. 입력 연결을 잘못했거나, applet과 app을 혼동했거나, dxapp.json 필드를 빠뜨렸거나, DNAnexus 오브젝트 수명주기를 무시한 코드를 작성한 경우입니다. 첫 답변이 너무 일반적이면, dnanexus-integration 가이드에 한 번에 하나의 파일 경로나 하나의 잡 단계만 다루도록 좁혀 달라고 하세요.

뼈대에서 운영 단계로 점진적으로 확장하기

좋은 개선 루프는 다음과 같습니다.

• 먼저 최소 동작 app 또는 dxpy 예제를 요청한다.
• 다음으로 입력과 출력 검증을 요청한다.
• 그다음 의존성, 컨테이너 설정, 프로젝트 처리 내용을 추가한다.
• 마지막으로 배포나 테스트 지침을 요청한다.

DNAnexus의 실패는 알고리즘보다 설정에서 생기는 경우가 많기 때문에, 한 번에 완성형 엔드투엔드 파이프라인을 요구하는 것보다 보통 이 방식이 더 낫습니다.

repo 파일을 점검 기준으로 활용하기

생성된 답변이 거의 맞지만 바로 배포할 수는 없다면, 수정하기 전에 references/configuration.md와 references/job-execution.md를 대조해 보세요. 메타데이터 불일치, 잘못된 run specification, 잡 상태에 대한 위험한 가정 같은 문제를 가장 빨리 잡아낼 수 있는 자료입니다. 이것이야말로 많은 사용자가 dnanexus-integration이 자신의 Backend Development 작업에 맞는지 판단할 때 가장 중요하게 보는 부분입니다.