dnanexus-integration
作成者 K-Dense-AIdnanexus-integration は、DNAnexus のクラウドゲノミクス作業に役立つ実践的なスキルです。アプリやアプレットの作成、アップロード／ダウンロードの管理、ワークフローの実行、`dxpy` を使ったパイプラインの自動化に活用できます。dnanexus-integration のガイドは、FASTQ、BAM、VCF ファイルを扱う Backend 開発タスクに加え、プラットフォーム固有の設定やジョブ実行もサポートします。
このスキルは 78/100 で、Agent Skills Finder に載せる候補として十分に有力です。アプリ／アプレット、データ操作、ジョブ実行、ワークフロー、`dxpy` の利用まで、実際の DNAnexus ワークフローをカバーしていることが読み取れるため、エージェントは汎用的なプロンプトよりも迷いなく適用しやすくなります。ただし、内容はどちらかというと参照向けで、すぐに使える完成形というよりはガイド寄りです。
- アプリ開発、データのアップロード／ダウンロード、ジョブ実行、ワークフロー、`dxpy` スクリプトまで、具体的な DNAnexus ワークフローを複数カバーしている。
- 有効な frontmatter を備え、プレースホルダーもなく、段階的に詳細が増える参考ファイルが複数あるなど、実運用に足る情報量がある。
- FASTQ/BAM/VCF、権限、依存関係、Docker 関連のセットアップに関する明確な利用トリガーと、プラットフォーム固有の例が含まれている。
- SKILL.md にはインストールコマンドやセットアップ手順がないため、導入には外部の DNAnexus 知識が必要になる。
- 補助ファイルは参照用のみで、スクリプトやアセットがないため、エージェントがそのまま実行手順までたどり着くには限界がある。
dnanexus-integration スキルの概要
dnanexus-integration は、DNAnexus のクラウドゲノミクスプラットフォームを扱うときに、一般的なプロンプト以上の支援が必要な場合に役立つ実用的なスキルです。アプリや applet の開発、データのアップロード／ダウンロード、ワークフロー実行、そしてゲノミクスパイプラインの dxpy ベースの自動化を支援します。
この dnanexus-integration スキルは誰向けか
DNAnexus まわりの Backend Development 自動化を構築・保守しているなら、この dnanexus-integration スキルを使ってください。たとえば、Python スクリプト、パイプラインラッパー、アプリ設定、ジョブオーケストレーションなどです。FASTQ、BAM、VCF のようなファイルを扱うタスクや、通常のコード支援では見落とされがちなプラットフォーム固有の挙動が必要な場合に、特に力を発揮します。
何ができるようになるか
主な役割は、ざっくりしたプラットフォーム作業を、実行可能な DNAnexus 実装に落とし込むことです。app/applet の作成、入力と出力の定義、ジョブ実行、プロジェクト管理、データオブジェクトを安全に扱うための具体化を支援します。dnanexus-integration のガイドが特に重要なのは、独自のワークフローを勝手に作るのではなく、DNAnexus の作法を守る必要がある場面です。
このスキルが他と違う理由
リポジトリは、アプリ開発、設定、データ操作、ジョブ実行、Python SDK という実際の作業領域ごとに整理されています。この構成が重要なのは、DNAnexus の作業は dxapp.json の形、入力のリンク、実行コンテキスト、applet と app の違いといった細部で失敗しやすいからです。dnanexus-integration スキルは、そうした細部が本当に動くかどうかを左右する場面で価値があります。
dnanexus-integration スキルの使い方
インストールして読み込む
ローカルのスキル運用では、次のコマンドでインストールします。
npx skills add K-Dense-AI/claude-scientific-skills --skill dnanexus-integration
その後はまず SKILL.md を開いてください。想定スコープがそこに書かれており、実際の作業手順が載っている参照ファイルへの入口になっています。dnanexus-integration のインストールを大きなリポジトリの一部として使うなら、プロジェクトの文脈と並べて置き、自分のフォルダ構成やデプロイ条件に合わせて運用できるようにしておくのがよいでしょう。
まずは正しい入力の形から始める
dnanexus-integration をうまく使うコツは、「DNAnexus の手伝いをして」といった大ざっぱな依頼ではなく、具体的なタスクを最初に出すことです。対象オブジェクト、言語、最終成果を明示してください。
- 「BAM ファイルと最小マッピング品質を受け取り、フィルタ済み BAM を出力する Python の DNAnexus applet を作ってください」
- 「FASTQ をダウンロードして QC を実行し、結果をアップロードする Bash app 用の
dxapp.jsoninputs と runSpec を書いてください」 - 「
dxpyを使って linked inputs 付きの workflow job を起動する方法を示してください」
DNAnexus の挙動は、実行モデル、ファイルのリンク方法、デプロイ形式に左右されるため、このレベルまで具体化すると出力の質が上がります。
先に読むべきファイル
多くの人にとって、最短ルートは次の順です。
SKILL.md— スコープと使いどころreferences/app-development.md— ビルド構成と applet/app のパターンreferences/configuration.md—dxapp.json、メタデータ、依存関係references/data-operations.md— file、record、object の扱いreferences/job-execution.md— ジョブの実行と監視references/python-sdk.md—dxpyのインストールと API 利用
行き詰まったら、失敗箇所に対応するファイルを読みます。ビルドエラーなら config、実行時の問題なら job execution、オブジェクトの取り扱いなら data operations です。
より良い結果を得るための実用ワークフロー
dnanexus-integration は、実装アシスタントのように使うのが効果的です。
- 作成または変更したいプラットフォームオブジェクトを説明する
- applet、app、スクリプト、
dxpyのどれが必要かを明示する - 期待する入力、出力、ファイル種別を伝える
- ローカル開発、プラットフォーム実行、または両方が必要かを書く
- まずは最小の動く版を依頼し、その後で拡張する
この流れにすると推測が減り、生成結果を DNAnexus の作法に照らして確認しやすくなります。
dnanexus-integration スキル FAQ
dnanexus-integration はゲノミクス用途だけか
基本的にはそうです。リポジトリは DNAnexus のクラウドゲノミクスとバイオインフォマティクスのワークフローに焦点を当てているため、そのエコシステムでのパイプライン開発、ファイル操作、プラットフォーム自動化に最も向いています。
DNAnexus の経験がなくても使えるか
使えますが、基本的な理解があるとよりスムーズです。初心者でも、具体的なゴールとファイル種別を示せば dnanexus-integration スキルは活用できます。どの applet、app、スクリプトが必要か分からないような曖昧な依頼では、あまり役に立ちません。
普通のプロンプトではなく、これを使う理由は何か
普通のプロンプトでもコードは書けますが、dnanexus-integration は dxapp.json、dxpy、project と folder の扱い、applet と app の違い、ジョブ起動の作法など、プラットフォーム固有のルールに依存するタスクでより強みがあります。DNAnexus 上で確実に動く必要がある Backend Development の作業では、その分信頼性が高くなります。
どんなときに使わないべきか
タスクが DNAnexus と無関係な場合、一般的な Python の助言だけが欲しい場合、あるいはプラットフォーム実行を必要としないローカル専用のデータ処理をしている場合は、dnanexus-integration は使わないでください。そのようなケースでは、一般的なコーディング用プロンプトのほうが早いです。
dnanexus-integration スキルの改善方法
足りない DNAnexus 情報を明示する
最も効果が大きいのは、リポジトリが自動では推測できない情報を指定することです。たとえば、ファイル種別、入力名、出力先、実行言語、ジョブがプラットフォーム上で動くのか外部スクリプトから実行されるのか、といった点です。dnanexus-integration の使い方としては、「VCF ファイルを処理する workflow」よりも、「VCF、sample name、Boolean flag を受け取り、結果を /out に書き出す Python applet」のほうがはるかに有効です。
よくある失敗パターンに注意する
不出来な出力の多くは、実行前提の指定が足りないことが原因です。入力のリンクが間違っている、applet と app を混同している、dxapp.json の項目が抜けている、DNAnexus の object lifecycle を無視したコードを書いている、などが典型です。最初の回答が一般論に寄っているなら、dnanexus-integration のガイドに対して、1つのファイルパスか 1つのジョブステップに絞って答えるよう頼んでください。
骨組みから本番形へ段階的に進める
改善の進め方として強いのは、次の順番です。
- まず最小構成の app か
dxpyの例を依頼する - 次に入力と出力の妥当性を確認してもらう
- その後で依存関係、コンテナ設定、project の扱いを追加する
- 最後にデプロイやテストの指針を求める
DNAnexus の失敗はアルゴリズムより設定に起因することが多いため、最初から end-to-end のパイプラインを一気に求めるより、この進め方のほうがたいていうまくいきます。
リポジトリファイルを確認ポイントとして使う
生成結果がかなり近いのにデプロイできない場合は、編集する前に references/configuration.md と references/job-execution.md を照合してください。メタデータの不一致、run specification の誤り、ジョブ状態に関する危険な仮定を見つける最短ルートです。これは、dnanexus-integration が自分の Backend Development タスクに本当に使えるかどうかを見極めたい人にとって、最も重要な確認作業です。