Skip to main content
paperops: 論文を、エージェントと書く。数個の添削で、好みの文章へ。results.tex の例として、著者の %> コメント「結論を先に。条件は Methods へ」に従って文が書き換えられ、STYLE.md に規則「段落は結論の文で始める」が追加されている。

PyPI Python CI

paperops は、AI エージェントと論文を 1 本書くためのツールです。エージェントが主張の設計から 図・本文・PDF までを作り、著者は主張の承認と数個の添削で方向を決めます。添削から読み取った好みは 規則として残り、次の草稿と次の論文に効きます。人が打つコマンドは pops init だけです。

会話から草稿まで

依頼「案 A で進めて。図と本文を最後まで作って、PDF を見せて。」に対し、エージェントが 12 ページの草稿を作り、図 3 枚を描画結果を見て直し、初見の読者が受け取った主張が BRIEF と一致したことを報告する。右側に、その裏で進む作業が並ぶ: BRIEF.md、figures/、numbers.tex、sections/、pops build、paper-check。

はじめる

uv tool install paper-harness-cli
pops init paper-rough-pipe --source ~/work/project_pipe_flow
cd paper-rough-pipe

--source は結果の出どころで、runops project の root などを指します。複数書け、後から足すこともできます。 できた directory で Codex か Claude Code を起動して、書きたい論文について話しかけてください。 英語で書き始めるときは --lang en を付けます。

頼めること

やりたいこと 頼み方の例
主張を決める project_pipe_flow の結果で論文を書きたい。主張の候補を出して
通して書かせる 案 A で進めて。図と本文を最後まで作って、PDF を見せて
結果とモデルの詳しさを決める 何が観察でき、どこまで言えるかが伝わるように結果を書いて。モデルは、その判断を左右する仮定と仕組みを説明して
結果が無い所も書かせる 粗さ 2% の計算はまだ無いが、壁の応力で説明できるはず。予想で最後まで書いて、要る計算を並べて
答え合わせをする roughness-scan の再計算が終わった。予想と比べて、原稿に反映して
骨子を見る 各段落の第 1 文だけ並べて見せて
図を直す 図 2 は主役の線が埋もれている。直して、他の図も同じ基準で見直して
添削を反映する %> でコメントを入れた。反映して、好みは STYLE に残して
伝わるか確かめる 初見の読者に読ませて、何を言う論文に見えるか確かめて
PDF だけをレビューする この PDF だけ読んで、結果とモデルで説明が詳しすぎる箇所と、残すべき根拠を挙げて
英語版を作る 日本語稿が固まったので英語版を作って
更新する paperops を最新にして

結果やモデルで何を省くか迷う節には、段落骨子に「読者が何を判断できたら説明を終えるか」を一行添えます。 たとえば改善の要因を示すなら、中間の対照は本文に残し、各条件の値の一覧は表に任せられます。執筆の手引き・判断のもとにした原著12本の読解

主張・発見・載せないものを決めるときと、それを変えるときは、エージェントが案を示して確認を取ります。 著者の判断待ちは BRIEF.md の「未決」に - [ ] で書き、決着したら - [x] にします。pops context で 未決の件数と先頭 3 件を確認できます。既存の - 項目 も未決として数えるので、以前に決着した項目にはチェックを付けてください。

添削のしかた

TeX に %> で始まるコメントを書きます。段落の上に書くとその段落全体に、行末に書くとその文に付きます。 会話で伝えても同じです。

%> 結論を先に。条件は Methods へ
本研究で用いた条件の範囲において、粗面管の圧力損失は増加する傾向が見られた(図 2)。

エージェントは指摘箇所を直し、同じ好みが当てはまる他の箇所にも広げ、好みを規則として STYLE に残します。 何を学んだかは毎回報告されるので、違っていれば「その規則は違う」と伝えてください。

VS Code でエージェントの修正と並行して書くときは、任意の拡張 Paperops Review を使えます。 原稿で Paperops: 添削用タブを開く を実行し、そのタブで本文や %> を編集します。独立した変更は自動で統合され、 重なった箇所だけ両案が表示されます。添削用タブを保存すると元の原稿に反映されます。

結果が揃う前に、流れを見る

結果がまだ無い所は、エージェントが根拠のある予想で先に書きます。予想の結果、その解釈、論文にとっての意味まで 完成形の文で書かれるので、計算を回す前に論文全体の流れを確かめられます。

