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 を付けます。 投稿の前に進捗を論文の形でまとめておく論文には --track progress を付けます。主張や本文に推奨する変更があれば、 agent が反映してから報告します。既定の submission では、主張に関わる変更は著者が決めます(paper.toml で替えられます)。

頼めること

やりたいこと 頼み方の例
主張を決める project_pipe_flow の結果で論文を書きたい。主張の候補を出して
通して書かせる 案 A で進めて。図と本文を最後まで作って、PDF を見せて
結果が無い所も書かせる 粗さ 2% の計算はまだ無いが、壁の応力で説明できるはず。予想で最後まで書いて、要る計算を並べて
答え合わせをする roughness-scan の再計算が終わった。予想と比べて、原稿に反映して
骨子を見る 各段落の第 1 文だけ並べて見せて
図を直す 図 2 は主役の線が埋もれている。直して、他の図も同じ基準で見直して
添削を反映する %> でコメントを入れた。反映して、好みは STYLE に残して
節の詳しさを決める 圧力損失の節は、粗さが効いたと読者が見分けられれば十分。各条件の値は表に任せて
伝わるか確かめる 初見の読者に読ませて、何を言う論文に見えるか確かめて
PDF だけを講評させる この PDF だけ読んで、説明が詳しすぎる箇所と、残すべき根拠を挙げて
レビューさせる この PDF をレビューして。査読を通すのに必要な点と、良くする案を分けて
英語版を作る 日本語稿が固まったので英語版を作って
更新する paperops を最新にして

著者の手間は、主張の承認、図の確認、草稿への添削の 3 か所に集まります。主張・発見・載せないものを決めるときと、 それを変えるときは、エージェントが案を示して確認を取ります。ほかに著者の判断が要る点は、BRIEF.md の 「未決」に - [ ] で並び、決着すると - [x] になります。残りは次の session のエージェントにも引き継がれます。

添削のしかた

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

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

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

「この節の改稿から、次の論文にも使えることを拾って」と頼むこともできます。 著者が直接書き換えた文や、講評を受けて採用・撤回した変更をたどり、どんな場面で同じ判断が役立つかを差分とともに返します。 STYLE の「候補」「共有待ち」も手掛かりになります。実際の添削から、比較の組み方や図注の判断を取り出した 具体例があります。

エージェントが原稿を直している間に自分でも書き込むときは、任意の VS Code 拡張 Paperops Review を使えます。 添削用のタブに書いた本文や %> とエージェントの修正が自動で統合され、同じ箇所が重なったときだけ両案が 表示されます。導入と使い方は拡張の README にあります。

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

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

% 予想: 粗さに比例するとした見積もり(BRIEF C2)。roughness-scan の再計算で置き換える
\newcommand{\stressRatio}{\pred{2.8}}
  • 予想は PDF で色が付き、BRIEF.md の発見と図にも状態(予想、predicted)が残ります。
  • 予想するのは、これから得る結果だけです。実行済みの run、手元の data、文献の内容は、確かめたことを書きます。
  • 試行ごとに設定が違い、取り直しが容易なら、共通設定で比較する草稿を書きます。例えば滑面と粗面を比べるなら、 時間刻みは Methods に一度示します。その刻みで滑面の結果だけがあれば、粗面との損失の差は \pred{} で書けます。
  • 手間は、結果次第で主張が覆る所に使います。外れたら驚くような予想は理由 1 行で進め、どちらに転ぶか 分からず主張が変わる予想(賭け)にだけ、当たりの基準と外れた場合を書いて先に確かめます。
  • 結果が出たら答え合わせをします。当たれば印を外し、賭けが外れたら主張と発見を直す案が示されます。

発表までに要る計算を絞る

主張を支える証拠が揃ったら、検証を足すより発表を優先します。BRIEF.md の「これから要る計算」には 発表までに要るものだけが載るので、この表が、発表を止めているものの一覧になります。いつ発表するかは著者が決めます。

  • 表に載るのは、主張と発見が使う結果を得る計算と、賭けを確かめる計算です。いまの simulator で得られるかと 費用の見当が添えられます。
  • 確認済みの結果に上乗せする検証(収束、感度、条件の拡張)は、当たれば主張が覆る疑いに絞ります。 範囲を変えるだけの疑いには、主張の対象を行った計算に合わせます。行わないと決めた検証は、 理由つきで表の下に残ります。
  • 主計算の設定を既知解で確かめる必要があるときは、対照を主計算の前に置き、何がどこまで一致すればよいかを 先に決めます。
  • 共通設定で掲載する比較では、条件が合う既存の出力を使い、不足分の取り直しを表に載せます。

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

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

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

段階 すること
書く前 BRIEF.md に主張 1 文と「載せないもの」を決め、著者が承認する。結果やモデルで取捨が分かれる節には、段落骨子に「読者が何を判断できたら説明を終えるか」を一行添える
書くとき 主張の文は言い切り、決め手になった比較を示す。「ほぼ一致した」で足りる段落はそこで終え、差の大きさで判断が変わる箇所に数値を置く。まだ無い結果は予想で書いて印を付ける
図 描く前に figure.md へメッセージ 1 文と「載せないもの」を決める。掲載寸法の描画結果を見て直し、設計を知らない別のエージェントに画像だけを見せて、読み取った内容と使わなかった要素を確かめる
書いた後 主張を知らない別のエージェントに PDF だけを読ませ、受け取った主張と、どこで判断が済んだかを BRIEF.md と比べる。数値は議論・限界に出るものまで出どころの run と集計方法をたどり、用語と記号は本文・caption・図で揃える

結果とモデルの詳しさは、読者にしてほしい判断で決めます。たとえば改善の要因を示す節なら、中間の対照は本文に残し、 各条件の値を引くには表が、条件を変えたときの傾向を比べるには図が使えます。決め方は 執筆の手引きに、 そのもとにした原著 12 本の読解は 読解の記録にあります。

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.5.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.5.0
File Size Uploaded Provenance Actions
paper_harness_cli-2.5.0.tar.gz 316.1 kB With provenance Details for paper_harness_cli-2.5.0.tar.gz

Built distribution (wheel)

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

Total release size: 398.2 kB

Release files / paper_harness_cli-2.5.0.tar.gz

Download URL paper_harness_cli-2.5.0.tar.gz
Size 316.1 kB
Tags Source
SHA-256 checksum
How to use checksums
db93b9e22d9836cda0cb988a8daf2cf1c6557250df39f599adca64e67eddbd29
BLAKE2b-256 checksum
How to use checksums
f09b259e149783e669c940c2d34810789f4e22c9cf959c806a83ff2ac59e2bff
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 21, 2026.

Transparency log

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

Download URL paper_harness_cli-2.5.0-py3-none-any.whl
Size 82.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8552e80ad9f0c0b7ab11758535ad4512e6919865f28e0be6196380a35bfc90a9
BLAKE2b-256 checksum
How to use checksums
9c40868119261d1eb089e27215c225c73e723473401adb4aec09ce736e7567de
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 21, 2026.

Transparency log

Security for paper-harness-cli 2.5.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.5.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 21, 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