菜单
当用户要启动 agentic loop、使用 one-click auto、通过 Python API 调用完整流程、或在运行过程中接收 callback 和 heartbeat 事件时使用此 skill。如果用户当前主要是在准备或维护 `.xdev` 数据，先转到 xdev skill。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
当文档内容过长无法一次查看、需要搜索关键词定位信息、或需要按页按节点浏览 DocJSON/PDF 结构时使用此 skill。适合与 xdev、agentic-extract 配合做长文档阅读与定位。
当用户要求更新 extract-agent 版本号、补 changelog、构建 dist、推送代码、或发布到 PyPI 时使用此 skill。只用于维护者发版，不用于日常 workspace 提取。
当用户需要准备或维护 workspace 数据、导入或同步 PDF、查看文档、定义 schema、管理标注、调试 program.py、或运行评估时使用此 skill。如果用户只是想启动 agentic loop 或通过 Python API 一键运行完整流程，转到 agentic-extract skill。
当你需要定义提取 schema、为文档标注数据、分析业务含义、生成业务指导文档时激活此 skill。在评估前必须先完成 schema 定义和数据标注。
当你需要编写或修改 program.py 提取代码、分析评估错误、调试提取逻辑、选择提取策略时激活此 skill。
当用户要求对某类文档或数据集开发提取程序时激活。提供从数据分析、schema 定义、标注、代码开发到评估迭代的完整无标注工作流。
| name | agentic-extract |
| description | 当用户要启动 agentic loop、使用 one-click auto、通过 Python API 调用完整流程、或在运行过程中接收 callback 和 heartbeat 事件时使用此 skill。如果用户当前主要是在准备或维护 `.xdev` 数据，先转到 xdev skill。 |
agentic-extract 负责 workspace 的运行层。
开始前先确认当前环境至少能满足本次任务。
至少检查：
agentic-extract --help
如果命令不可用，先安装：
uv tool install extract-agent
extract-agent 发布到 PyPI，默认安装命令不需要指定私有 index。
agentic-extract 最小需要的 LLM 配置通常是：
modelapi_baseapi_key模型名前缀规则要明确：
provider/model_nameopenai、deepseek、gemini、anthropicmodel 里不写前缀，当前会默认按 openai 解析openai/<model_name>deepseek/<model_name>，例如 deepseek/deepseek-v4-prohttps://code.memect.cn 这类 OpenAI 兼容端点，glm-5 应写成 openai/glm-5，不要写 anthropic/glm-5anthropic/<model_name>agentic-extract run --dry-run 验证，不要依赖隐式默认行为常见来源：
AE_MODEL / AE_API_BASE / AE_API_KEY~/.config/agentic-extract/config.json$CWD/.agentic-extract.json.agentic-extract.json如果当前任务是 agentic-extract auto，还要注意：
--set-id 路径需要 base_url--pdfs-dir 路径需要本机 ppx 命令可用--data-dir 路径通常只依赖本地数据最小验证优先使用：
agentic-extract run \
--workspace /path/to/workspace \
--model openai/gpt-4.1 \
--api-base https://api.openai.com/v1 \
--api-key "$OPENAI_API_KEY" \
--dry-run
优先在这些场景使用本 skill：
.xdev 数据，准备启动 agentic loop不要把下面这些事放在本 skill 里：
xdev 的数据维护命令重新包装一遍.xdev 还没准备好且用户只是在做数据维护，切到 xdev skillagentic-extract run 是纯运行命令agentic-extract auto 是 one-click 准备加运行xdev，不属于 agentic-extract.agent_state/，这是运行层，不是数据层.xdev，否则先走 xdevagentic-extract run --workspace /path/to/workspaceagentic-extract autorun_agentic_extract()run_agentic_extract_auto()on_event callback 和 heartbeat_interval_sec