modeling-and-layers
Understand Scenic model registry contracts, BaseModel task bases, Flax module construction, layers, attention, matchers, and tiny smoke checks.
- License 许可
- Apache-2.0
- 最近更新
- 2026-10-08
- Stars
- ★ 11
- Forks
- 3
01 前言 Front Matter
- name
- modeling-and-layers
- license
- Apache 2.0
- metadata
- { "disco-role": "operating" }
- description
- Understand Scenic model registry contracts, BaseModel task bases, Flax module construction, layers, attention, matchers, and tiny smoke checks.
- disable-model-invocation
- true
02 资源文件 3
- 参考文档references/layers-and-matchers.md6.0 KB
- 参考文档references/modeling-api.md6.4 KB
- 参考文档references/troubleshooting.md3.8 KB
03 SKILL.md 正文
Modeling and Layers
Use this sub-skill when the task is about Scenic model selection, BaseModel contracts, task-specific model bases, Flax module construction, layer/attention/matcher APIs, or tiny smoke checks.
Start here
- Read
references/modeling-api.mdfor the registry, model-class contracts, loss/metric conventions, and model-init/apply patterns. - Read
references/layers-and-matchers.mdfor attention/layer/matcher APIs, optional dependencies, and tiny validation patterns. - Read
references/troubleshooting.mdwhen a model name is missing, a Flax/JAX shape or RNG issue appears, metrics aggregate incorrectly, or a checkpoint does not load cleanly. - Run
scripts/model_registry_probe.pyto list registered model names or resolve a single model class without instantiating it.
Scope and routing
- In scope: model registry lookups, BaseModel and task-base contracts, loss/metric normalization, Flax module construction, layer/attention/matcher APIs, and smoke-test patterns for tiny inputs.
- Out of scope: training orchestration, launch commands, schedules, checkpoint lifecycle, dataset builders, project selection, and paper/baseline choice.
- Route training/runtime execution to
running-and-training. - Route dataset builders and input-pipeline work to
data-pipelines. - Route project-level or paper-level model selection to
baselines-and-projects.
Operating rules
- Begin with the registry; an unrecognized model name is usually a registry or config problem, not a training problem.
- Treat
build_flax_model()as the construction boundary. Build the Flax module, then use tinyinit/applychecks instead of a full run. - Keep loss functions local and scalar; keep metrics cross-device safe by returning sum/normalizer pairs.
- Use tiny dummy inputs for smoke checks and shape assertions. Prefer
init_with_output,init, andapplyon minimal batches. - Keep optional matcher dependencies explicit. Do not promise
scipyorott-jaxbehavior unless the target matcher requires it.
When to read what
| Need | Read |
|---|---|
| Registry, BaseModel, task bases, loss/metric rules, smoke-init pattern | references/modeling-api.md |
| Attention, layer, masked-layer, and matcher APIs plus tiny validation patterns | references/layers-and-matchers.md |
| Common failure modes and recovery | references/troubleshooting.md |
| List registered models or resolve one class | scripts/model_registry_probe.py |
04 同仓库更多 Skills
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.
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.
python-api
Programmatic Object-Detection-Metrics API guidance for BoundingBox, BoundingBoxes, Evaluator, enums, coordinate conversion, AP/mAP semantics, and source-style import diagnostics.
file-evaluation
Folder-based PASCAL VOC AP/mAP evaluation from ground-truth and detection text files.
object-detection-metrics
Guides legacy Object-Detection-Metrics PASCAL VOC AP/mAP evaluation from detection text folders and direct Python API classes.
nx-workspace-patterns
Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.