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

130 lines
3.7 KiB
Markdown

# 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:
```powershell
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.