用途：以 uv run rag-cli ... 的方式安全、一致地运行本项目自带的本地 RAG 工作流，适用于提及 rag-cli、uv、init/ingest/query/docs、本仓库文档索引检索，以及需要 --format json 工具化输出的场景。
主要能力：初始化工作区、摄取文档、检索问答、查看索引信息。命令顺序通常为：uv sync；uv run rag-cli init --workspace <path>；uv run rag-cli ingest --workspace <path> --src <path> [--recursive] [--ext ...] --format json；uv run rag-cli query --workspace <path> --question "<question>" --mode hybrid --top-k 3 --format json；uv run rag-cli docs --workspace <path> --format json。
输出约定：供代理或工具消费时默认使用 --format json。成功返回 answer: string、snippets（含 doc、section、text）、meta；错误返回 error（含 code、message、details）。仅人工阅读时可用 --format text。
工作区与配置：不在仓库根目录操作时应始终显式传 --workspace。init 会创建 .rag/ 及基线配置与索引状态。所需环境键：POE_API_KEY（优先）、OPENAI_BASE_URL（默认 https://api.poe.com/v1）、LLM_MODEL（默认 gemini-3.1-flash-lite）、EMBEDDING_MODEL（可选）；未设置 POE_API_KEY 时兼容 OPENAI_API_KEY。
集成与排错：工具参数名需与 skills/search_docs_cli.json（workspace、question、mode、top_k）及 skills/index_files_cli.json（workspace、path、recursive、ext）保持一致。如报缺少索引，先 init 再 ingest，然后重试 query/docs；ingest 为空时检查 --src 是否存在、--ext 过滤及是否加 --recursive；缺 API/环境值时设置相应变量并在同一会话重跑；非零退出码时改用 --format json 解析 error.code 与 error.message 后修复重试。
限制：资料未提供该技能的收费、平台支持范围及效果保证等信息。