mcpField
P
paper-spine-intake

paper-spine-intake

github.com/wubing2023Agent 工作流6.1k226 次安装2 周前更新
代码仓库

关于 paper-spine-intake

paper-spine-intake 是 PaperSpine 的配置技能，供准备改写论文或依据材料撰写论文的用户使用。它通过终端向导收集设置，并保存为 JSON 和 Markdown 文件。

主要功能

  1. 01终端配置向导
  2. 02改写或依据材料撰写
  3. 03设置语言、输出和参考文献
  4. 04保存前审阅并修改配置

适用场景

  1. 01开始论文工作前配置 PaperSpine
  2. 02选择期刊或会议论文设置
  3. 03配置参考文献来源和引用数量

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/wubing2023/paperspine --skill paper-spine-intake

安装后在 Claude Code 中输入/paper-spine-intake确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
interactive-intake.md
version-requirements.md
scripts/
_paper_spine_utils.py
humanize_check.py
intake_wizard.py
launch_paperspine_ui.ps1
launch_paperspine_ui.sh

详细介绍

PaperSpine 需求收集

当工作流尚未配置时，在开展实质性的 PaperSpine 工作之前使用此技能。

必需输出

创建：

  • paper_rewriting_output/paper_spine_config.json
  • paper_rewriting_output/paper_spine_config.md

JSON 必须包含：

{
  "workflow": "rewrite_existing",
  "scene": "journal",
  "tier": "flash",
  "output_language": "en",
  "target_name": "",
  "materials_dir": "",
  "draft_path": "",
  "user_motivation": "",
  "official_urls": [],
  "special_requirements": [],
  "word_output": "none",
  "translation_package": "none",
  "reference_mode": "local_first",
  "reference_paths": ["."],
  "citation_target_count": 20
}

允许的值：

  • 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

交互规则

命令行向导是 Claude Code 和 Codex CLI 支持的 UI。 当有可用的真实终端时，应通过 paper-spine-ui 调用，并使用打包的外部终端向导；不要退而要求用户手动编写 JSON，或在聊天中逐项输入所有选项。

在 Claude Code 中，不要直接从 Agent Bash/工具调用运行需求收集向导。该执行环境可能无法提供 stdin，并可能导致挂起。 正常工作时请使用 /paperspine；缺少配置时，它会自动启动此需求收集 UI。该 UI 是真实终端 TUI，支持使用 Up/Down 切换选项、Left/Right 切换字段、Enter 编辑/确认，以及 S 保存。Claude Code 目前不提供公开的第三方技能 API，无法将此自定义键盘 UI 嵌入聊天输入框本身。如有需要，请使用其绝对安装路径运行启动器（切勿使用相对于项目目录的路径）：

# Pass the ABSOLUTE path to the installed launcher. Codex/Claude run from the
# user's project folder, where `scripts/` does not exist, so a relative path is
# the most common reason the UI window never opens. Resolve the install dir:
$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

向导在真实终端中提供方向键菜单，必要时会回退到编号菜单；显示每个选项的说明；提供最终审核界面和编辑流程；并写入 JSON 和 Markdown 配置文件。

仅当宿主在当前会话中能可靠地提供原生结构化问题时，才使用这些问题。如果终端执行和原生问题均不可用，则只能此时要求用户按照备用模板作答。

有关确切的问题顺序和备用模板，请阅读 references/interactive-intake.md。

默认值

  • journal 和 conference 默认使用 en。
  • 中文课程、中文竞赛，以及明确要求用中文写作时，默认使用 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。

全局 UI 语言

首次设置时，或用户要求更改 PaperSpine 界面语言时，以全局设置模式运行向导：

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

所有配置字段都使用向导的终端 UI。优先在真实终端中使用方向键 UI；无法使用时，回退到编号命令行菜单。除非无法执行终端操作，否则不要要求用户手动输入 JSON/选项。

评论

支持 Markdown