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-lunar-cavity --source ~/large1/project_cylindrical_hole
cd paper-lunar-cavity

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

頼めること

やりたいこと 頼み方の例
主張を決める project_cylindrical_hole の結果で論文を書きたい。主張の候補を出して
通して書かせる 案 A で進めて。図と本文を最後まで作って、PDF を見せて
骨子を見る 各段落の第 1 文だけ並べて見せて
図を直す 図 2 は主役の線が埋もれている。直して、他の図も同じ基準で見直して
添削を反映する %> でコメントを入れた。反映して、好みは STYLE に残して
伝わるか確かめる 初見の読者に読ませて、何を言う論文に見えるか確かめて
英語版を作る 日本語稿が固まったので英語版を作って
更新する paperops を最新にして

主張・発見・載せないものを決めるときと、それを変えるときは、エージェントが案を示して確認を取ります。

添削のしかた

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

%> 結論を先に。条件は Methods へ
本研究で用いた条件の範囲において、空洞底部の電位は低下する傾向が見られた(図 2)。

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

project の中身

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

build/ は Git の対象外です。論文をまたいで使う著者の好みは ~/.config/paperops/STYLE.md に溜まります (pops init --style FILE で場所を変えられます)。

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

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

段階 すること
書く前 BRIEF.md に主張 1 文と「載せないもの」を決め、著者が承認する
書くとき 主張の文は言い切る。成立条件は決めた置き場に一度だけ書き、数値の出典は numbers.tex が持つ
図 掲載寸法の描画結果を見て直す round を回し、figure.md に記録する
書いた後 主張を知らない別のエージェントに PDF だけを読ませ、受け取った主張を BRIEF.md と比べる

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.0.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.0.0
File Size Uploaded Provenance Actions
paper_harness_cli-2.0.0.tar.gz 192.7 kB With provenance Details for paper_harness_cli-2.0.0.tar.gz

Built distribution (wheel)

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

Total release size: 241.3 kB

Release files / paper_harness_cli-2.0.0.tar.gz

Download URL paper_harness_cli-2.0.0.tar.gz
Size 192.7 kB
Tags Source
SHA-256 checksum
How to use checksums
ce24e4a2e076e5993d05414494af9ca9c4d199b1be05ba6b3be691a28211f8ac
BLAKE2b-256 checksum
How to use checksums
6c7b3e216641182b254e0731fb809c6837973f026221155bda87b22d84c3692b
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 5, 2026.

Transparency log

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

Download URL paper_harness_cli-2.0.0-py3-none-any.whl
Size 48.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f864ae97e7bd0199313368e195c0ba34d485acf6ddee264b99eab09df2641018
BLAKE2b-256 checksum
How to use checksums
acbda14eb848245dbdcaa4dcf951e7ab12e55c13af51159891bdd1d2b354aec4
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 5, 2026.

Transparency log

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