SuperAPI AI 工具集

using-axiv-cli

写作与研究

查看项目

更新于 10-16 01:34

技能介绍

用途:该技能指导如何通过 axiv CLI 完成 alphaXiv 论文的发现与阅读、针对论文 PDF 提问、探索论文关联的 GitHub 代码,以及列出和管理文库。

主要能力与用法:优先使用已安装的 axiv 可执行文件;在源码检出环境中,若未安装则回退到 uv run axiv 作为命令前缀。若两者都无法显示 CLI 帮助,应阅读 references/installation.md;若安装说明仍无法产生可用命令前缀,应停止并报告安装错误。任何需要认证的研究或文库工作流之前,先运行解析出的命令前缀加 auth status --json。选择具体命令时阅读 references/command-map.md,了解其认证、配额和远程影响;结果供其他工具或智能体消费时优先使用 --json。

限制与安全要求:不要手动选择或重试 MCP 传输,axiv 仅在工具分发前处理 streamable HTTP 到 SSE 的回退。不要调用 mcp2cli、直接调用 alphaXiv REST 或 MCP 端点,也不要导入私有 Python 客户端方法。当认证命令报告意外的运行时、MCP 连接、初始化或破坏性工具漂移错误时,先按 references/installation.md 更新 axiv,再仅重跑非配额、只读检查,如 axiv --help 或 axiv auth status --json。工具调用传输错误应视为终止,因为远程结果可能不明确。更新后不要自动重试消耗配额的命令或远程文库写入。

配额与写入:discover、content、query 和 code 命令会消耗 Assistant 配额,调用前应告知用户,除非请求已明确授权该研究操作。配额耗尽时应停止并报告,不要重试或替换其他消耗配额的命令。远程文库写入前,先用 axiv library list --json 获取当前不透明文件夹 ID,说明确切的 CLI 操作、文件夹 ID 或名称、以及将更改的论文 ID 或 URL,获得用户对这些确切目标的明确授权后才加 --yes;--yes 仅表示 CLI 确认,不代表用户授权。不要合并分别授权的写入,也不要在授权后扩大目标。删除文件夹前须明确说明将移除文件夹成员关系。写入目标缺失、模糊、破坏性意图不明或授权与最终命令不匹配时应停止。协调文献综述、论文分析、PDF 证据、代码验证或文库整理时阅读 references/workflows.md。根据命令的 JSON 结果验证成功,报告部分或失败结果,不自动重试写入。