paperzilla

Paperzilla

Paperzilla のプロジェクト、おすすめ、標準的な論文についてエージェントとチャットするときに、このスキルを使用します。

質問できること

• 「プロジェクト X の最新のおすすめを教えてください。」
• 「おすすめ Y を開いて、なぜ重要なのか説明してください。」
• 「標準的な論文 Z をマークダウン形式で取得して要約してください。」
• 「この論文が私の研究にどう関係するか教えてください。」
• 「プロジェクト X のフィードを表示してください。」
• 「おすすめにフィードバックを残してください。」
• 「この論文、おすすめ、またはフィードを JSON 形式でエクスポートしてください。」

これは Paperzilla の中核となるスキルです。エージェントが Paperzilla のデータに直接アクセスできるようにしますが、ワークフローや外部への配信連携は規定しません。

アクセス方法

このリポジトリの現在のプロファイルのほとんどでは、pz CLI を使用します。

現在のプロファイルにエージェント固有の追加指示が含まれている場合は、それらにも従ってください。

インストール

macOS

brew install paperzilla-ai/tap/pz

Windows（Scoop）

scoop bucket add paperzilla-ai https://github.com/paperzilla-ai/scoop-bucket
scoop install pz

Linux

公式の Linux インストールガイドを参照してください。

• https://docs.paperzilla.ai/guides/cli-getting-started

ソースからビルド（Go 1.23+）

ソースからビルドする場合は、CLI リポジトリを参照してください。

• https://github.com/paperzilla-ai/pz

更新

CLI が最新かどうかを確認し、インストール方法に応じたアップグレード手順を確認します。

pz update

検出結果が曖昧な場合は、明示的に指定してください。

pz update --install-method homebrew
pz update --install-method scoop
pz update --install-method release
pz update --install-method source

対応する値は auto、homebrew、scoop、release、source です。

認証

pz login

CLI リファレンス

現在のプロファイルで pz を使用している場合は、以下が主要なコマンドです。

プロジェクトの一覧表示

pz project list

1 つのプロジェクトを表示

pz project <project-id>

プロジェクトのフィードを閲覧

pz feed <project-id>

便利なフラグ：

• --must-read
• --since YYYY-MM-DD
• --limit N
• --json
• --atom

例：

pz feed <project-id> --must-read --since 2026-03-01 --limit 5
pz feed <project-id> --json
pz feed <project-id> --atom

フィードの出力には、既存のおすすすめのフィードバックマーカーが含まれる場合があります。

• [↑] 高評価
• [↓] 低評価
• [★] スター

標準的な論文を読む

pz paper <paper-id>
pz paper <paper-id> --json
pz paper <paper-id> --markdown
pz paper <paper-id> --project <project-id>

自分のプロジェクトからおすすめを開く

pz rec <project-paper-id>
pz rec <project-paper-id> --json
pz rec <project-paper-id> --markdown

おすすめにフィードバックを残す

pz feedback <project-paper-id> upvote
pz feedback <project-paper-id> star
pz feedback <project-paper-id> downvote --reason not_relevant
pz feedback clear <project-paper-id>

出力と自動化

• 機械による解析には --json を使用してください。
• pz paper --markdown は、マークダウンがすでに用意されている場合にのみマークダウンを返します。
• pz rec --markdown はマークダウンの生成をキューに追加できます。生成中は、再試行を促すメッセージが表示されます。
• --atom は、フィードリーダーで使用する個人用フィード URL を返します。

設定

export PZ_API_URL="https://paperzilla.ai"

参考資料

• ドキュメント：https://docs.paperzilla.ai/guides/cli
• クイックスタート：https://docs.paperzilla.ai/guides/cli-getting-started
• リポジトリ：https://github.com/paperzilla-ai/pz

エージェントの作業手順

1. 環境を確認します。 調査の質問、データベース、期間、採用基準を確認します。
2. 入力を明確にします。 データまたはユーザーから、形式、識別子、パラメーターを確認します。結果に影響する値を推測せず、質問します。
3. まず小規模に実行します。 1つのデータベースで絞り込んだクエリを使って検索し、結果が関連していることを確認します。
4. 上記の手順と参考資料を使って、タスク全体を実行します。
5. 結果を検証します。 すべての参考文献は、解決可能な識別子を持つ実際のレコードから取得されていることを確認します。件数と検索文字列を記録します。
6. 報告します。 実行した内容（バージョン、コマンド、パラメーター）、確認した内容、未確定の事項を明示します。

これが起きた場合	対応すること
API がレート制限を適用する、またはエラーを返す	時間をおいて再試行する、バッチサイズを小さくする、またはデータベースを切り替え、未対応の範囲を報告します。
これらの手順に記載された関数、フラグ、エンドポイントが、インストール済みバージョンに存在しない	インストール済みバージョンのドキュメント（help()、--help、公式ドキュメント）を確認して対応し、ユーザーに伝えます。API を捏造してはいけません。
必須の入力、識別子、またはパラメーターが曖昧	ユーザーに質問するか、実行前に仮定を明示します。

誠実性に関するルール

• 結果、パラメーター、識別子、引用、統計情報を決して捏造しません。実行または検証できない場合は、その旨を明確に伝えます。
• 取得していない論文を要約してはいけません。記憶に基づいて引用してはいけません。
• ここに記載されているバージョン固有の情報は古い可能性があるものとして扱い、インストール済みバージョンの公式ドキュメントで確認します。
• 金銭が発生する行為、共有 GPU やクラウドのクォータを消費する行為、個人データまたは患者データを扱う行為、元に戻せない行為については、実行前に確認を求めます。