paper-spine-intake

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 では、エージェントの Bash／ツール呼び出しから初期設定ウィザードを直接実行しないでください。その実行環境では標準入力が利用できず、処理が停止することがあります。通常の作業では /paperspine を使用してください。設定がない場合、初期設定 UI が自動的に起動します。この UI は実際のターミナルで動作する TUI で、上／下キーでオプションを切り替え、左／右キーでフィールドを切り替え、Enter キーで編集／確定し、S キーで保存します。Claude Code では現在、チャット入力欄にこのカスタムキーボード UI を埋め込むためのサードパーティー向け公開スキル API は提供されていません。必要に応じて、プロジェクトディレクトリからの相対パスではなく、インストール先の絶対パスでランチャーを実行してください。

# 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 を選択します。
• ユーザーがティアを選択しない場合は、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 やオプションをユーザーに手入力させないでください。