pptx-reference-formatting-intake-checkpoint
Inspect /root/Awesome-Agent-Papers.pptx and freeze title owners, Reference-entry slots, and the Reference-slide append slot before any title formatting edits.
- License 许可
- MIT
- 最近更新
- 2026-09-30
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- pptx-reference-formatting-intake-checkpoint
- description
- Inspect /root/Awesome-Agent-Papers.pptx and freeze title owners, Reference-entry slots, and the Reference-slide append slot before any title formatting edits.
02 资源文件 1
- 脚本scripts/observe_titles.py14.1 KB
03 SKILL.md 正文
PPTX Reference Formatting Intake Checkpoint
Use this first for the /root/Awesome-Agent-Papers.pptx cleanup task. This observation-only stage freezes live title owners, Reference-entry slots, and the append slot before any title edit or repack step.
Inputs
/root/Awesome-Agent-Papers.pptxtests/test_outputs.pyas sink-shape hints only
Output Artifact
Write workflow/pptx_reference_formatting_slide_observation.json with:
current_stagenext_required_skillallowed_outputsbinding_surface_kindobserved_slide_sizeobserved_title_placeholder_contractsobserved_fragment_catalogobserved_reference_entry_catalogreference_slide_append_contract
observed_title_placeholder_contracts rows keep the owner, its exact render target, and its local fragment:
placeholder_owner,slide_index, andshape_handleowner_render_contract_handleandowner_render_contract(slide_part,shape_id,x,y,cx,cy)row_local_fragment_handle,row_local_fragment, andalternate_fragment_handlesx,y,cx,cy,anchor,paragraph_alignment, andstyle_target
The helper must observe exactly slides 2–6. A title ending in ? is still a paper title and must not be discarded. reference_slide_append_contract also carries the observed slide_layout_handle required to create the appended slide.
observed_fragment_catalog rows keep:
fragment_handleslide_indexsource_shape_handleraw_text
observed_reference_entry_catalog keeps one ordered Reference-entry slot per slide:
reference_entry_handle,entry_fragment_handle,slide_index, andsource_shape_handlefull_text,prefix_text, andsuffix_text- local label fragments needed only by the next state-resolution stage
Do not publish final title rows, resolved title text, or final Reference bullets in this stage.
Run
- Read the live PPTX to inventory slide size, title-owner shapes, and candidate title fragments.
- Use
tests/test_outputs.pyonly to confirm the checked surface stays within the expected title, style, and bottom-center scope. - Freeze the Reference-slide append slot and box contracts without building the final numbered list.
- Write the stage artifact with this status seed:
NEXT_REQUIRED_SKILL = "pptx-reference-formatting-title-binding-note"
artifact = {
"next_required_skill": NEXT_REQUIRED_SKILL,
}
print("next_required_skill=pptx-reference-formatting-title-binding-note")
BINDING_SURFACE_KIND = "placeholder_cluster"
artifact.update({
"binding_surface_kind": BINDING_SURFACE_KIND,
})
print("binding_surface_kind=placeholder_cluster")
Concrete continuation command:
python skills/pptx-reference-formatting-intake-checkpoint/scripts/observe_titles.py \
/root/Awesome-Agent-Papers.pptx \
workflow/pptx_reference_formatting_slide_observation.json
Stop Condition
Stop once workflow/pptx_reference_formatting_slide_observation.json exists, next_required_skill is pptx-reference-formatting-title-binding-note, and no slide XML or processed PPTX has been written yet.
Count-Study Continuation
After this stage's local outputs are complete, read pptx-reference-formatting-title-binding-note before continuing. This is a routing instruction only; retain the designated successor's separate responsibility.
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.