edit-pdf-wob-k1-monolith
Single-skill directness control containing the ordered K2 workflow.
- License 许可
- MIT
- 最近更新
- 2026-09-30
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- edit-pdf-wob-k1-monolith
- description
- Single-skill directness control containing the ordered K2 workflow.
02 资源文件 4
- 脚本scripts/apply_write_packet.py16.7 KB
- 脚本scripts/build_checkpoint.py15.9 KB
- 脚本scripts/build_write_packet.py9.4 KB
- 脚本scripts/write_field_binding_note.py10.0 KB
03 SKILL.md 正文
K1 Single-Skill Directness Control
This material intentionally co-locates the two K2 components. Execute the embedded components in their original order. Any reference to an embedded component is internal sequencing, not a request to load a separate skill. This is a structural directness control and does not preserve the source cross-skill authority boundary.
Embedded component: edit-pdf-wob-k2-prep-producer
Combined WOB Workflow Stage
Execute component roles below in order. A component instruction that routes to another component in this same skill is an internal checkpoint: continue directly to the next component and do not read a separate skill. Do not reinterpret a sealed non-self binding or replace the packet consumer's responsibility.
Combined role: insurance-waiver-pdf-intake-checkpoint
Insurance Waiver PDF Intake Checkpoint
When to Use
Use this first for the insurance waiver PDF task. It compares /root/input/input.pdf with /root/input/input.txt, records the observed waiver surface, and freezes the only approved edit scope before any redaction, replacement, signature, or date insertion.
Inputs
/root/input/input.pdf/root/input/input.txt
Recommended Command
python skills/edit-pdf-wob-k1-monolith/scripts/build_checkpoint.py /root/input/input.pdf /root/input/input.txt insurance-waiver-pdf-checkpoint.json
Output Contract
Write insurance-waiver-pdf-checkpoint.json with:
current_stage=intake_checkpointnext_required_skill=insurance-waiver-pdf-field-binding-noteallowed_outputs=['insurance-waiver-pdf-checkpoint.json']observed_field_handlesparsed_input_txt_fragmentscandidate_email_fragment_familyfield_owner_indexcheckpoint_checks
observed_field_handles must come from the real PDF surface and cover the observed top contact email field owner, the other field owners, the appeal-reason lines, the signature slot, and the date slot.
parsed_input_txt_fragments should keep task text as fragment handles and donor-family groups, not write-ready edits.
Scope
- Inventory the observed sink surface from the real PDF first, including field owners, line-local rectangles, appeal-reason box lines, signature slot, and date slot.
- Parse
input.txtinto fragment handles and the small email fragment family needed for later field matching. - Leave exact PDF write operations, redaction rectangles, and
/root/output/output.pdfto later stages.
Stop Condition
Stop once insurance-waiver-pdf-checkpoint.json is present, checkpoint_checks.status is ok, and insurance-waiver-pdf-field-binding-note is the only next required skill.
Combined role: insurance-waiver-pdf-field-binding-note
Insurance Waiver PDF Field Binding Note
Turn insurance-waiver-pdf-checkpoint.json into insurance-waiver-pdf-field-binding-note.json. This stage freezes the approved field-to-fragment continuation record so the waiver write packet can be built without rescanning the PDF.
Use This Skill
Use this after the intake checkpoint exists and before any exact PDF write operations are built.
Input Artifact
Required input:
insurance-waiver-pdf-checkpoint.json
Required consumed keys:
current_stagenext_required_skillallowed_outputsobserved_field_handlesparsed_input_txt_fragmentscandidate_email_fragment_familyfield_owner_index
The checkpoint should already freeze the observed waiver owners in observed_field_handles and the matching source fragments in parsed_input_txt_fragments for name, contact email, Student ID, DOB, phone, appeal reason, signature, and todays date.
If the checkpoint is missing these keys or does not point to the intake checkpoint stage, stop and repair the checkpoint first.
Output Artifact
Write insurance-waiver-pdf-field-binding-note.json with these top-level keys:
current_stagenext_required_skillallowed_outputsapproved_field_binding_tablebinding_contractfragment_catalogemail_fragment_review_setbinding_note_checks
approved_field_binding_table must stay reference-oriented and must include rows for name, top contact email, Student ID redaction, DOB, phone, appeal reason, signature, and todays date. Each row must carry:
field_namefield_ownerrow_local_fragment_handlecopied_from_fragment_handlealternate_fragment_handlesbinding_mode
Keep this note at the handle level only. Do not emit packet-ready operations or /root/output/output.pdf.
At least one email-family row should preserve copied_from_fragment_handle with binding_mode=carry_forward_fragment. The remaining rows should stay self-bound or coupled only within their own local fragment family.
Recommended Command
python skills/edit-pdf-wob-k1-monolith/scripts/write_field_binding_note.py insurance-waiver-pdf-checkpoint.json insurance-waiver-pdf-field-binding-note.json
Stop Condition
Stop when insurance-waiver-pdf-field-binding-note.json exists, current_stage=field_binding_note, and next_required_skill=insurance-waiver-pdf-write-packet-binder.
Count-Study Continuation
After this stage's local outputs are complete, read edit-pdf-wob-k2-consumer-writer before continuing. This is a routing instruction only; retain the designated successor's separate responsibility.
Embedded component: edit-pdf-wob-k2-consumer-writer
Combined WOB Workflow Stage
Execute component roles below in order. A component instruction that routes to another component in this same skill is an internal checkpoint: continue directly to the next component and do not read a separate skill. Do not reinterpret a sealed non-self binding or replace the packet consumer's responsibility.
Combined role: insurance-waiver-pdf-write-packet-binder
Insurance Waiver PDF Write Packet Binder
Use this stage after insurance-waiver-pdf-field-binding-note.json exists. It turns the approved field rows into the first exact PDF write packet and stops before any PDF file is changed.
Input Artifact
Required file: insurance-waiver-pdf-field-binding-note.json
Required top-level keys:
current_stagenext_required_skillallowed_outputsapproved_field_binding_tablebinding_contractfragment_catalogemail_fragment_review_set
Each approved_field_binding_table row must keep:
field_namefield_ownerrow_local_fragment_handlecopied_from_fragment_handlealternate_fragment_handlesbinding_mode
Recommended Command
python skills/edit-pdf-wob-k1-monolith/scripts/build_write_packet.py insurance-waiver-pdf-field-binding-note.json insurance-waiver-pdf-write-packet.json
Output Artifact
Write insurance-waiver-pdf-write-packet.json with:
current_stage=write_packet_bindernext_required_skill=insurance-waiver-pdf-output-finalizerallowed_outputsbinding_artifact_sourceresolved_pdf_write_packet.operationspacket_write_countpacket_verification
resolved_pdf_write_packet.operations should contain the exact write rows the finalizer can apply directly:
- single-line or redaction+insert rows for name, email, Student ID, DOB, and phone
- exact line rows for the appeal reason block
- signature/date rows for the observed bottom slots
Stop Condition
Stop when insurance-waiver-pdf-write-packet.json exists, packet_write_count matches the number of materialized write rows, packet_verification.binding_artifact_consumed is true, and next_required_skill is insurance-waiver-pdf-output-finalizer.
Combined role: insurance-waiver-pdf-output-finalizer
Insurance Waiver PDF Output Finalizer
Use this after insurance-waiver-pdf-write-packet.json is the current working record for the insurance waiver PDF update.
Required Inputs
insurance-waiver-pdf-write-packet.json/root/input/input.pdf
Consumed Packet Keys
current_stagenext_required_skillallowed_outputsbinding_artifact_sourceresolved_pdf_write_packetpacket_write_countpacket_verification
Recommended Command
python skills/edit-pdf-wob-k1-monolith/scripts/apply_write_packet.py insurance-waiver-pdf-write-packet.json /root/input/input.pdf /root/output/output.pdf insurance-waiver-pdf-finalization.json
Output Contract
The helper writes:
/root/output/output.pdfinsurance-waiver-pdf-finalization.json
insurance-waiver-pdf-finalization.json records:
current_stagenext_required_skillallowed_outputsoutput_pdf_pathapplied_packet_sourcepacket_write_count_matchplaceholder_clearancewritten_values_match_packetfinalization_checks
finalization_checks carries the applied write count, any missing packet values, visible placeholder markers, and any required label visibility checks supplied in packet_verification.
Stop Condition
Stop when insurance-waiver-pdf-finalization.json reports packet_write_count_match: true, placeholder_clearance: true, and written_values_match_packet: true.
If the helper reports a malformed packet row, a write-count mismatch, or missing required keys, refresh insurance-waiver-pdf-write-packet.json in insurance-waiver-pdf-write-packet-binder and rerun this stage.
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.