dnanexus-integration

Tổng quan về skill dnanexus-integration

dnanexus-integration là một skill thực tiễn để làm việc với nền tảng genomics đám mây DNAnexus khi bạn cần nhiều hơn một prompt chung chung. Skill này hỗ trợ phát triển app và applet, tải lên và tải xuống dữ liệu, thực thi workflow, và tự động hóa pipeline genomics bằng dxpy.

Skill dnanexus-integration này dành cho ai

Hãy dùng skill dnanexus-integration nếu bạn đang xây dựng hoặc duy trì các tác vụ tự động hóa Backend Development xoay quanh DNAnexus: script Python, wrapper cho pipeline, cấu hình app, hoặc điều phối job. Skill này hữu ích nhất khi tác vụ của bạn chạm tới các file như FASTQ, BAM, hoặc VCF, hoặc khi bạn cần hành vi đặc thù của nền tảng mà hỗ trợ code thông thường thường bỏ sót.

Skill này giúp bạn hoàn thành việc gì

Nhiệm vụ chính là biến một bài toán nền tảng còn sơ sài thành một triển khai DNAnexus khả thi: tạo app/applet, định nghĩa input và output, chạy job, quản lý project, và tương tác an toàn với các đối tượng dữ liệu. Hướng dẫn dnanexus-integration đặc biệt phù hợp khi bạn cần giữ đúng quy ước của DNAnexus thay vì tự bịa ra workflow riêng.

Vì sao skill này khác biệt

Repo được tổ chức theo các mảng vận hành thực tế: phát triển app, cấu hình, thao tác dữ liệu, thực thi job, và Python SDK. Cấu trúc đó quan trọng vì công việc với DNAnexus thường hỏng ở những chi tiết như hình dạng của dxapp.json, cách liên kết input, ngữ cảnh thực thi, hoặc sự khác nhau giữa applet và app. Skill dnanexus-integration đặc biệt hữu ích khi những chi tiết này quyết định liệu giải pháp có thực sự chạy được hay không.

Cách sử dụng skill dnanexus-integration

Cài đặt và nạp skill

Với quy trình skill cục bộ, cài bằng:

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

Sau đó mở SKILL.md trước, vì file này xác định phạm vi sử dụng và chỉ tới các file tham chiếu chứa hướng dẫn vận hành thực tế. Nếu bạn đang dùng bản cài dnanexus-integration trong một repo lớn hơn, hãy để skill đi cùng ngữ cảnh dự án của bạn để nó thích nghi với cấu trúc thư mục và ràng buộc triển khai riêng.

Bắt đầu bằng đúng hình dạng đầu vào

Cách dùng dnanexus-integration hiệu quả nhất là bắt đầu bằng một nhiệm vụ cụ thể, không phải một yêu cầu chung kiểu “giúp tôi với DNAnexus”. Hãy cho model biết loại đối tượng, ngôn ngữ, và kết quả mong muốn:

• “Tạo một DNAnexus applet bằng Python nhận một file BAM và một ngưỡng mapping quality tối thiểu, rồi xuất ra BAM đã lọc.”
• “Viết phần input và runSpec trong dxapp.json cho một Bash app tải FASTQ, chạy QC, rồi tải kết quả lên.”
• “Chỉ cách khởi chạy một workflow job với linked inputs bằng dxpy.”

Mức độ chi tiết đó giúp nâng chất lượng đầu ra vì hành vi DNAnexus phụ thuộc vào mô hình thực thi, cách liên kết file, và định dạng triển khai.

Đọc các file này trước

Với đa số người dùng, lộ trình nhanh nhất là:

1. SKILL.md để xem phạm vi và hướng dẫn khi nào nên dùng
2. references/app-development.md để xem cấu trúc build và các mẫu applet/app
3. references/configuration.md để xem dxapp.json, metadata, và dependencies
4. references/data-operations.md để xem cách xử lý file, record, và object
5. references/job-execution.md để xem cách chạy và theo dõi job
6. references/python-sdk.md để xem cách cài dxpy và dùng API

Nếu bạn bị kẹt, hãy đọc file khớp với điểm lỗi: config cho lỗi build, job execution cho lỗi runtime, data operations cho vấn đề xử lý object.

Quy trình làm việc thực tế để có kết quả tốt hơn

Hãy dùng dnanexus-integration như một trợ lý triển khai:

