菜单
Use Kida static analysis for pre-render validation, incremental builds, block caching. Use when validating template context, optimizing build times, or implementing caching.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
Convert Jinja2 templates to Kida syntax. Use when migrating from Jinja2, Django templates, or similar engines.
Use Kida with Chirp for HTMX partials, fragment rendering, block validation. Use when building Chirp web apps.
Write correct Kida templates from scratch. Use when creating templates, writing views, or authoring template content.
Use Kida with Bengal SSG: block caching, incremental builds, template context. Use when building Bengal sites or optimizing build performance.
Add custom Kida filters with proper type coercion. Use when adding filters, extending templates, or handling YAML/config int/str.
Understand Kida expression behavior: `+` operator, list vs string, export accumulation. Use when debugging unexpected output or expression behavior.
| name | kida-static-analysis |
| description | Use Kida static analysis for pre-render validation, incremental builds, block caching. Use when validating template context, optimizing build times, or implementing caching. |
Kida analyzes compiled templates without rendering. Use for validation, incremental builds, and caching.
| Method | Returns |
|---|---|
required_context() | Top-level variable names needed |
depends_on() | Dotted paths: page.title, site.menu |
validate_context(ctx) | List of missing variable names |
block_metadata() | Per-block purity, dependencies, cache scope |
template_metadata() | Full analysis including inheritance |
is_cacheable(block_name) | Whether block can be safely cached |
Catch missing variables before rendering:
missing = template.validate_context(user_context)
if missing:
raise ValueError(f"Missing template variables: {missing}")
result = template.render(**user_context)
>>> template.required_context()
frozenset({'page', 'site'})
>>> template.depends_on()
frozenset({'page.title', 'page.content', 'site.menu'})
Results are conservative: may over-approximate, never miss a used path.
>>> meta = template.block_metadata()
>>> nav = meta["nav"]
>>> nav.depends_on
frozenset({'site.menu'})
>>> nav.is_pure
'pure'
>>> nav.cache_scope
'site'
>>> nav.is_cacheable()
True
| Value | Meaning | Cacheable? |
|---|---|---|
"pure" | Deterministic output | Yes |
"impure" | Uses random, shuffle, etc. | No |
"unknown" | Cannot determine | Treat as impure |
| Scope | Meaning | Example |
|---|---|---|
"site" | Same for every page | Nav, footer |
"page" | Varies per page | Content, title |
"none" | Impure | Random quotes |
"unknown" | Cannot determine | Mixed deps |
if template.is_cacheable("nav"):
html = cache.get_or_render("nav", lambda: template.render_block("nav", site=site))
else:
html = template.render_block("nav", site=site)
Analysis requires preserve_ast=True (default). Templates loaded from bytecode cache without source may return empty metadata.
name, depends_on, is_pure, cache_scopeemits_html, emits_landmarks, inferred_rolename, extends, blocks, top_level_depends_onall_dependencies(), get_block(name), cacheable_blocks(), site_cacheable_blocks()