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

76 lines
2.9 KiB
Markdown

# 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:
```text
兰州公司 台区线损大数据 月累计 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.