offer-letter-checkpoint
Checkpoint the offer letter inputs, relocation markers, and target output path before any document edits.
- License 许可
- MIT
- 最近更新
- 2026-09-30
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- offer-letter-checkpoint
- description
- Checkpoint the offer letter inputs, relocation markers, and target output path before any document edits.
03 SKILL.md 正文
Offer Letter Checkpoint
Purpose
Freeze the concrete offer letter inputs and output target before any placeholder replacement or .docx write. This keeps the template path, employee data source, relocation block markers, and required output checks stable for downstream handling and later review.
Inputs
environment/offer_letter_template.docxenvironment/employee_data.json
Outputs
workflow/intake_checkpoint.jsonworkflow/continuation_gate.json
Required Artifacts
Write workflow/intake_checkpoint.json with exactly these fields:
{
"task_id": "offer-letter-generator",
"template_path": "environment/offer_letter_template.docx",
"employee_data_path": "environment/employee_data.json",
"output_path": "/root/offer_letter_filled.docx",
"conditional_markers": ["{{IF_RELOCATION}}", "{{END_IF_RELOCATION}}"],
"required_output_checks": [
"replace template placeholders from employee_data.json",
"clear all remaining {{...}} placeholders",
"remove {{IF_RELOCATION}} and {{END_IF_RELOCATION}} markers from final offer letter",
"keep relocation section content when RELOCATION_PACKAGE is Yes",
"preserve relocation block as pending continuation at checkpoint time"
],
"status": "checkpointed"
}
Write workflow/continuation_gate.json with exactly these fields:
{
"checkpoint_artifact": "workflow/intake_checkpoint.json",
"next_stage": "offer-letter-working-set",
"checkpoint_reason": "Freeze input and output identity before placeholder replacement or docx write, and keep relocation markers pending continuation until downstream document handling.",
"status": "pending_continuation"
}
Steps
- Confirm both input files exist and are the only sources used for this checkpoint.
- Record the fixed template path, employee data path, and target output path in
workflow/intake_checkpoint.json. - Record the relocation block markers as
conditional_markersand leave them pending continuation rather than resolved output. - Record only the required output checks needed for later offer letter completion.
- Write
workflow/continuation_gate.jsonso the next stage consumes the checkpoint instead of rescanning broadly.
Constraints
- Freeze input and output identity before any placeholder replacement or
.docxwrite. - Record the
{{IF_RELOCATION}}...{{END_IF_RELOCATION}}block as pending continuation rather than resolved output. - Do not write
/root/offer_letter_filled.docxin this stage.
Handoff
The next stage reads these exact keys from workflow/intake_checkpoint.json:
template_pathemployee_data_pathoutput_pathconditional_markersrequired_output_checksstatus
The next stage reads these exact keys from workflow/continuation_gate.json:
next_stagecheckpoint_reasonstatus
Stop Condition
Stop after both workflow records exist with the exact field names above and the stage has not modified the Word template or written /root/offer_letter_filled.docx.
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.