claw/docs/superpowers/plans/2026-04-19-scene-skill-102-final-materialization-plan.md

Scene Skill 102 Final Materialization Plan

Date: 2026-04-19 Parent Framework: 2026-04-19-scene-skill-102-full-coverage-framework-plan.md Parent Layer: final asset materialization before validation Status: Draft

Plan Intent

Generate and freeze a single canonical 102 skill package set for later static, mock, and production-like validation.

This plan answers whether all 102 scenes have materialized skill assets, not just framework auto-pass status.

Fixed Inputs

1. tests/fixtures/generated_scene/scene_execution_board_2026-04-18.json
2. tests/fixtures/generated_scene/scene_skill_102_framework_closure_rollup_2026-04-19.json
3. scene source root: D:/desk/智能体资料/全量业务场景/一平台场景

Output Root

examples/scene_skill_102_final_materialization_2026-04-19

Allowed Files

1. examples/scene_skill_102_final_materialization_2026-04-19/**
2. tests/fixtures/generated_scene/scene_skill_102_final_materialization_manifest_2026-04-19.json
3. tests/fixtures/generated_scene/scene_skill_102_final_materialization_failures_2026-04-19.json
4. docs/superpowers/reports/2026-04-19-scene-skill-102-final-materialization-report.md

Forbidden Files

1. src/generated_scene/analyzer.rs
2. src/generated_scene/generator.rs
3. src/generated_scene/ir.rs
4. tests/fixtures/generated_scene/scene_execution_board_2026-04-18.json
5. existing examples/* follow-up roots outside the output root

Phase 0: Freeze Materialization Boundary

Tasks

1. Confirm framework rollup is 102 / 102.
2. Confirm materialization does not delete existing examples/*.
3. Confirm this plan does not perform static/mock/production validation.

Acceptance Criteria

1. Scope is materialization only.
2. Output root is isolated.

Phase 1: Build Materialization Input Manifest

Tasks

1. Load official board or fallback source-list assets.
2. Produce exactly 102 materialization input rows.
3. Validate unique scene ids.
4. Resolve source directory for each scene.
5. Sanitize manifest-only string fields for control characters.

Acceptance Criteria

1. Input manifest has 102 rows.
2. No missing source directory remains.
3. No duplicate scene id remains.

Phase 2: Generate 102 Skill Packages

Tasks

For each manifest row, run:

cargo run --bin sg_scene_generate -- `
  --source-dir "<sourceDir>" `
  --scene-id "<sceneId>" `
  --scene-name "<sceneName>" `
  --scene-kind report_collection `
  --output-root "D:/data/ideaSpace/rust/sgClaw/claw-new/examples/scene_skill_102_final_materialization_2026-04-19"

Acceptance Criteria

1. Every row is attempted.
2. No single scene failure stops the full batch.
3. stdout/stderr/result status are captured.

Phase 3: Verify Materialized Package Presence

Tasks

For each scene, check:

1. SKILL.toml
2. SKILL.md
3. scene.toml
4. references/generation-report.json
5. at least one script under scripts/

Acceptance Criteria

1. All successful rows have required files.
2. Failures are explicit in the failures asset.

Phase 4: Publish Manifest And Report

Tasks

1. Publish final materialization manifest.
2. Publish final materialization failures.
3. Publish superpowers report.

Acceptance Criteria

1. Manifest row count is 102.
2. Report states generated count, failure count, readiness distribution, and next validation input.
3. The report explicitly states that old examples/* roots were not cleaned.

Expected Delta

No framework coverage delta. Expected asset delta is:

1. 102 canonical final skill package rows;
2. one stable manifest for later validation.

Stop Statement

Stop after final materialization manifest, failures asset, and report are published. Do not start static, mock, or production validation under this plan.