[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7FAVJVSASV97K3726GS4Y3G":3,"skill-same:01M7FAVJVSASV97K3726GS4Y3G":67},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":28,"commitSha":29,"skillDirectory":30,"forksCount":31,"repositoryHtmlUrl":32,"repositoryHomepageUrl":6,"ownerHtmlUrl":33,"ownerBlogUrl":6,"ownerDescription":34,"updatedAt":35,"install":36,"resources":48},"01M7FAVJVSASV97K3726GS4Y3G","output-and-integrity",null,"Safely plan and validate ncbi-genome-download output layout, checksums, cache behavior, retries, concurrency, metadata tables, and human-readable links without causing unintended genome downloads.","lza6\u002FArmor-piercing-system-prompts","lza6","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F128880206?v=4","01M7EB3K7WPX5T28EJ2NVHE6EG","Chinese-tingfeng","01M7EB3K97E1KQ16QWKJMFNGX8",11,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F06-前端与设计\u002Fncbi-genome-download\u002Fsub-skills\u002Foutput-and-integrity\u002FSKILL.md",[],[],"2026-11-16 10:05:34",false,"---\nname: output-and-integrity\ndescription: \"Safely plan and validate ncbi-genome-download output layout,\n  checksums, cache behavior, retries, concurrency, metadata tables, and\n  human-readable links without causing unintended genome downloads.\"\ndisable-model-invocation: true\nmetadata:\n  disco-role: operating\nlicense: Apache 2.0\n---\n\n# Output and integrity\n\nUse this skill after the candidate set and filters are already known. It owns\nwhere files go, how an existing file is judged reusable, how MD5SUMS and\nmetadata are handled, and how to recover from an interrupted or partial run.\nFor selecting assemblies, formats, sections, and taxonomic filters, route to\n[download-and-filter](..\u002Fdownload-and-filter\u002FSKILL.md). For ETE3-based taxonomy\nexpansion, route to [taxonomy-helper](..\u002Ftaxonomy-helper\u002FSKILL.md).\n\nThe facts here target the installed `ncbi-genome-download` **0.3.4** package\n(the package uses `requests`, `tqdm`, and `appdirs`). Prefer a dry run or a\nmocked local response before any real network operation.\n\n## Safety boundary: know which phase has side effects\n\n- `--dry-run`\u002F`-n` still obtains and parses each assembly summary needed to\n  select candidates. It prints accession, organism, and strain, returns `0`,\n  and does **not** create output directories, fetch `md5checksums.txt`, or\n  fetch genome files. It can therefore still make summary-network requests\n  unless a usable summary cache is explicitly enabled through the Python API.\n- A normal run fetches summaries, then checksum manifests, then selected files.\n  It creates directories and may replace files and symlinks. Use a temporary\n  output directory and mocked URLs for verification.\n- `--no-cache`\u002F`-N` disables the assembly-summary cache. In 0.3.4 the CLI\n  default is also `use_cache=False` (the Python API can pass\n  `use_cache=True`); do not assume the README's cache wording overrides the\n  installed defaults. This cache is separate from per-assembly `MD5SUMS`.\n- `--md5-cache-days N` controls how long a nested-output `MD5SUMS` file is\n  trusted. It does not make downloaded genome files expire, and it does not\n  cache checksums in flat-output mode.\n\nBefore a real run, inspect the resolved config and do a dry run, for example:\n\n```bash\nncbi-genome-download --dry-run --assembly-accessions GCF_000203835.1 \\\n  --formats genbank --output-folder .\u002Fngd-scratch bacteria\n```\n\nThe accession above is only a selection example; do not remove `--dry-run`\nunless the source and destination are intentionally approved. A small mocked\nsummary\u002Fchecksum\u002Ffile fixture should be used to test a normal run. Never use a\nlive NCBI URL in a validation example.\n\n## Operating procedure\n\n1. Route selection and filter questions to the sibling skill, then record the\n   exact formats and destination. Decide nested versus flat before starting.\n2. Run a dry run and confirm that the candidate count is nonzero. An empty\n   candidate selection is a controlled result with return code `1`, not a\n   reason to broaden filters automatically.\n3. For a fixture run, provide a local\u002Fmock HTTP response for the summary,\n   `md5checksums.txt`, and each selected file. Keep the output under a fresh\n   temporary directory and use one format first.\n4. Check the expected file path, the MD5 comparison, and (if requested) the\n   metadata TSV. Only then consider parallelism or a larger approved run.\n5. On a rerun, let checksum comparison decide whether a file is reusable.\n   Do not call a partial file “resumed”: this implementation has no HTTP range\n   resume. A missing or mismatching file is downloaded again.\n6. If a connection exception escapes selection or a worker, the command uses\n   return code `75` (temporary failure); retry the command with bounded\n   `--retries N`. A checksum mismatch causes the worker to return false, but\n   0.3.4 does not aggregate worker booleans into the final status; inspect the\n   log and files rather than treating code `0` as proof every file passed.\n\n## Lower-level API map\n\n- `NgdConfig`\u002F`NgdConfig.from_kwargs(...)` holds `output`, `flat_output`,\n  `human_readable`, `parallel`, `progress_bar`, `metadata_table`, `dry_run`,\n  `use_cache`, and `md5_cache_days`. `download(**kwargs)` returns the same\n  integer status as the CLI path.\n- `create_dir(entry, section, domain, output, flat_output)` makes and returns\n  the nested assembly directory or the output root in flat mode.\n- `create_readable_dir(...)` makes the human-readable directory. It does not\n  copy data; later jobs make links.\n- `DownloadJob(full_url, local_file, expected_checksum, symlink_path)` is the\n  unit consumed by `worker`. A normal job has a URL and expected MD5. A\n  symlink-only job has `full_url=None` and does not belong in metadata rows.\n- `parse_checksums(text)` returns dictionaries with `checksum` and `file`,\n  ignores blank\u002Fmalformed lines, and strips a leading `.\u002F` from filenames.\n- `md5sum(path)` hashes the file in 4096-byte chunks. `has_file_changed(...)`\n  returns true for a missing file or an MD5 mismatch. `save_and_check(...)`\n  writes response chunks and then compares MD5; it is not atomic.\n- `metadata.get(columns=None)` returns a process-global `MetaData` object;\n  `metadata.clear()` resets it. `MetaData.add(entry, local_file)` queues a\n  row and `MetaData.write(handle)` emits TSV. Clear it between multiple API\n  runs in one interpreter.\n\nRead the focused references in this order: [output layout](references\u002Foutput-layout.md),\n[checksums and reruns](references\u002Fchecksums-resume.md), [metadata and concurrency](references\u002Fmetadata-and-concurrency.md),\nand [troubleshooting](references\u002Ftroubleshooting.md). They cross-link back\nhere and to the two routing siblings.\n\n## Return-code and verification contract\n\n| Status | Meaning in 0.3.4 | Safe response |\n|---|---|---|\n| `0` | Candidate processing completed without a caught connection exception; dry runs also use it. | Inspect expected files, MD5, links, and TSV; do not infer that every worker returned true. |\n| `1` | No candidates matched, or a parallel run was interrupted by `KeyboardInterrupt`. | Fix filters or preserve the partial output and rerun; do not delete valid files blindly. |\n| `75` | A `requests` connection\u002Fchunked-transfer failure reached `config_download`; the CLI may retry. | Retry with a bounded count after checking connectivity and disk state. |\n\nA `ValueError` raised while parsing CLI configuration is printed by the\nentrypoint and may be returned as `-2`; this is an invalid invocation rather\nthan a download result. The normal operating checks required here remain the\nthree statuses above.\n\n## Bundled-script inventory\n\nNo bundled script is included. A checksum smoke script would duplicate a few\nfour-line fixture assertions and could encourage treating a successful helper\nas proof of a network run. The self-contained fixture procedure in\n[checksums and reruns](references\u002Fchecksums-resume.md) exercises parsing,\nfilename selection, MD5, `save_and_check`, output paths, and TSV without\nnetwork access; it is the safer reusable check.\n","# Output and integrity\n\nUse this skill after the candidate set and filters are already known. It owns\nwhere files go, how an existing file is judged reusable, how MD5SUMS and\nmetadata are handled, and how to recover from an interrupted or partial run.\nFor selecting assemblies, formats, sections, and taxonomic filters, route to\n[download-and-filter](..\u002Fdownload-and-filter\u002FSKILL.md). For ETE3-based taxonomy\nexpansion, route to [taxonomy-helper](..\u002Ftaxonomy-helper\u002FSKILL.md).\n\nThe facts here target the installed `ncbi-genome-download` **0.3.4** package\n(the package uses `requests`, `tqdm`, and `appdirs`). Prefer a dry run or a\nmocked local response before any real network operation.\n\n## Safety boundary: know which phase has side effects\n\n- `--dry-run`\u002F`-n` still obtains and parses each assembly summary needed to\n  select candidates. It prints accession, organism, and strain, returns `0`,\n  and does **not** create output directories, fetch `md5checksums.txt`, or\n  fetch genome files. It can therefore still make summary-network requests\n  unless a usable summary cache is explicitly enabled through the Python API.\n- A normal run fetches summaries, then checksum manifests, then selected files.\n  It creates directories and may replace files and symlinks. Use a temporary\n  output directory and mocked URLs for verification.\n- `--no-cache`\u002F`-N` disables the assembly-summary cache. In 0.3.4 the CLI\n  default is also `use_cache=False` (the Python API can pass\n  `use_cache=True`); do not assume the README's cache wording overrides the\n  installed defaults. This cache is separate from per-assembly `MD5SUMS`.\n- `--md5-cache-days N` controls how long a nested-output `MD5SUMS` file is\n  trusted. It does not make downloaded genome files expire, and it does not\n  cache checksums in flat-output mode.\n\nBefore a real run, inspect the resolved config and do a dry run, for example:\n\n```bash\nncbi-genome-download --dry-run --assembly-accessions GCF_000203835.1 \\\n  --formats genbank --output-folder .\u002Fngd-scratch bacteria\n```\n\nThe accession above is only a selection example; do not remove `--dry-run`\nunless the source and destination are intentionally approved. A small mocked\nsummary\u002Fchecksum\u002Ffile fixture should be used to test a normal run. Never use a\nlive NCBI URL in a validation example.\n\n## Operating procedure\n\n1. Route selection and filter questions to the sibling skill, then record the\n   exact formats and destination. Decide nested versus flat before starting.\n2. Run a dry run and confirm that the candidate count is nonzero. An empty\n   candidate selection is a controlled result with return code `1`, not a\n   reason to broaden filters automatically.\n3. For a fixture run, provide a local\u002Fmock HTTP response for the summary,\n   `md5checksums.txt`, and each selected file. Keep the output under a fresh\n   temporary directory and use one format first.\n4. Check the expected file path, the MD5 comparison, and (if requested) the\n   metadata TSV. Only then consider parallelism or a larger approved run.\n5. On a rerun, let checksum comparison decide whether a file is reusable.\n   Do not call a partial file “resumed”: this implementation has no HTTP range\n   resume. A missing or mismatching file is downloaded again.\n6. If a connection exception escapes selection or a worker, the command uses\n   return code `75` (temporary failure); retry the command with bounded\n   `--retries N`. A checksum mismatch causes the worker to return false, but\n   0.3.4 does not aggregate worker booleans into the final status; inspect the\n   log and files rather than treating code `0` as proof every file passed.\n\n## Lower-level API map\n\n- `NgdConfig`\u002F`NgdConfig.from_kwargs(...)` holds `output`, `flat_output`,\n  `human_readable`, `parallel`, `progress_bar`, `metadata_table`, `dry_run`,\n  `use_cache`, and `md5_cache_days`. `download(**kwargs)` returns the same\n  integer status as the CLI path.\n- `create_dir(entry, section, domain, output, flat_output)` makes and returns\n  the nested assembly directory or the output root in flat mode.\n- `create_readable_dir(...)` makes the human-readable directory. It does not\n  copy data; later jobs make links.\n- `DownloadJob(full_url, local_file, expected_checksum, symlink_path)` is the\n  unit consumed by `worker`. A normal job has a URL and expected MD5. A\n  symlink-only job has `full_url=None` and does not belong in metadata rows.\n- `parse_checksums(text)` returns dictionaries with `checksum` and `file`,\n  ignores blank\u002Fmalformed lines, and strips a leading `.\u002F` from filenames.\n- `md5sum(path)` hashes the file in 4096-byte chunks. `has_file_changed(...)`\n  returns true for a missing file or an MD5 mismatch. `save_and_check(...)`\n  writes response chunks and then compares MD5; it is not atomic.\n- `metadata.get(columns=None)` returns a process-global `MetaData` object;\n  `metadata.clear()` resets it. `MetaData.add(entry, local_file)` queues a\n  row and `MetaData.write(handle)` emits TSV. Clear it between multiple API\n  runs in one interpreter.\n\nRead the focused references in this order: [output layout](references\u002Foutput-layout.md),\n[checksums and reruns](references\u002Fchecksums-resume.md), [metadata and concurrency](references\u002Fmetadata-and-concurrency.md),\nand [troubleshooting](references\u002Ftroubleshooting.md). They cross-link back\nhere and to the two routing siblings.\n\n## Return-code and verification contract\n\n| Status | Meaning in 0.3.4 | Safe response |\n|---|---|---|\n| `0` | Candidate processing completed without a caught connection exception; dry runs also use it. | Inspect expected files, MD5, links, and TSV; do not infer that every worker returned true. |\n| `1` | No candidates matched, or a parallel run was interrupted by `KeyboardInterrupt`. | Fix filters or preserve the partial output and rerun; do not delete valid files blindly. |\n| `75` | A `requests` connection\u002Fchunked-transfer failure reached `config_download`; the CLI may retry. | Retry with a bounded count after checking connectivity and disk state. |\n\nA `ValueError` raised while parsing CLI configuration is printed by the\nentrypoint and may be returned as `-2`; this is an invalid invocation rather\nthan a download result. The normal operating checks required here remain the\nthree statuses above.\n\n## Bundled-script inventory\n\nNo bundled script is included. A checksum smoke script would duplicate a few\nfour-line fixture assertions and could encourage treating a successful helper\nas proof of a network run. The self-contained fixture procedure in\n[checksums and reruns](references\u002Fchecksums-resume.md) exercises parsing,\nfilename selection, MD5, `save_and_check`, output paths, and TSV without\nnetwork access; it is the safer reusable check.\n",{"name":5,"license":24,"metadata":25,"description":7,"disable-model-invocation":27},"Apache 2.0",{"disco-role":26},"operating",true,"main","d69096e239f2a89aabc2cd078c47664a9d3b1e11","06-前端与设计\u002Fncbi-genome-download\u002Fsub-skills\u002Foutput-and-integrity",3,"https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts","https:\u002F\u002Fgithub.com\u002Flza6","个人vx：Tf00798\r\n个人✈：@TFGY999","2026-10-08 14:29:22",{"source":8,"skillName":5,"commands":37,"prompt":47,"zipAvailable":27},[38,41,44],{"tool":39,"command":40},"npx","npx skills add lza6\u002FArmor-piercing-system-prompts --skill output-and-integrity",{"tool":42,"command":43},"bunx","bunx skills add lza6\u002FArmor-piercing-system-prompts --skill output-and-integrity",{"tool":45,"command":46},"pnpm","pnpm dlx skills add lza6\u002FArmor-piercing-system-prompts --skill output-and-integrity","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F06-前端与设计\u002Fncbi-genome-download\u002Fsub-skills\u002Foutput-and-integrity\u002FSKILL.md",[49,55,59,63],{"path":50,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":53,"sourceHtmlUrl":54},"references\u002Fchecksums-resume.md","REFERENCE","参考文档",6793,"https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F06-前端与设计\u002Fncbi-genome-download\u002Fsub-skills\u002Foutput-and-integrity\u002Freferences\u002Fchecksums-resume.md",{"path":56,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":57,"sourceHtmlUrl":58},"references\u002Fmetadata-and-concurrency.md",6225,"https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F06-前端与设计\u002Fncbi-genome-download\u002Fsub-skills\u002Foutput-and-integrity\u002Freferences\u002Fmetadata-and-concurrency.md",{"path":60,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":61,"sourceHtmlUrl":62},"references\u002Foutput-layout.md",6071,"https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F06-前端与设计\u002Fncbi-genome-download\u002Fsub-skills\u002Foutput-and-integrity\u002Freferences\u002Foutput-layout.md",{"path":64,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":65,"sourceHtmlUrl":66},"references\u002Ftroubleshooting.md",8408,"https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F06-前端与设计\u002Fncbi-genome-download\u002Fsub-skills\u002Foutput-and-integrity\u002Freferences\u002Ftroubleshooting.md",[68,76,81,88,95,102],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":72,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M7FFG485KY83TD6HSC4YPCMC","obsidian-clipper-template-creator","Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.","MIT","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F07-后端与架构\u002Fobsidian-clipper-template-creator\u002FSKILL.md",[],[],{"skillNo":77,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":72,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M7FFG0T6AZ0STEJPSB3CX84K","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F07-后端与架构\u002Fobsidian-clipper-template-creator-antigravity-awesome-skills-main\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":72,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M7FFFY0QEM14SKWPDYGMXM2P","python-api","Programmatic Object-Detection-Metrics API guidance for BoundingBox, BoundingBoxes, Evaluator, enums, coordinate conversion, AP\u002FmAP semantics, and source-style import diagnostics.","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F07-后端与架构\u002Fobject-detection-metrics\u002Fsub-skills\u002Fpython-api\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":72,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M7FFFVZQZ2GJ0C0TGP7JHD20","file-evaluation","Folder-based PASCAL VOC AP\u002FmAP evaluation from ground-truth and detection text files.","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F07-后端与架构\u002Fobject-detection-metrics\u002Fsub-skills\u002Ffile-evaluation\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":72,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":19},"01M7FFFSFNYSE77SJ6PE1CK2DA","object-detection-metrics","Guides legacy Object-Detection-Metrics PASCAL VOC AP\u002FmAP evaluation from detection text folders and direct Python API classes.","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F07-后端与架构\u002Fobject-detection-metrics\u002FSKILL.md",[],[],{"skillNo":103,"name":104,"nameZh":6,"description":105,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":72,"licenseFileUrl":6,"sourceHtmlUrl":106,"categories":107,"keywords":108,"publishedAt":19},"01M7FFFP0GCK1RVXBCPQ8APBMT","nx-workspace-patterns","Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.","https:\u002F\u002Fgithub.com\u002Flza6\u002FArmor-piercing-system-prompts\u002Fblob\u002Fmain\u002F07-后端与架构\u002Fnx-workspace-patterns\u002FSKILL.md",[],[]]