pdfcraft-cli-automation 属于 PdfCraft 技能体系，定位为多步 PDF 自动化与中断恢复的受控执行技能。其来源资料明确指出，当用户需要多步 PDF 自动化、单会话文档 ID、任务回执，或在超时、中断后进行只读对账时使用该技能；对状态为 UNKNOWN 的任务，禁止自动重放写入。
运行环境与发行状态 该技能当前处于受控开发预发布状态。运行要求 Python 3.11 及以上；固定发行版为 printcraft-cli 0.2.1，仅 macOS arm64 锁经过验证。入口命令保持 printcraft，资料特别说明不应把 research 的 PdfCraft 新接口当作当前发行能力。所有脚本和引用随技能分发，不依赖兄弟目录；运行时放在独立用户数据目录。需将 SKILL_DIR 设置为宿主实际加载的本文件目录。
安装诊断与命令入口 资料给出的命令包括： python3 -I -B "$SKILL_DIR/scripts/bootstrap.py" --diagnose 仅在已有安装授权时： python3 -I -B "$SKILL_DIR/scripts/bootstrap.py" --runtime-home "$RUNTIME_DIR" 随后可用 commands.py 的 list 查看命令、describe 查看单个命令的参数 Schema： python3 -I -B "$SKILL_DIR/scripts/commands.py" list --runtime-home "$RUNTIME_DIR" python3 -I -B "$SKILL_DIR/scripts/commands.py" describe doc_open --runtime-home "$RUNTIME_DIR" --archive 可指定离线固定 ZIP，仍会验证全部摘要；不修改 PATH。资料提示 cli.py -- tools 首次使用可能发生安装，因此不能称为只读安装诊断。
计划与执行流程 计划格式为 {"domain":"printcraft","steps":[{"command":"实际工具名","params":{}}]}，应先查 Schema 再填参数。典型流程为：先用 check 检查计划，再用 run 执行并指定全新输出目录、预期输出清单、原始 PDF 输入与运行时目录；随后用 status 查看任务回执，用 reconcile 做只读对账，用 verify 验证请求。一个 run 在一个原生进程中按顺序执行，doc ID 仅在该会话内有效。步骤不是事务性的，后续步骤失败不会撤销之前已保存的结果。runId 只用于追踪，不保证 exactly-once；已执行或结果不明的任务不能通过更换目录或 runId 重放。只读对账不会启动原生编辑；旧或损坏的回执拒绝恢复，应保留原件调查。
文件保护与授权边界 显式通过 --input 登记需保护的文件或目录后，执行前后会检测摘要；参数中未登记的路径不受该检查覆盖，这不是沙箱。优先编辑工作副本。现有用户授权可直接复用，仅在新增原件覆盖、真实打印或超出输出范围时重新确定授权。原生过程可能写文件、联网或使用系统资源。
验收与结果审核 零退出码只到达 REVIEW_REQUIRED 状态。必须检查显式清单、大小与摘要、新进程重开、逐页文本与几何，再完成与当前摘要绑定的视觉审阅。未知或部分结果不自动重放，也不自动循环修订。表单、脱敏、签名、PDF/A、OCR 需分别记录验收状态。
秘密与中文 OCR 秘密字段包含 password、passwd、secret、token、api_key、credential；公开回执会脱敏，私有执行材料权限为 0600，结束后清理。应避免把秘密放进文件名或不相关普通字段，任务目录仍可能含敏感 PDF，需由用户按保留策略清理。中文扫描识别方面，资料提到显式可选 Tesseract 后端见“中文 OCR 契约”，但原生 0.2.1 仍只有英语；该路径会生成栅格化新副本，需先核实输出策略及后端身份。
适用场景与限制 适用于多步 PDF 处理计划、需要任务回执与恢复核对的批处理，以及中断后的只读对账。限制包括：仅 macOS arm64 锁经验证、预发布状态、非事务执行、回执异常需人工调查、UNKNOWN 禁止自动重放、未登记路径不在保护范围内。资料未提供价格、收费方式或更多平台支持信息。