paper-harness-cli 2.2.0__tar.gz → 2.2.1__tar.gz

{paper_harness_cli-2.2.0 → paper_harness_cli-2.2.1}/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 2.2.1（2026-11-12）
+
+- `paper-predict`: 著者が「合っているはず」と述べた予想の扱いを改めた。これまでは無条件に賭けから外していたため、
+  手元の結果や出た結果と食い違う場合にも著者の見込みが優先される読み方ができた。著者の見込みで省くのは
+  上乗せの検証（確かめるための計算、分岐）に限り、既にある証拠と食い違うときは、食い違いを具体的に著者へ伝え、
+  説明が付くまでは証拠を含めて判断し直す。
+- skill から、いまの agent が指示なしで行う一般的な作法を外した。残したのは、project の約束、agent の既定の
+  振る舞いに逆らう方針、実際の project での失敗から入れた判断の手順。
+  - `paper-figure`: 推敲の下限（少なくとも 2 round）、主役を強い色と太い線で描くという描き方、対数と線形や
+    配色の選び方、軸 label の単位と panel の記号の確認。
+  - `paper-predict`: 得られるかの見積もりで見比べる量の列挙。
+  - `paper-draft`: `paper-check` に書いてある読者テストのやり直しの繰り返し。
+
 ## 2.2.0（2026-11-11）
 
 2.1.0 は PyPI に公開していない。手元で配った 2.1.0 の project と区別できるように、2.1.0 の内容を含めて

