mcpField
P
paper-spine-ui

paper-spine-ui

github.com/wubing2023エージェントワークフロー6.1k204 回インストール2 週間前に更新
リポジトリ

paper-spine-ui について

paper-spine-uiは、設定がない場合や対話形式での設定を求められた場合に使うPaperSpineの設定スキルです。ターミナルのウィザードを起動し、対話型端末が使えない場合は番号付きメニューやチャットで質問します。

主な機能

  1. 01対話型設定ウィザードの起動
  2. 02ターミナルUIで項目や選択肢を編集
  3. 03PaperSpine設定ファイルの保存
  4. 04番号付きメニューやチャットへの切り替え

活用シーン

  1. 01設定がない場合のPaperSpine構成
  2. 02対話型ターミナルでPaperSpineを設定
  3. 03グラフィカルなターミナルが使えない環境での設定

インストール

コマンドをコピーしてターミナルで実行します。

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

インストール後、Claude Code で/paper-spine-uiを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

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

詳細

PaperSpine UI

paper_spine_config.json が存在しない、不完全である、またはユーザーが PaperSpine の対話形式での設定を求めた場合は、常にこのブランチを使用してください。

必須の動作

サポートされている対話方法は、インストール済みの launch_paperspine_ui.ps1（~/.codex/skills/... または ~/.claude/skills/... の下で絶対パスを解決します）が起動する、実際のターミナルウィンドウです。ホストが標準入力を公開できない場合、非表示のツール画面で input() ベースの Python を実行しないでください。

Claude Code では、設定が存在しない場合に /paperspine がこのブランチを自動的に呼び出す必要があります。

Codex では、このウィンドウの起動によって表示可能な GUI／ターミナルが開くため、Codex はこれを権限昇格が必要なアクションとして扱います。sandbox_permissions: require_escalated を指定して要求してください。指定しないと、ウィンドウが確実に表示されません。設定が存在しない場合は、最初のアクションとして 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

別ウィンドウが表示されない場合（ヘッドレス環境、または対話可能なデスクトップのないサンドボックス化された Codex）、-InPlace を追加して、現在のターミナルでウィザードを実行してください。標準入力も対話的でない場合は、番号付きメニューまたはネイティブの質問機能に切り替えてください。設定を黙って省略してはいけません。

UI の書き込み先：

paper_rewriting_output/paper_spine_config.json
paper_rewriting_output/paper_spine_config.md

UI の仕様

  • 可能な場合は、独立した対話型ターミナルウィンドウを開きます。
  • 実際の Windows ターミナルが利用できる場合は、全画面のターミナル UI を表示します。中央揃えのウェルカム画面、白い ridge のワードマーク、読みやすいフィールド／オプションパネル、およびフィールド一覧 30％・詳細パネル 70％の安定したレイアウトを使用します。
  • フィールドの移動には上下キー、選択肢フィールドの操作には左右キー、テキスト／リストの編集には Enter、保存には S、終了には Q を使用します。
  • 右側のパネルには、選択中のフィールド 1 つ分の推論と値の詳細だけを表示します。長い JSON 風のチェックリストをチャットに出力しないでください。
  • 矢印キーを使う UI が利用できない場合に限り、番号付きのターミナルメニューに切り替えます。
  • ターミナルの実行が不可能な場合に限り、チャットで質問します。
  • ユーザーに JSON の手動作成を求めてはいけません。

質問の順序とフォールバック用テンプレートについては、references/interactive-intake.md を参照してください。

コメント

Markdown 対応