القائمة
当用户要启动 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