1. Mô tả object nền tảng bạn đang tạo hoặc chỉnh sửa.
2. Nói rõ bạn cần applet, app, script, hay một đoạn dxpy.
3. Cung cấp input, output, và kiểu file dự kiến.
4. Cho biết bạn cần phát triển cục bộ, thực thi trên nền tảng, hay cả hai.
5. Trước tiên yêu cầu phiên bản nhỏ nhất có thể chạy được, rồi mới mở rộng.

Quy trình này giảm đoán mò và giúp prompt đầu ra dễ đối chiếu hơn với quy ước DNAnexus.

Câu hỏi thường gặp về skill dnanexus-integration

dnanexus-integration chỉ dành cho công việc genomics thôi à?

Phần lớn là đúng. Repo này tập trung vào DNAnexus cloud genomics và bioinformatics workflows, nên phù hợp nhất cho phát triển pipeline, thao tác file, và tự động hóa nền tảng trong hệ sinh thái đó.

Tôi có cần kinh nghiệm DNAnexus để dùng không?

Không, nhưng biết cơ bản sẽ rất hữu ích. Người mới vẫn có thể dùng skill dnanexus-integration nếu họ cung cấp mục tiêu cụ thể và loại file. Skill này kém hữu ích hơn khi yêu cầu quá mơ hồ hoặc khi người dùng chưa biết mình cần applet, app, hay script.

Vì sao dùng cái này thay vì prompt thông thường?

Một prompt thông thường có thể phác thảo code, nhưng dnanexus-integration tốt hơn khi nhiệm vụ phụ thuộc vào các quy tắc đặc thù của nền tảng: dxapp.json, dxpy, xử lý project và folder, sự khác nhau giữa applet và app, và quy ước khởi chạy job. Điều đó làm cho nó đáng tin hơn cho các tác vụ Backend Development phải chạy trên DNAnexus.

Khi nào tôi không nên dùng nó?

Đừng dùng dnanexus-integration nếu tác vụ của bạn không liên quan đến DNAnexus, nếu bạn chỉ cần lời khuyên Python chung chung, hoặc nếu bạn đang làm xử lý dữ liệu chỉ chạy cục bộ mà không cần thực thi trên nền tảng. Trong các trường hợp đó, một prompt lập trình tổng quát sẽ nhanh hơn.

Cách cải thiện skill dnanexus-integration

Cung cấp cho model các chi tiết DNAnexus còn thiếu

Cải thiện lớn nhất đến từ việc nêu rõ những gì repo không thể tự suy ra: loại file, tên input, vị trí output, ngôn ngữ thực thi, và việc job chạy trên nền tảng hay từ một script bên ngoài. Với cách dùng dnanexus-integration, “một workflow xử lý các file VCF” yếu hơn nhiều so với “một Python applet nhận VCF, tên sample, và một cờ Boolean, rồi ghi kết quả vào /out.”

Theo dõi các kiểu lỗi phổ biến

Phần lớn đầu ra kém xuất phát từ giả định thực thi bị mô tả quá sơ sài: liên kết input sai, lẫn lộn applet với app, thiếu các field của dxapp.json, hoặc viết code bỏ qua vòng đời của DNAnexus object. Nếu câu trả lời đầu tiên nghe quá chung chung, hãy yêu cầu hướng dẫn dnanexus-integration thu hẹp xuống một file path hoặc một bước job tại một thời điểm.

Lặp từ khung sườn đến sản phẩm

Một vòng lặp cải thiện hiệu quả là:

• trước hết yêu cầu ví dụ app tối thiểu chạy được hoặc ví dụ dxpy,
• sau đó nhờ kiểm tra input và output,
• tiếp theo thêm dependencies, cài đặt container, hoặc xử lý project,
• cuối cùng mới hỏi hướng dẫn triển khai hoặc test.

Cách này thường tốt hơn việc yêu cầu luôn một pipeline end-to-end hoàn chỉnh trong một lần, vì lỗi DNAnexus thường đến từ cấu hình hơn là từ thuật toán.

Dùng các file của repo làm mốc kiểm tra

Nếu câu trả lời sinh ra đã gần đúng nhưng chưa triển khai được, hãy đối chiếu nó với references/configuration.md và references/job-execution.md trước khi sửa. Hai file này là cách nhanh nhất để phát hiện metadata lệch, runSpec sai, hoặc giả định không an toàn về trạng thái job — đúng thứ mà đa số người dùng quan tâm khi quyết định liệu dnanexus-integration có phù hợp với tác vụ Backend Development của họ hay không.