{paper_harness_cli-2.2.0 → paper_harness_cli-2.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: paper-harness-cli
-Version: 2.2.0
+Version: 2.2.1
 Summary: Minimal harness for writing a paper with AI agents: brief, figures, review comments, learned style
 Project-URL: Homepage, https://github.com/Nkzono99/paperops
 Project-URL: Repository, https://github.com/Nkzono99/paperops

{paper_harness_cli-2.2.0 → paper_harness_cli-2.2.1}/SPEC.md

@@ -119,7 +119,8 @@ run directory（`manifest.toml` を持つ）と `_` で始まる directory の
 4. **手間を賭けの大きさに合わせる。** 外れたら驚く予想は理由 1 行で進め、確かめるためだけの計算も、外れた場合の
    分岐も足さない。どちらに転ぶか分からず主張が変わる予想（賭け）にだけ、当たりの基準と外れた場合を書き、先に確かめる。
    主張 1 文が賭けに依るときは、外れても言える主張を添える。しきい値では決めず、「外れたら驚くか」
-   「厳密にしたら論文の言うことが変わりうるか」で判断する。
+   「厳密にしたら論文の言うことが変わりうるか」で判断する。著者の見込みは上乗せの検証を省く理由になるが、
+   手元の証拠や出た結果と食い違うときは、食い違いを著者に伝え、説明が付くまでは証拠を含めて判断し直す。
 5. **新しい計算が要るものは、得られるかを見積もる。** source の case、simulator の文書、過去の run の資源から、
    いまの simulator で出せるか、費用はどれほどかを書く。分からないことは分からないと書く。
 6. **理由を残す。** 数値の予想は `numbers.tex` のコメントに、図の予想は `make.py` の `predict()` に code として書く。

{paper_harness_cli-2.2.0 → paper_harness_cli-2.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "paper-harness-cli"
-version = "2.2.0"
+version = "2.2.1"
 description = "Minimal harness for writing a paper with AI agents: brief, figures, review comments, learned style"
 readme = "README.md"
 requires-python = ">=3.11"

{paper_harness_cli-2.2.0 → paper_harness_cli-2.2.1}/src/paperops/__init__.py

@@ -1,3 +1,3 @@
 """paperops: a minimal harness for writing a paper with AI agents."""
 
-__version__ = "2.2.0"
+__version__ = "2.2.1"

{paper_harness_cli-2.2.0 → paper_harness_cli-2.2.1}/src/paperops/skills/paper-draft/SKILL.md

@@ -31,8 +31,7 @@ BRIEF が決まっていれば、図から PDF までを著者の手を借りず
 
 6. **build する。** `pops build` を実行し、エラー、未定義の参照と引用を無くす。
 
-7. **確かめて直す。** `paper-check` の読者テストと照合を行い、見つかった問題を直す。直したら新しい読者で
-   もう一度確かめる。2 回直しても伝わらない点は、BRIEF の問題として著者に伝える。
+7. **確かめて直す。** `paper-check` の読者テストと照合を行い、見つかった問題を直す。
 
 8. **著者に渡す。** 次を短く伝える。
    - PDF の場所と、`pops outline` の出力（骨子）。

{paper_harness_cli-2.2.0 → paper_harness_cli-2.2.1}/src/paperops/skills/paper-figure/SKILL.md

@@ -67,26 +67,24 @@ figures/<name>/
 
 4. **見て直す。** `<name>.png` を画像として開いて見る。下の観点を上から順に確かめ、問題を直して描き直す。
    これを 1 round として、`figure.md` の推敲記録に `- R1: 見つけた問題 → 変えたこと` と 1 行で残す。
-   直すところが見つからなくなるまで続ける（少なくとも 2 round、多くて 5 round。手順 5 の初見の round も数え、
+   直すところが見つからなくなるまで続ける（多くて 5 round。手順 5 の初見の round も数え、
    既存の記録があれば番号を続ける）。
    直すときは、足す前に減らす。読み取りにくい所へ注記や panel を足すと、その分だけ読者の読む量が増える。
    まず主役以外を弱めるか除き、それでも読めないときに足す。足すのは、比較そのものを指す印（見比べる所に
    置く名前や記号、基準線 1 本）にし、説明の文は caption に書く。
 
    1. **メッセージと主役**: 5 秒見て、`figure.md` のメッセージが言えるか。読者にさせる比較が、図の中で
-      いちばん目立つ要素になっているか。主役の系列には強い色と太い線を使い、脇役は灰色や細い線に落とす。
+      いちばん目立つ要素になっているか。
    2. **取捨**: `save()` が表示した要素を 1 つずつ見て、「これを消すと、メッセージが読めなくなるか」を問う。
       読めるままなら消すか、「載せないもの」に行き先を書いて移す。人が一度に見分けて覚えていられるのは
       4 つ前後なので、色で見分ける系列が 1 つの panel に 5 本以上ある図や、凡例・注記・panel が設計より
       増えている図は、手順 1 に戻って描く量と形を選び直す。数は目安で、決めるのは上の問いである。
    3. **読む手数**: 読者の目が行き来する所を減らす。凡例と線の往復は、線のそばに直接書く名前でなくす。
       見比べるものは同じ軸の上か隣り合う panel に置き、軸の範囲を揃える。同じ data を 2 つの形で描いて
-      いたら、メッセージに近いほうを残す。対数か線形か、色の割り当て（量の大小は連続的な配色、正負は 0 を
-      中心にした配色）がメッセージに合っているか。
+      いたら、メッセージに近いほうを残す。
    4. **掲載寸法での読みやすさ**: 文字が小さすぎないか（印刷で 7 pt 以上。`save()` が最小の大きさを表示する）、
       線や点が潰れていないか、label が data に重なっていないか、目盛が多すぎないか。
-   5. **言葉**: 軸 label に量の名前と単位があるか。系列名は本文と同じ公開用の呼び名か
-      （run id や変数名のままになっていないか）。panel が複数あれば (a), (b) を付ける。
+   5. **言葉**: 軸 label と系列名は、本文と同じ公開用の呼び名か（run id や変数名のままになっていないか）。
    6. **図どうしの統一**: 同じ量・同じ条件には、全ての図で同じ色・記号・呼び名を使う。
       対応は `STYLE.md` の「図」に書いておく。
    7. **誠実さ**: 軸の切り方や配色が差を誇張していないか。主張が不確かさに左右されるなら、ばらつきを描く。

{paper_harness_cli-2.2.0 → paper_harness_cli-2.2.1}/src/paperops/skills/paper-predict/SKILL.md

@@ -33,7 +33,13 @@ description: まだ得ていない結果を、予想として BRIEF・図・本
 - この予想が外れたら、自分と著者は驚くか。驚くなら、分岐は要らない。
 - 根拠をもう一段厳密にしたら、論文の言うことが変わりうるか。変わらないなら、今の根拠で足りる。
 
-著者が「合っているはず」と述べた予想は、賭けとして扱わない。
+著者が「合っているはず」と述べた予想は、その見込みを根拠にして、確かめるための計算も分岐も足さずに進める。
+著者は、文書に残っていない経験や過去の計算を踏まえて述べていることが多い。
+
+著者の見込みで省けるのは上乗せの検証で、既にある証拠は省けない。手元の run や解析、内容を確認できた文献、
+あとから出た結果が著者の見込みと食い違うときは、どの結果が、どの値で、どう食い違うかを著者に伝える。
+著者が食い違いの理由を説明したら、その理由を発見の根拠に書いて進める。説明が付くまでは、食い違う証拠を含めて
+上の 2 つの問いに答え直し、賭けに当たるなら賭けとして扱う。
 
 ## 予想を立てる
 
@@ -46,7 +52,8 @@ description: まだ得ていない結果を、予想として BRIEF・図・本
    「確認済み」と呼ぶのは、source 側の判定（収束、定常、誤差の基準）を満たした結果にする。計算は終わったが
    判定を満たしていない値は、途中経過として値と時点を書き、最終的な値は予想として扱う。
 
-3. **著者の見込みを先に使う。** 著者が会話で述べた見込みは、そのまま予想として採る。著者が触れていない所は
+3. **著者の見込みを先に使う。** 著者が会話で述べた見込みは、予想として採る（手元の証拠と食い違うときは
+   「手間を賭けの大きさに合わせる」の扱いに従う）。著者が触れていない所は
    自分で立て、一覧にして見せる。著者は一覧を直すだけで済む。
 
 4. **具体的に書く。** 何が、どの向きに、どのくらい変わるかを書く。「増加すると考えられる」で止めない。
@@ -64,8 +71,7 @@ description: まだ得ていない結果を、予想として BRIEF・図・本
    - simulator の改修が要る
    - 分からない
 
-   見比べるのは、分解したい長さと格子幅、追いたい時間と時間刻み、定常や収束に達するまでの時間、領域の大きさ。
-   そこから費用の見当（core-hours）を付ける。使いたい機能があるときは、文書の版と、導入されている simulator の版が
+   費用の見当（core-hours）も付ける。使いたい機能があるときは、文書の版と、導入されている simulator の版が
    合っているかも確かめる。分からない点は「分からない」と書く。改修が要る、または出せそうにない結果が主張の柱に
    なっているときは、別の確かめ方か主張の変更を著者と相談する。
 

{paper_harness_cli-2.2.0 → paper_harness_cli-2.2.1}/uv.lock

@@ -645,7 +645,7 @@ wheels = [
 
 [[package]]
 name = "paper-harness-cli"
-version = "2.2.0"
+version = "2.2.1"
 source = { editable = "." }
 
 [package.dev-dependencies]