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

125 lines
4.0 KiB
Markdown

# Scene Skill 102 Parameter Dictionary And Invocation Template Normalization Plan
> Date: 2026-04-20
> Design: `2026-04-20-scene-skill-102-parameter-dictionary-template-normalization-design.md`
## Plan Intent
Close the natural-language parameter readiness gap for the fixed `10` required-param scene skills and refresh pseudo-production invocation templates.
## Fixed Input Bucket
The only input bucket is the `10` scenes marked `parameter-gap` in:
`tests/fixtures/generated_scene/scene_skill_102_natural_language_parameter_readiness_2026-04-20.json`
## Allowed Files
1. `examples/scene_skill_102_final_materialization_2026-04-19/skills/{fixed-10}/references/org-dictionary.json`
2. `tests/fixtures/generated_scene/scene_skill_102_natural_language_parameter_readiness_2026-04-20.json`
3. `tests/fixtures/generated_scene/scene_skill_102_natural_language_invocation_samples_2026-04-20.json`
4. `tests/fixtures/generated_scene/scene_skill_102_pseudoprod_execution_handoff_2026-04-20.json`
5. `tests/fixtures/generated_scene/scene_skill_102_parameter_dictionary_template_normalization_2026-04-20.json`
6. `docs/superpowers/reports/2026-04-20-scene-skill-102-parameter-dictionary-template-normalization-report.md`
## Forbidden Files
1. `src/compat/scene_platform/dispatch.rs`
2. `src/compat/scene_platform/resolvers.rs`
3. `src/generated_scene/analyzer.rs`
4. `src/generated_scene/generator.rs`
5. `examples/scene_skill_102_final_materialization_2026-04-19/skills/*/scripts/*`
6. `tests/fixtures/generated_scene/scene_execution_board_2026-04-18.json`
## Phase 0: Freeze Scope
### Tasks
1. Confirm the fixed `10` required-param scenes.
2. Confirm all current gaps are empty org dictionaries.
3. Confirm no runtime code changes are needed.
### Acceptance Criteria
1. No non-param scene is changed.
2. No browser or production execution is started.
## Phase 1: Populate Starter Organization Dictionaries
### Tasks
1. Write the pseudo-production starter dictionary into each fixed `10` skill.
2. Use the already-tested aliases:
- `兰州公司`
- `兰州供电公司`
- `国网兰州供电公司`
- `城关供电分公司`
- `城关分公司`
- `天水公司`
- `天水供电公司`
- `国网天水供电公司`
3. Mark dictionary provenance as starter, not full production.
### Acceptance Criteria
1. All fixed `10` dictionaries are non-empty arrays.
2. Each dictionary contains alias coverage for `兰州公司`.
## Phase 2: Refresh Parameter Readiness
### Tasks
1. Re-scan all `102` skills.
2. Recompute parameter readiness.
3. Verify the fixed `10` move to `parameter-ready`.
4. Keep implicit-risk classification for no-param scenes.
### Acceptance Criteria
1. `parameter-gap = 0`.
2. `parameter-ready = 10`.
3. `total scenes = 102`.
## Phase 3: Refresh Invocation Templates
### Tasks
1. Generate parameterized samples for the fixed `10`.
2. Ensure samples include concrete period, e.g. `月累计 2026-03`.
3. Ensure samples keep `。。。` suffix.
### Acceptance Criteria
1. All fixed `10` have parameterized sample input.
2. No-param scenes keep minimal invocation samples.
## Phase 4: Refresh Pseudo-Production Handoff
### Tasks
1. Update the selected pseudo-production handoff entries that are in the fixed `10`.
2. Replace bare scene-name inputs with parameterized inputs.
3. Preserve credential policy and evidence collection fields.
### Acceptance Criteria
1. Selected required-param scenes no longer use bare `场景名。。。` in handoff.
2. No credentials are written to the repository.
## Phase 5: Publish Normalization Report
### Tasks
1. Publish normalization JSON.
2. Publish superpowers report.
3. State remaining limits explicitly.
### Acceptance Criteria
1. Report states that dictionaries are starter dictionaries, not complete production unit trees.
2. Report states next step for pseudo-production execution preparation refresh.
## Stop Statement
Stop after dictionaries, readiness assets, invocation samples, handoff, and report are refreshed. Do not run browser, production, or runtime implementation work under this plan.