claw/docs/superpowers/specs/2026-04-20-scene-skill-102-parameter-dictionary-template-normalization-design.md

Scene Skill 102 Parameter Dictionary And Invocation Template Normalization Design

Date: 2026-04-20 Parent: 2026-04-20-scene-skill-102-natural-language-parameter-readiness-design.md

Intent

Make the 10 required-param scene skills usable with natural-language query conditions before pseudo-production batch execution.

This design does not broaden deterministic dispatch. It only closes the immediate parameter-readiness gap discovered in scene_skill_102_natural_language_parameter_readiness_2026-04-20.json.

Current Gap

10 multi_mode_request skills declare required params:

1. org via dictionary_entity
2. period via month_week_period

However, each generated references/org-dictionary.json is currently an empty array. Therefore inputs such as:

兰州公司 台区线损大数据 月累计 2026-03。。。

have the correct shape, but cannot resolve 兰州公司 into org_label and org_code.

Scope

Allowed:

1. Populate references/org-dictionary.json for the fixed 10 required-param skills.
2. Use the existing, already-tested minimal organization aliases from deterministic-submit fixtures:
   • 国网兰州供电公司 / 62401
   • 城关供电分公司 / 6240108
   • 国网天水供电公司 / 62403
3. Refresh natural-language parameter readiness assets.
4. Refresh invocation samples.
5. Refresh pseudo-production handoff inputs for selected scenes that require params.

Forbidden:

1. Do not modify src/compat/scene_platform/dispatch.rs.
2. Do not modify src/compat/scene_platform/resolvers.rs.
3. Do not modify src/generated_scene/analyzer.rs.
4. Do not modify src/generated_scene/generator.rs.
5. Do not execute browser, host bridge, localhost services, or production network.
6. Do not claim this starter dictionary is a full production organization dictionary.
7. Do not add params to the other 92 non-param skills under this plan.

Starter Dictionary Policy

The populated dictionary is a pseudo-production starter dictionary. It is sufficient to validate the natural-language parameter plumbing for inputs such as 兰州公司 and 月累计 2026-03.

It is not a full province-wide organization dictionary. A later production hardening step may replace or expand it with the real unit tree.

Readiness Target

After this plan:

1. 10 / 10 required-param skills should move from parameter-gap to parameter-ready.
2. Their recommended invocation samples should include:
   • organization alias;
   • scene name;
   • month/week mode;
   • concrete period value;
   • 。。。 suffix.
3. Pseudo-production handoff should not use bare scene names for these scenes.

Completion Criteria

1. All fixed 10 dictionaries are non-empty and parseable.
2. Natural-language parameter readiness is refreshed.
3. Invocation samples are refreshed.
4. Pseudo-production handoff is refreshed for selected required-param scenes.
5. No runtime source files are modified.