القائمة
当用户需要准备或维护 workspace 数据、导入或同步 PDF、查看文档、定义 schema、管理标注、调试 program.py、或运行评估时使用此 skill。如果用户只是想启动 agentic loop 或通过 Python API 一键运行完整流程，转到 agentic-extract skill。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
当用户要启动 agentic loop、使用 one-click auto、通过 Python API 调用完整流程、或在运行过程中接收 callback 和 heartbeat 事件时使用此 skill。如果用户当前主要是在准备或维护 `.xdev` 数据，先转到 xdev skill。
当文档内容过长无法一次查看、需要搜索关键词定位信息、或需要按页按节点浏览 DocJSON/PDF 结构时使用此 skill。适合与 xdev、agentic-extract 配合做长文档阅读与定位。
当用户要求更新 extract-agent 版本号、补 changelog、构建 dist、推送代码、或发布到 PyPI 时使用此 skill。只用于维护者发版，不用于日常 workspace 提取。
当你需要定义提取 schema、为文档标注数据、分析业务含义、生成业务指导文档时激活此 skill。在评估前必须先完成 schema 定义和数据标注。
当你需要编写或修改 program.py 提取代码、分析评估错误、调试提取逻辑、选择提取策略时激活此 skill。
当用户要求对某类文档或数据集开发提取程序时激活。提供从数据分析、schema 定义、标注、代码开发到评估迭代的完整无标注工作流。
| name | xdev |
| description | 当用户需要准备或维护 workspace 数据、导入或同步 PDF、查看文档、定义 schema、管理标注、调试 program.py、或运行评估时使用此 skill。如果用户只是想启动 agentic loop 或通过 Python API 一键运行完整流程，转到 agentic-extract skill。 |
xdev 负责 workspace 的数据层。
开始前先确认当前环境至少能满足本次任务。
至少检查：
xdev --help
如果任务里会阅读超长文档，再额外检查：
pdf-ai-explorer --help
如果 xdev 不可用，先安装：
uv tool install extract-agent
extract-agent 发布到 PyPI，默认安装命令不需要指定私有 index。
xdev 配置来源：
~/.config/xdev/config.json$CWD/.xdev/config.jsonXDEV_*按任务区分最小配置：
.xdev 数据：通常只要命令可用xdev import-data --set-id：需要 base_url，可放配置里或命令行传 --base-urlxdev import-data --pdfs / xdev sync-pdfs：需要本机 ppx 命令；pdf_parse_concurrent 控制批量 PDF 解析并发program.py 使用 code tools：需要在 .xdev/config.json 里显式配置 code_extractor，xdev 会把 tool_hub 注入到 extract(document, tool_hub)常用环境变量：
XDEV_BASE_URLXDEV_PDF_PARSE_CONCURRENTXDEV_MEMECT_API_BASEXDEV_DATA_DIR最小验证：
xdev listpdf-ai-explorer --help优先在这些场景使用本 skill：
.xdev/program.py不要把下面这些事放在本 skill 里：
agentic-extract run / agentic-extract auto 的迭代逻辑program.py 或做评估，读 references/run_and_eval.md.xdev 已经准备好，用户要启动 agentic 迭代，切到 agentic-extract skillworkspace 是长期目录，不是一次性运行目录.xdev/ 是数据层，program.py 是提取实现，.agent_state/ 是运行态xdev 管数据，再用 agentic-extract run 做迭代agentic-extract auto 只是 one-click 入口，不替代日常的数据维护xdev doc 的截断输出；应切到 pdf-ai-explorerxdev init /path/to/workspacecd /path/to/workspacexdev import-data 或 xdev sync-pdfs 准备 .xdevxdev list / xdev doc / xdev label-guide / xdev label-status 理解数据和标注状态program.pyxdev run <doc_id> 做单文档调试xdev eval 做评估agentic-extract skill