Files
claw/docs/superpowers/specs/2026-04-20-deterministic-keyword-scoring-refinement-design.md

2.2 KiB

Deterministic Keyword Scoring Refinement Design

Date: 2026-04-20 Parent Plan: 2026-04-20-scene-skill-102-deterministic-invocation-readiness-plan.md

Intent

Resolve the 9 deterministic dispatch ambiguity gaps found after normalizing the final materialized scene skills for 。。。 invocation.

The previous readiness pass proved that 92 complete packages can be selected by full-scene-name samples, but 9 scenes collide because generated include keywords are too broad for current score rules.

Fixed Gap Set

  1. sweep-026-scene / 县区公司故障明细
  2. sweep-034-scene / 售电收入日统计排程预测
  3. sweep-037-scene / 嘉峪关可靠性分析报告
  4. sweep-038-scene / 嘉峪关周报
  5. sweep-039-scene / 嘉峪关故障明细
  6. sweep-040-scene / 嘉峪关日报
  7. sweep-041-scene / 嘉峪关月报
  8. sweep-044-scene / 国网金昌供电公司指挥中心生产例会报告
  9. sweep-045-scene / 国网金昌供电公司营商环境周例会报告

Scope

Allowed:

  1. Refine deterministic include/exclude keywords for the fixed 9 scenes and direct collision partners when needed.
  2. Run dispatch dry-run checks without browser execution.
  3. Publish refinement decisions and readiness delta.

Forbidden:

  1. Do not execute browser scripts.
  2. Do not repair sweep-012-scene.
  3. Do not change generated scripts.
  4. Do not update official execution board.
  5. Do not modify runtime dispatch code unless this design is superseded by a separate runtime-scoring implementation plan.

Strategy

Prefer manifest-level disambiguation first:

  1. keep full scene names as primary keywords;
  2. remove overly broad standalone tokens from colliding scenes where they create ties;
  3. add distinctive phrase keywords only when present in the scene name;
  4. use exclude_keywords only for direct mutually exclusive cases.

Runtime scoring changes are out of scope for this plan unless manifest refinement cannot make all 9 gaps uniquely selectable.

Completion Criteria

  1. All 9 fixed gaps have final decisions.
  2. Full-scene-name dispatch dry-run uniquely selects the expected scene for each fixed gap.
  3. No new ambiguity is introduced for the complete 101-package set.
  4. sweep-012-scene remains excluded.