dnanexus-integration
作者 K-Dense-AIdnanexus-integration 是一个面向 DNAnexus 云基因组学工作的实用技能。可用于构建 apps 和 applets、管理上传与下载、运行 workflows，并借助 dxpy 自动化 pipelines。dnanexus-integration 指南适用于涉及 FASTQ、BAM 和 VCF 文件的后端开发任务，同时覆盖平台特定配置和作业执行。
该技能评分为 78/100，说明它是 Agent Skills Finder 中一个相当稳妥的收录候选。目录用户可以从中看到它确实覆盖了真实的 DNAnexus 工作流——apps/applets、数据操作、作业执行、workflows 和 dxpy 使用——因此代理在触发和应用时，比面对一个泛泛的提示词更少靠猜；不过整体仍偏参考型，而不是开箱即用型。
- 覆盖了多个具体的 DNAnexus 工作流，包括应用开发、数据上传/下载、作业执行、workflows 和 dxpy 脚本编写。
- 内容较完整，包含有效 frontmatter、没有占位标记，并提供了多份参考文件，便于逐步获取更多细节。
- 包含明确的使用触发条件，以及针对 FASTQ/BAM/VCF、权限、依赖项和 Docker 相关配置的平台示例。
- SKILL.md 中没有提供安装命令或设置步骤，因此落地使用需要外部的 DNAnexus 上下文支持。
- 支持文件仅为参考资料，没有脚本或资源文件，这会限制代理开箱即用的执行指引。
dnanexus-integration skill 概览
dnanexus-integration 是一项面向 DNAnexus 云端基因组平台的实用 skill，适合在普通 prompt 不够用时使用。它可以帮助你完成 app 和 applet 开发、数据上传下载、workflow 执行，以及基于 dxpy 的基因组分析管线自动化。
dnanexus-integration skill 适合谁
如果你正在围绕 DNAnexus 搭建或维护 Backend Development 自动化，这项 dnanexus-integration skill 很适合你：例如 Python 脚本、pipeline 包装器、app 配置或作业编排。它最适用的场景是任务会接触 FASTQ、BAM 或 VCF 等文件，或者你需要普通代码助手经常遗漏的平台特定行为。
这项 dnanexus-integration skill 能帮你完成什么
它的核心用途，是把一个模糊的平台任务转成可落地的 DNAnexus 实现：创建 app/applet、定义输入输出、运行作业、管理项目，以及安全地操作数据对象。dnanexus-integration 指南在你需要保留 DNAnexus 约定、而不是自己发明一套工作流时，尤其有价值。
为什么这项 skill 不一样
这个 repo 按真实的工作场景组织：app 开发、配置、数据操作、作业执行，以及 Python SDK。这个结构很重要，因为 DNAnexus 的问题常常出在细节上，比如 dxapp.json 的结构、输入链接方式、执行上下文，或者 applet 和 app 的区别。dnanexus-integration skill 的价值就在于：当这些细节会直接决定方案能不能跑起来时，它能给出更可靠的帮助。
如何使用 dnanexus-integration skill
安装并加载这项 skill
如果你使用本地 skills 工作流，可以通过以下命令安装：
npx skills add K-Dense-AI/claude-scientific-skills --skill dnanexus-integration
然后先打开 SKILL.md，因为它定义了预期范围，并指向真正包含可用指导的参考文件。如果你是在更大的 repo 中使用 dnanexus-integration 安装方式，最好把这项 skill 和你的项目上下文放在一起，这样它才能适配你自己的目录结构和部署约束。
从正确的输入形式开始
最好的 dnanexus-integration 使用方式，是先给出具体任务，而不是笼统地说“帮我处理 DNAnexus”。请把对象类型、语言和目标结果说清楚：
- “用 Python 创建一个 DNAnexus applet，接收 BAM 文件和最小 mapping quality，然后输出过滤后的 BAM。”
- “为一个 Bash app 编写
dxapp.json的 inputs 和 runSpec：下载 FASTQ，运行 QC，再上传结果。” - “展示如何用
dxpy通过 linked inputs 启动作业。”
这种细节级别能明显提升输出质量，因为 DNAnexus 的行为取决于执行模型、文件链接方式和部署格式。
先读这些文件
对大多数用户来说，最快的路径是：
SKILL.md：范围说明和适用场景references/app-development.md：构建结构，以及 applet/app 模式references/configuration.md：dxapp.json、元数据和依赖references/data-operations.md：文件、记录和对象处理references/job-execution.md：作业运行与监控references/python-sdk.md：dxpy安装和 API 用法
如果你卡住了，就读和故障点对应的文件：配置问题看 config，运行时问题看 job execution，对象处理问题看 data operations。
更实用的工作流
把 dnanexus-integration 当作实现助手来用：
- 说明你要创建或修改的平台对象。
- 说明你需要的是 applet、app、脚本，还是
dxpy代码片段。 - 提供预期的输入、输出和文件类型。
- 说明你需要本地开发、平台执行，还是两者都要。
- 先要求最小可运行版本，再逐步扩展。
这种工作流能减少猜测，也让结果更容易按 DNAnexus 约定去核对。
dnanexus-integration skill 常见问题
dnanexus-integration 只适合基因组学工作吗？
基本上是。这个 repo 的核心就是 DNAnexus 云端基因组学和生物信息学工作流，因此它最适合管线开发、文件操作，以及这个生态中的平台自动化。
使用它需要有 DNAnexus 经验吗？
不需要，但有基础了解会更顺手。即使是新手，只要能给出明确目标和文件类型，也可以使用 dnanexus-integration skill。相反，如果需求很模糊，或者用户自己也不清楚需要的是 applet、app 还是脚本，这项 skill 的帮助就会小一些。
为什么要用它，而不是普通 prompt？
普通 prompt 也能写代码，但当任务依赖平台规则时，dnanexus-integration 会更合适：比如 dxapp.json、dxpy、项目和文件夹处理、applet 与 app 的行为差异，以及作业启动约定。对于必须在 DNAnexus 上运行的 Backend Development 任务来说，这会更可靠。
什么时候不该用它？
如果任务和 DNAnexus 无关，只需要通用 Python 建议，或者你处理的是完全本地的数据流程、没有平台执行要求，就不要用 dnanexus-integration。这些情况下，通用编程 prompt 会更快。
如何改进 dnanexus-integration skill
把缺失的 DNAnexus 细节补给模型
最大的改进，来自把 repo 自己推断不出来的信息说清楚：文件类型、输入名称、输出位置、执行语言，以及作业是在平台上跑还是由外部脚本触发。对 dnanexus-integration 来说，“一个处理 VCF 文件的 workflow”远不如“一个 Python applet，接收 VCF、sample name 和 Boolean flag，并把结果写到 /out”来得有效。
注意常见失败模式
大多数糟糕输出，问题都出在执行假设不明确：输入链接错了、applet 和 app 混淆了、遗漏 dxapp.json 字段，或者代码没有考虑 DNAnexus 对象生命周期。如果第一版答案显得过于泛泛，就让 dnanexus-integration 指南一次只收敛到一个文件路径或一个作业步骤。
从骨架迭代到生产版本
更有效的改进循环通常是：
- 先要一个最小可运行的 app 或
dxpy示例， - 再要求校验输入和输出，
- 然后补依赖、容器设置或项目处理，
- 最后再要部署或测试指导。
这通常比一上来就要求完整端到端 pipeline 更好，因为 DNAnexus 的失败很多时候是配置驱动的，而不是算法驱动的。
用 repo 文件做检查点
如果生成结果已经接近可用，但还不能部署，先对照 references/configuration.md 和 references/job-execution.md 再改。它们是最快发现元数据不匹配、runSpec 错误，或者对作业状态存在不安全假设的方法；而这正是大多数用户在判断 dnanexus-integration 是否适合自己的 Backend Development 任务时最关心的地方。