% 予想: 粗さに比例するとした見積もり(BRIEF C2)。roughness-scan の再計算で置き換える
\newcommand{\stressRatio}{\pred{2.8}}
  • 予想は PDF で色が付き、BRIEF.md の発見と図にも状態(予想、predicted)が残ります。
  • 手間は、結果次第で主張が覆る所に使います。外れたら驚くような予想は理由 1 行で進め、どちらに転ぶか 分からず主張が変わる予想(賭け)にだけ、当たりの基準と外れた場合を書いて先に確かめます。
  • 新しい計算が要るものは、いまの simulator で得られるかと費用の見当を添えて、BRIEF.md に並べます。
  • 主計算の設定を既知解で確かめる必要があるときは、対照を主計算の前に置き、何がどこまで一致すればよいかを決めます。
  • 主張を支える証拠が揃ったら、検証を足すより発表を優先します。確認済みの結果に上乗せする検証(収束、感度、 条件の拡張)は、当たれば主張が覆る疑いに絞ります。範囲を変えるだけの疑いは、行った計算の範囲を成立条件として 書いて済ませます。BRIEF.md の「これから要る計算」は発表までに要るものだけになり、行わないと決めた検証は 理由つきでその下に残ります。
  • 比較条件をそろえると断り書きが短くなる場合は、既存出力で直せる箇所から直します。記述を読みやすくするためだけの 計算は、消せる文と費用を添えて、改訂時の任意の案として示します。
  • 予想するのは、これから得る結果だけです。実行済みの run、手元の data、文献の内容は、確かめたことを書きます。
  • 結果が出たら答え合わせをします。当たれば印を外し、賭けが外れたら主張と発見を直す案が示されます。

project の中身

paper-rough-pipe/
├── paper.toml              source・言語・build の設定
├── BRIEF.md                何を言う論文か(主張 1 文、発見、載せないもの、段落骨子)
├── STYLE.md                添削から学んだ、この論文での書き方
├── manuscript/
│   ├── main.tex
│   ├── sections/
│   ├── numbers.tex         本文に出す数値と出典
│   └── refs.bib
├── figures/
│   ├── paper.mplstyle      全ての図に共通の見た目
│   └── pressure-loss/
│       ├── figure.md       図の設計(メッセージ、載せないもの)と推敲の記録
│       ├── make.py
│       └── pressure-loss.pdf
├── LOG.md                  決めたことと理由
├── build/                  PDF
└── AGENTS.md, .agents/skills/, .claude/skills/

build/ は Git の対象外です。論文をまたいで使う著者の好みは ~/.config/paperops/STYLE.md に溜まります (pops init --style FILE で場所を変えられます)。 エージェントは履歴のない論文では編集前の状態を記録し、以後は草稿や添削が一区切りするたびにローカルで commit します。 著者や利用先の Git 方針を優先し、push・release は依頼時に行います。

何を言う論文かが伝わるように

エージェントに任せた原稿は、結果を正確に並べただけで、何を言いたいのかが見えなくなりがちです。 paperops は次の順で進めて、それを防ぎます。

段階 すること
書く前 BRIEF.md に主張 1 文と「載せないもの」を決め、著者が承認する
書くとき 主張の文は言い切り、主張を支える根拠を前に出す。成立条件と限界は決めた置き場に一度だけ書き、数値の出典は numbers.tex が持つ。まだ無い結果は予想で書いて印を付ける
図 描く前に figure.md へメッセージ 1 文と「載せないもの」を決める。掲載寸法の描画結果を見て直し、設計を知らない別のエージェントに画像だけを見せて、読み取った内容と使わなかった要素を確かめる
書いた後 主張を知らない別のエージェントに PDF だけを読ませ、受け取った主張を BRIEF.md と比べる

草稿の照合では、議論・限界に出る数値まで、その値を出した run と集計方法をたどります。 用語と記号は本文、caption、図の軸・凡例を見比べ、同じ名前がどこでも同じ対象を指すように揃えます。

1.x から移る

2.0 は作り直しで、1.x の _paperops/ や pops change などはありません。1.x の project は paper-harness-cli==1.0.0 のまま使えます。移すときは、新しい directory で pops init し、原稿の TeX と図を manuscript/ と figures/ に置いてから、「既存の原稿から BRIEF を起こして」と頼んでください。


SPEC · 変更履歴 · 開発に参加する

Metadata

Release files for paper-harness-cli 2.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for paper-harness-cli 2.3.0
File Size Uploaded Provenance Actions
paper_harness_cli-2.3.0.tar.gz 302.1 kB With provenance Details for paper_harness_cli-2.3.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for paper-harness-cli 2.3.0
File Interpreter ABI Platform Actions
paper_harness_cli-2.3.0-py3-none-any.whl Python 3 none any Details for paper_harness_cli-2.3.0-py3-none-any.whl

Total release size: 374.3 kB

Release files / paper_harness_cli-2.3.0.tar.gz

Download URL paper_harness_cli-2.3.0.tar.gz
Size 302.1 kB
Tags Source
SHA-256 checksum
How to use checksums
1d5c84b7f860b1cea3e379554600826f20e7a09dcbe3ed2f6799ed619ae37464
BLAKE2b-256 checksum
How to use checksums
a12809aa6529c0830cba79941576f00e6f11bf66882ef19025eeb9682182a674
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / paper_harness_cli-2.3.0-py3-none-any.whl

Download URL paper_harness_cli-2.3.0-py3-none-any.whl
Size 72.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
27f87494a101f8c24b27367916d0de30f46f37beb675d8817149a9288eda0bf1
BLAKE2b-256 checksum
How to use checksums
b7dc875e9f4e761ce0f74a8cea2eebaf4d39df7d285b15b1dd8d7bd013446f7c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Security for paper-harness-cli 2.3.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for paper_harness_cli-2.3.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page