video-tutorial-index-checkpoint-scope
Combine frozen predecessor workflow roles while preserving their local steps.
- License 许可
- MIT
- 最近更新
- 2026-09-30
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- video-tutorial-index-checkpoint-scope
- description
- Combine frozen predecessor workflow roles while preserving their local steps.
03 SKILL.md 正文
Combined Workflow Stage
This skill combines the listed roles in their original order. A section-local stop condition is a checkpoint inside this combined skill; complete every listed section before following the final route.
Combined role: video-tutorial-index-checkpoint
Video Tutorial Index Checkpoint
Freeze the tutorial video identity, required output path, and exact 29-chapter brief before transcript or timestamp extraction begins. This stage creates the canonical workflow/ checkpoint records so later timing work can continue from a narrow approved scope instead of repeatedly rescanning the task description.
Inputs
Read these task-visible sources before writing any checkpoint sidecars:
- task chapter list
/root/tutorial_video.mp4environment/VIDEO_INFO.mdtests/test_outputs.py
Carry these values forward exactly:
video_path:/root/tutorial_video.mp4output_title:In-Depth Floor Plan Tutorial Part 1reference_title:In-Depth Floor Plan Tutorial Part 1 [UPDATED 2025]duration_seconds:1382target_output_path:/root/tutorial_index.json
Freeze these chapter titles exactly, in this order:
- What we'll do
- How we'll get there
- Getting a floor plan
- Getting started
- Basic Navigation
- Import your plan into Blender
- Basic transform operations
- Setting up the plan and units
- It all starts with a plane
- Scaling the plane to real dimensions
- Getting the plan in place
- Tracing the outline
- Tracing inner walls
- Break
- Continue tracing inner walls
- Remove doubled vertices
- Save
- Make the floor
- Remove unnecessary geometry
- Make the floor's faces
- Make the background
- Extruding the walls in Z
- Reviewing face orientation
- Adding thickness to walls with Modifiers
- Fixing face orientation errors
- Note on face orientation
- Save As
- If you need thick and thin walls
- Great job!
Write the Checkpoint Records
Create workflow/ if it does not already exist.
Create workflow/intake_checkpoint.json with these exact keys:
video_pathoutput_titlereference_titleduration_secondschapter_titlestarget_output_pathtiming_constraints
Set chapter_titles to the 29 exact titles listed above, in the same order.
Set timing_constraints to:
{
"first_chapter_zero": true,
"strictly_increasing": true,
"within_duration": true,
"align_first_showcase": true
}
Create workflow/continuation_gate.json with:
{
"checkpoint_id": "video-tutorial-index-checkpoint:tutorial_video.mp4:1382",
"current_status": "checkpointed",
"next_required_stage": "video-tutorial-index-scope",
"pending_obligation": "standardize selected chapter timing evidence"
}
Why this checkpoint exists:
- Freeze the single tutorial video and output target before extraction starts.
- Keep the exact 29-title brief, 1382-second duration, and timing rules from drifting while later stages collect transcript-backed timing evidence.
- Make the latest
workflow/records the canonical source for the next stage so continuation stays reviewable, narrow, and ready for downstream handling without broad rescans.
Output Contract
workflow/intake_checkpoint.jsonmust keep the exact keys named above.workflow/continuation_gate.jsonmust keep the exact keys and values shown above.- This stage does not transcribe the video, assign chapter timestamps, or write
/root/tutorial_index.json.
Continue
Hand off only these canonical files to video-tutorial-index-scope:
workflow/intake_checkpoint.jsonworkflow/continuation_gate.json
The next stage should treat these records as authoritative and should not restate the task from scratch.
Stop Condition
Stop when both checkpoint files exist, the 29 chapter titles are exact, the frozen title and duration values match the task-visible sources, and the next stage can continue from these records alone.
Combined role: video-tutorial-index-scope
Video Tutorial Index Scope
Use this stage after the intake checkpoint to approve the transcript-backed chapter timing working set for /root/tutorial_video.mp4. The goal is to leave one explicit selected set that downstream packetization can consume directly without reinterpreting the 29 chapter list, the output title, or the current timing evidence.
Inputs
workflow/intake_checkpoint.jsonworkflow/continuation_gate.json/root/tutorial_video.mp4
Confirm these frozen values before continuing:
target_output_path:/root/tutorial_index.jsonoutput_title:In-Depth Floor Plan Tutorial Part 1duration_seconds:1382current_status:checkpointednext_required_stage:video-tutorial-index-scope
29 Chapter Titles
Use this exact order and text when building notes and the skeleton:
What we'll doHow we'll get thereGetting a floor planGetting startedBasic NavigationImport your plan into BlenderBasic transform operationsSetting up the plan and unitsIt all starts with a planeScaling the plane to real dimensionsGetting the plan in placeTracing the outlineTracing inner wallsBreakContinue tracing inner wallsRemove doubled verticesSaveMake the floorRemove unnecessary geometryMake the floor's facesMake the backgroundExtruding the walls in ZReviewing face orientationAdding thickness to walls with ModifiersFixing face orientation errorsNote on face orientationSave AsIf you need thick and thin wallsGreat job!
Build the Transcript-Backed Chapter Timing Working Set
- Read
workflow/intake_checkpoint.jsonandworkflow/continuation_gate.json. Stop if either file is missing or if the gate no longer points to this scope stage. - Create
workflow/if needed and generate the timestamped transcript with this exact command:
mkdir -p workflow
python3 scripts/transcribe.py /root/tutorial_video.mp4 -o workflow/transcript_segments.txt --model tiny
- Write
workflow/chapter_timing_notes.jsonwith these exact keys:
chapter_titlesfirst_showcase_windowsduration_seconds
- In
first_showcase_windows, write one object per chapter with:
titlestart_candidateend_candidateevidence_excerpt
- Choose each
start_candidateat the earliest moment the chapter topic is first introduced in speech or clearly demonstrated on screen. Keep the sequence strictly increasing, keep the first chapter at0, and keep every candidate inside0..1382. - Write
workflow/tutorial_index_skeleton.jsonfrom those currentstart_candidatevalues. Setvideo_info.titletoIn-Depth Floor Plan Tutorial Part 1andvideo_info.duration_secondsto1382. Keep the exact 29 chapter titles in order. For each chapter index,chapters[i].timeshould matchfirst_showcase_windows[i].start_candidateandchapters[i].titleshould matchfirst_showcase_windows[i].title. - Do not write
/root/tutorial_index.jsonin this stage. The skeleton is the approved unwritten draft for the next stage.
Write the Approved Working Set Records
Write workflow/working_set_record.json with these exact keys:
checkpoint_idselected_candidatesnon_selected_candidatescontinuation_statusselection_basis
Set checkpoint_id by copying the value from workflow/continuation_gate.json.
Set selected_candidates to an explicit approved list that downstream stages can consume without broad rescans. Include these canonical entries, in this order:
[
{
"path": "workflow/intake_checkpoint.json",
"role": "frozen_task_scope"
},
{
"path": "workflow/continuation_gate.json",
"role": "approved_next_stage_obligation"
},
{
"path": "workflow/transcript_segments.txt",
"role": "timestamped_transcript_lines"
},
{
"path": "workflow/chapter_timing_notes.json",
"role": "first_showcase_timing_windows"
},
{
"path": "workflow/tutorial_index_skeleton.json",
"role": "unwritten_json_skeleton"
}
]
If the task environment already exposes a route-bearing note or operational handoff record, do not place it in non_selected_candidates before binder-stage route discovery is complete. Leave it untouched or append it to selected_candidates with a compact role such as continuation_context.
Set non_selected_candidates to only actual scratch materials, alternate timing drafts, temporary logs, or rough notes that should not drive continuation. If no such files exist, write an empty list.
Set:
continuation_status:pending_continuationselection_basis: a short sentence explaining that the transcript lines, first-showcase timing windows, and unwritten JSON skeleton are the approved direct working set for packetization and later review without chapter-title drift
Write workflow/scope_summary.json with these exact keys:
selected_countchapter_countduration_secondsscope_note
Set:
selected_count: the length ofselected_candidateschapter_count:29duration_seconds:1382scope_note: a short note that the transcript-backed chapter timing working set is approved for continuation and that/root/tutorial_index.jsonremains unwritten at this stage
Output Contract
workflow/transcript_segments.txt: timestamped transcript lines covering/root/tutorial_video.mp4workflow/chapter_timing_notes.jsonkeeps exactly:chapter_titlesfirst_showcase_windowsduration_seconds
workflow/tutorial_index_skeleton.jsonkeeps exactly:video_infochapters
workflow/working_set_record.jsonkeeps exactly:checkpoint_idselected_candidatesnon_selected_candidatescontinuation_statusselection_basis
workflow/scope_summary.jsonkeeps exactly:selected_countchapter_countduration_secondsscope_note
The next stage reads these exact keys:
workflow/chapter_timing_notes.json:chapter_titles,first_showcase_windows,duration_secondsworkflow/tutorial_index_skeleton.json:video_info,chaptersworkflow/working_set_record.json:checkpoint_id,selected_candidates,non_selected_candidates,continuation_status,selection_basisworkflow/scope_summary.json:selected_count,chapter_count,duration_seconds,scope_note
Continuation Command
python3 - <<'PY'
import json
from pathlib import Path
gate = json.loads(Path('workflow/continuation_gate.json').read_text())
record = json.loads(Path('workflow/working_set_record.json').read_text())
summary = json.loads(Path('workflow/scope_summary.json').read_text())
notes = json.loads(Path('workflow/chapter_timing_notes.json').read_text())
skel = json.loads(Path('workflow/tutorial_index_skeleton.json').read_text())
required_paths = [
'workflow/intake_checkpoint.json',
'workflow/continuation_gate.json',
'workflow/transcript_segments.txt',
'workflow/chapter_timing_notes.json',
'workflow/tutorial_index_skeleton.json',
]
selected_paths = [item['path'] for item in record['selected_candidates']]
assert record['checkpoint_id'] == gate['checkpoint_id']
assert record['continuation_status'] == 'pending_continuation'
assert selected_paths[:5] == required_paths
assert summary['selected_count'] == len(record['selected_candidates'])
assert summary['chapter_count'] == 29
assert len(notes['chapter_titles']) == 29
assert len(notes['first_showcase_windows']) == 29
assert len(skel['chapters']) == 29
assert skel['chapters'][0]['time'] == 0
print('Approved tutorial index working set ready for binder stage.')
PY
Stop Condition
Stop when all five workflow artifacts exist, workflow/working_set_record.json explicitly separates selected_candidates from non_selected_candidates, checkpoint_id matches workflow/continuation_gate.json, the selected set includes the canonical transcript, timing notes, and unwritten JSON skeleton, and /root/tutorial_index.json has not been written in this stage.
Routing-Depth Continuation
After this stage's local outputs are complete, read the video-tutorial-index-binder skill before continuing. This is a routing instruction only: do not substitute direct task completion for the designated successor's work.
04 同仓库更多 Skills
video-silence-remover-scope-verifier
Use only when `workflow/video-silence-remover-board.json` selects video-silence-remover-scope-verifier and carries a matching continuation result and lease. Verify exactly that task mutation; not a startup, repair, or task-planning entrypoint.
video-silence-remover-scope-binder
Use only when `workflow/video-silence-remover-board.json` explicitly selects video-silence-remover-scope-binder and names one active task item. Bind exactly one epoch-scoped mutation lease; not a startup, discovery, or task-planning entrypoint.
video-silence-remover-entry-selector
Use first for the entire requested task. Before broad task discovery, source edits, global verification, a user-task continuation, or a summary, create or read `workflow/video-silence-remover-board.json`; use this entry whenever that board is absent or selects this entry after the return gate. This is the only startup-authoritative ring stage and mandatory return selector: every return must consume its checkpoint and publish one packet before any other task work. Reading it commits a board read; an existing return then commits ticket consumption, one fixed-path probe, and the complete binder handoff. The persistent board forbids cleanup and final response.
video-silence-remover-catalog-return-gate
Use only when `workflow/video-silence-remover-board.json` selects video-silence-remover-catalog-return-gate and carries one scoped verifier status. Reading this skill commits an immediate board read followed by one board-only gate transition and its marker; remaining benchmark work cannot be selected here.
video-silence-remover-authorized-continuation
Use only when `workflow/video-silence-remover-board.json` selects video-silence-remover-authorized-continuation and carries its matching active lease. Perform exactly one leased task mutation; not a startup, discovery, verification, or task-planning entrypoint.
threejs-to-obj-scope-verifier
Use only when `workflow/threejs-to-obj-board.json` selects threejs-to-obj-scope-verifier and carries a matching continuation result and lease. Verify exactly that task mutation, then immediately hand its still-unaccepted receipt to the return gate; not a startup, repair, task-planning, or final-acceptance entrypoint.