SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场paper-spine-intake

paper-spine-intake

写作与研究

查看项目

更新于 10-15 17:06

技能介绍

用途

PaperSpine Intake 是 PaperSpine 工作流的前置配置步骤。当工作流尚未完成配置时，应先运行此技能，再开展实质性的 PaperSpine 工作。它的核心职责是收集用户选项并写入配置文件，为后续论文改写或基于材料构建论文的流程提供统一的输入。

主要能力

  • 生成两份配置文件：paper_rewriting_output/paper_spine_config.json 与 paper_rewriting_output/paper_spine_config.md。
  • JSON 配置包含以下字段：workflow、scene、tier、output_language、target_name、materials_dir、draft_path、user_motivation、official_urls、special_requirements、word_output、translation_package、reference_mode、reference_paths、citation_target_count。
  • 各字段允许的取值：workflow 为 rewrite_existing 或 build_from_materials；scene 为 journal、conference、report_review、competition；tier 为 flash 或 pro；output_language 为 en 或 zh；word_output 为 none 或 docx；translation_package 为 none 或 zh（仅当 output_language 为 en 时使用 zh）；reference_mode 为 local_first、specified_paths 或 web；reference_paths 为用于索引参考文献的本地文件夹/文件，默认 .；citation_target_count 为最终预期引用数量，默认 20。
  • 提供终端交互向导，支持方向键菜单、编号菜单回退、每个选项的说明展示、最终复核界面与编辑循环。
  • 支持全局界面语言设置模式（--setup-global）。

使用方式

该命令行的向导是 Claude Code 与 Codex CLI 支持的界面。当存在真实终端时，应通过 paper-spine-ui 路由并使用随附的外部终端向导；不要降级为让用户手写 JSON 或在聊天中逐项输入选项。

在 Claude Code 中，不要直接从 agent 的 Bash/工具调用运行 intake 向导，因为该执行环境可能不暴露 stdin 并导致挂起。正常使用 /paperspine，它在配置缺失时会自动启动该 intake UI。

如需手动运行启动器，应使用其安装后的绝对路径（不要使用相对于项目目录的路径）。文档给出的 PowerShell 启动方式如下：

$launcher = @( "$env:USERPROFILE.codex\skills\paper-spine-ui\scripts\launch_paperspine_ui.ps1", "$env:USERPROFILE.claude\skills\paper-spine-ui\scripts\launch_paperspine_ui.ps1", "$env:USERPROFILE.codex\skills\paper-spine-intake\scripts\launch_paperspine_ui.ps1", "$env:USERPROFILE.claude\skills\paper-spine-intake\scripts\launch_paperspine_ui.ps1" ) | Where-Object { Test-Path $_ } | Select-Object -First 1 powershell.exe -NoProfile -ExecutionPolicy Bypass -File $launcher -OutputDir paper_rewriting_output

该命令会打开一个独立的交互式 PowerShell 窗口。对于用户自行运行的终端，也支持以下直接命令：

WIZARD="$HOME/.codex/skills/paper-spine-ui/scripts/intake_wizard.py" [ -f "$WIZARD" ] || WIZARD="$HOME/.claude/skills/paper-spine-ui/scripts/intake_wizard.py" python "$WIZARD" --output-dir paper_rewriting_output

全局界面语言设置模式：

WIZARD="$HOME/.codex/skills/paper-spine-ui/scripts/intake_wizard.py" [ -f "$WIZARD" ] || WIZARD="$HOME/.claude/skills/paper-spine-ui/scripts/intake_wizard.py" python "$WIZARD" --setup-global --output-dir paper_rewriting_output

只有在宿主可靠暴露原生结构化提问时，才使用原生提问方式。若终端执行与原生提问均不可用，才让用户按回退模板作答。精确的问题顺序与回退模板参见 references/interactive-intake.md。

默认规则

  • journal 与 conference 默认 output_language 为 en。
  • 中文课程、中文竞赛以及明确的中文写作请求默认 output_language 为 zh。
  • 若用户已有草稿，选择 rewrite_existing。
  • 若用户拥有包含实验设置、结果、图表、笔记、PDF、Word 文件或报告的文件夹，选择 build_from_materials。
  • 若用户未选择 tier，默认 flash。
  • 若用户未要求 Word 输出，word_output 默认 none。
  • 若论文为英文，可提供 translation_package: zh 作为可选的阅读包，用于中间产物与最终结构。
  • reference_mode 默认 local_first。
  • reference_paths 默认 ["."]，除非用户提供路径。
  • citation_target_count 默认 20。

适用场景

  • 在尚未配置 PaperSpine 工作流、但准备进行论文改写或基于材料构建论文时，作为前置配置步骤。
  • 需要以结构化、可复核的方式收集论文处理选项，并产出可复用的 JSON 与 Markdown 配置时。
  • 需要设置或更改 PaperSpine 界面语言时。

限制

  • 该步骤被标注为内部 /paperspine 步骤，应通过 /paperspine 自动触发，不建议手动逐项输入配置。
  • 在 Claude Code 中不能从 agent 的 Bash/工具调用直接运行向导，否则可能因 stdin 不可用而挂起。
  • Claude Code 当前不提供公开的第三方技能 API，无法将该自定义键盘 UI 嵌入聊天输入框内部。
  • 启动器必须使用安装后的绝对路径；使用相对于项目目录的路径是 UI 窗口无法打开的常见原因。
  • 其他关于收费、价格、平台或效果的细节，资料暂未提供，不在此展开。