How the tools fit together
三つのツールの役割
A harness gives a research project its working structure: what to read, how to record evidence, and where to resume. A skill packages instructions and supporting resources for a particular task. Kicho manages the LaTeX project, paragraph-ID tools, and submission copies.
ハーネスは,研究プロジェクトで何を読み,どのように証拠を記録し,どこから再開するかを整理する枠組みです. スキル(skill)は,特定の作業の手順と参考資料をまとめたものです. Kichoは,LaTeX原稿の操作に加えて,段落IDのツールと提出用コピーの作成を管理します.
| Toolツール | Main role主な役割 | Use it when…こんなときに |
|---|---|---|
| Harness | Research state and evidence研究の状態と証拠の管理 | You want to continue a research project across sessions.複数のセッションにわたって研究を進めたい. |
| Skills | Writing, exposition review, and paragraph IDs論文執筆,説明のレビュー,段落ID | You have a manuscript to write, revise, or review.原稿を執筆・改訂・レビューしたい. |
| Kicho | LaTeX projects, paragraph IDs, and submission filesLaTeX原稿,段落ID,提出用ファイルの管理 | You want to build a PDF or prepare a submission package.PDFを作成し,投稿用のファイルを準備したい. |
Install skills from a marketplace
マーケットプレイスからスキルを導入する
These GitHub-backed Codex marketplaces package related skills as plugins,
preserving their shared references. With a Codex CLI that supports codex plugin,
run the commands for the package you need.
関連するスキルを,相互参照を保ったプラグインとしてまとめて導入するための,
GitHub上のCodexマーケットプレイスです.codex pluginに対応するCodex CLIで,
必要なパッケージの導入コマンドを実行します.
Math Skills Marketplace
The marketplace appears as Yoshito Ishiki Math.
Its Math Paper Skills plugin (0.1.3) installs write-research-paper,
read-research-paper, and latex-paragraph-ids together.
Kicho supplies the paragraph-ID package, tools, and submission cleanup;
the paragraph-ID skill records editing conventions.
一覧の表示名はYoshito Ishiki Mathです.
Math Paper Skillsプラグイン(0.1.3)で,write-research-paper,
read-research-paper,latex-paragraph-idsをまとめて導入します.
段落IDのパッケージ・補助ツール・提出時の処理はKichoが管理し,
段落IDのskillは編集時の利用規則を案内します.
codex plugin marketplace add yoshito-ishiki-math/math-skills-marketplace
codex plugin add math-paper-skills@yoshito-ishiki-math
日本語README・導入と更新 · English README
DempaComm Skills Marketplace
Choose DempaComm for Japanese mathematical writing.
The Japanese Math Skills plugin (0.1.1) includes write-japanese-math
and read-japanese-math, with a public TeX example corpus and search tools that require Python 3.10 or later.
The repository records the corpus attribution and CC BY 4.0 and MIT license notices.
日本語の数学文書には,表示名DempaCommのマーケットプレイスを使えます.
Japanese Math Skillsプラグイン(0.1.1)には,write-japanese-mathと
read-japanese-math,公開TeX用例コーパス,検索ツールを収録しています.検索にはPython 3.10以上が必要です.
用例の出典とCC BY 4.0・MITのライセンス表示は,配布先に記録しています.
codex plugin marketplace add DempaComm/japanese-math-skills-marketplace
codex plugin add japanese-math-skills@dempacomm
日本語README・導入と更新 · English README
You can also select the marketplace by its display name in the desktop app’s plugin list.
Start a new chat after installation. Each marketplace ships a snapshot of its skill repository. To update, run codex plugin marketplace upgrade
with the marketplace ID (yoshito-ishiki-math or dempacomm), run the corresponding codex plugin add command again, and start a new chat.
デスクトップアプリのプラグイン一覧では,表示名からマーケットプレイスを選ぶこともできます.
導入後は新しいチャットを開始してください.マーケットプレイスは,スキルのリポジトリの特定時点の内容を配布します.更新するには,codex plugin marketplace upgradeに
マーケットプレイスID(yoshito-ishiki-mathまたはdempacomm)を指定し,対応するcodex plugin addを再実行してから,新しいチャットを開始してください.
math-research-harness-public
A template for research directed by the mathematician working with an AI agent. It connects conversations to durable notes, claims, literature, computations, and Git checkpoints, so the next session can start from the recorded state of the project.
数学者の指示に沿ってAIエージェントと研究を進めるためのテンプレートです. 会話で得た内容を,研究メモ,主張,文献,計算,Gitのチェックポイントに結び付け, 次のセッションで記録された研究状態から再開できるようにします.
- Open the project folder in your agent. Start with
AGENTS.md(orCLAUDE.mdfor Claude Code), then readSTEERING.mdfor the current research direction. - Each research thread keeps its claims and ledger, with evidence and unresolved questions recorded separately.
- Workflows cover literature provenance, reproducible computation, Lean formalization, and review records tied to a specific manuscript version.
PAPERS.mdindexes the independent Kicho manuscript projects in numberedpaperN/directories. The included research example is fictional.
- プロジェクトのフォルダをエージェントで開き,
AGENTS.md(Claude CodeではCLAUDE.md)から読み始めます.STEERING.mdに現在の研究方針を記録します. - 研究テーマごとに主張と台帳を持ち,証拠と未解決の問いを区別して残します.
- 出典を残す文献調査,再現可能な計算,Leanによる形式化,原稿の版に対応した確認記録を扱います.
paperN/に独立したKicho原稿を配置し,PAPERS.mdに一覧を置きます.収録された研究例は,使い方を示す架空のサンプルです.
Clone the repository or create one from the GitHub template. In the project folder, install the locked dependencies and run the setup checks.
リポジトリをクローンするか,GitHubのテンプレートから新しいリポジトリを作ります.プロジェクトのフォルダで,固定された依存関係を導入し,初期設定を確認します.
uv sync --locked
uv run python tools/literature_preflight.py
uv run python -m unittest discover -s tests
Keep writing rules that apply across manuscripts in a shared author profile used by your skills. Each project can refer to that profile and keep its own notation and conventions in its manuscript’s STYLE.md.
原稿をまたいで使う執筆規則は,スキルから参照する著者共通のプロファイルにまとめます.各プロジェクトではその参照先を指定し,その原稿だけの記号や規則を原稿側のSTYLE.mdに記します.
日本語README · English README · 所有者向けガイド · Worked session · Author style / 著者スタイル
math-paper-skills
Reusable skills for mathematical manuscripts, with instructions in SKILL.md and supporting references.
You can use them in a manuscript project on its own or together with the research harness.
数学原稿のための,再利用可能なスキル集です.SKILL.mdに作業手順を記し,参考資料を添えています.
個別の原稿プロジェクトでも,研究ハーネスと組み合わせても使えます.
-
write-research-paper
Draft and revise a paper under the author's direction, including checking its exposition and consulting the relevant manuscript context. 著者の指示に沿って論文を執筆・改訂し,原稿の背景と指定を確認しながら,執筆側で説明を点検して修正します. -
read-research-paper
Review the exposition of a frozen manuscript as an explicitly delegated independent reader. It supports sequential reading, whole-manuscript review, and bounded review of changes. 明示的に委任された独立の読者として,固定版原稿の説明をレビューします.逐次読み,全体レビュー,指定した変更箇所のレビューに対応します. -
latex-paragraph-ids
Use Kicho-managed paragraph IDs for editing and release preparation. The skill defines how to retain IDs when paragraphs move or change and how to use editorial notes; Kicho supplies the implementation. Kichoが管理する段落IDを,編集と提出準備に使うためのskillです.段落の移動・修正でIDを保持する方法や編集注記の利用規則を案内し,実装はKichoを使います.
The writing skill loads guides as needed for manuscript provenance (source claims, citation versions, and protected passages), mathematical figures (editable drawings and checks of the affected output), and manuscript-local conventions (notation, style, and the author's scoped choices).
執筆用skillは,依頼に応じて 原稿の来歴(取り込んだ主張,引用した版,保護された改稿範囲), 数学図(編集可能な図と影響する出力の確認), 原稿固有の規則(記号,文体,著者の個別指定)のガイドを読みます.
The writing and reading skills share references; install them together and preserve the repository layout. An optional author-style example can be adapted to your own preferences.
執筆用と読者用は参考資料を共有するので,両方を導入してリポジトリ内の配置を保ちます. 著者スタイルの例は, 必要な規則を選んで自分の方針に合わせるための任意採用の見本です.
Kicho
A command-line workflow manager for LaTeX research projects.
It works with standard TeX tools such as latexmk, LuaLaTeX, and Biber,
and provides English and Japanese project templates.
LaTeXによる研究原稿を管理するコマンドラインツールです.
latexmk,LuaLaTeX,Biberなどの通常のTeX環境と組み合わせて使い,
英語・日本語のプロジェクト用テンプレートを提供します.
The commands below describe GitHub’s main branch. For paragraph IDs and proofreading, follow the README to install from main. The latest tagged prerelease predates both features.
以下はGitHubのmainブランチの機能です.段落IDや校正を使うには,READMEに従ってmainから導入してください.最新のタグ付きプレリリースは,両機能の追加前の版です.
initcreates a project;doctorchecks the environment;checkvalidates project files.buildcompiles the PDF andarchivesaves a source, PDF, and metadata snapshot.check --log --jsonreports unresolved citations and references.build --strictfails when they remain unresolved.flattencombines supported source inclusions;submitprepares a local submission package, including an arXiv option.paraidsinstalls the paragraph-ID package and issues, finds, and checks IDs. Existing IDs and manuscript-local package versions are retained.proofreadmarks proposed corrections in the PDF and applies individual changes after author approval. Kicho saves the prior source and the approval record inarchives/proofread/.
initでプロジェクトを作成し,doctorで環境を確認し,checkでファイルを検査します.buildでPDFを作り,archiveでソース・PDF・メタデータのスナップショットを保存します.check --log --jsonは未解決の引用・参照を報告し,build --strictはそれらが残っていると失敗します.flattenで対応するソースの読み込みをまとめ,submitで投稿用ファイルをローカルに準備します.arXiv用の出力にも対応します.paraidsで段落IDパッケージを導入し,IDの発行・検索・検査を行います.既存のIDと原稿側のパッケージの版を保持します.proofreadで修正候補をPDFに赤字で示し,著者が承認した箇所を個別に反映します.反映前のソースと承認記録はarchives/proofread/に保存します.
Check kicho help paraids for the installed interface.
Issuing, finding, and checking IDs do not rewrite manuscript text.
For a manuscript under MyPaper, the basic commands are:
導入済みのKichoの使い方はkicho help paraidsで確認できます.
IDの発行・検索・検査は原稿本文を書き換えません.
MyPaperに原稿がある場合,基本的な操作は次のとおりです.
kicho paraids install --root MyPaper
kicho paraids new --root MyPaper --count 3
kicho paraids check --root MyPaper
submit and submit --arxiv comment out IDs, red editorial notes,
and related settings in a submission copy, leaving the working manuscript intact.
For manuscripts with IDs or notes, standard submission rebuilds the PDF from that copy;
the arXiv option creates a source ZIP. archive retains the working IDs and notes.
Submission stops while proofreading corrections are pending. Paragraph-ID commands, proofreading, and submission cleanup require Python 3.9 or later.
submitとsubmit --arxivは,作業原稿を保ったまま,提出用コピーの
段落ID・赤字の編集注記・関連設定をコメントアウトします.
ID・注記がある通常の提出ではそのコピーからPDFを作り直し,arXiv用にはソースZIPを作ります.
archiveは作業中のIDと注記を残して保存します.未処理の校正があると投稿用ファイルの作成は停止します.段落ID・校正のコマンドと提出時の処理にはPython 3.9以上が必要です.
Kicho is installed separately from the harness and skills. Its submission commands create files for you to review and upload.
Kicho本体は,ハーネスやスキルとは別に導入します.投稿用コマンドで作ったファイルを確認し,自分で投稿先へアップロードします.
日本語README · English README · 段落ID・編集注記の利用方法 · Proofreading / 校正 · GitHub Releases
Getting started
使い始めるには
- Choose the scope. For a research project, start with the harness and its owner guide. For an existing manuscript, begin with the skills. Tell the agent which files and question to work on. 作業範囲を伝える.研究プロジェクトにはハーネスと所有者向けガイドを,既存原稿の作業にはスキルを入口にします.対象のファイルと取り組む問いをエージェントに伝えます.
-
Follow the setup guide. For Codex skills, use the marketplace commands above. The harness uses Git and
uv; the skills README also explains standalone installation for Codex and Claude Code. Add Kicho and a TeX environment for LaTeX work. 導入ガイドに従う.Codexのスキルは,上のマーケットプレイスのコマンドから導入できます.ハーネスはGitとuvを使い,スキルのREADMEにはCodex・Claude Code向けの個別導入方法もあります.LaTeX作業にはKichoとTeX環境も用意します. -
Make a concrete request. In Codex CLI or the IDE extension, for example:
$write-research-paper“Revise Section 2, preserving the mathematical claims.” Record research progress in the harness. Request an independent reader explicitly when you need one. 具体的に依頼する.例えばCodex CLIやIDE拡張で,$write-research-paper「数学的な主張を保って第2節を改訂して」と依頼します.研究の進捗はハーネスに残し,独立の読者によるレビューが必要なときは明示的に委任します. - Check each kind of evidence. Review the mathematical argument, the exposition, and the compiled PDF separately. A successful build or record check alone does not establish a theorem. 確認の種類を分ける.数学的な論証,文章の説明,ビルドしたPDFをそれぞれ確認します.ビルドや記録の検査に通ったことだけで,定理が証明されたことにはなりません.
For the current skill format and discovery rules, see the official OpenAI documentation. Consult each repository's README for its setup details.
現在のskillの形式と探索方法は,OpenAI公式ドキュメントを参照してください.各ツールの具体的な導入方法は,それぞれのREADMEにあります.
Public examples of computation and formalization
計算と形式化の公開例
-
ghdist
A Rust command-line tool for computing Gromov–Hausdorff distances between finite metric spaces and between their Hausdorff hyperspaces. It returns exact distances when the search completes and established bounds when it reaches its limits. 有限距離空間どうしや,そのHausdorff超空間どうしのGromov–Hausdorff距離を計算するRust製CLIです.探索が完了すれば厳密値を,制限に達した場合は確定した上下界を出力します. -
lean-gh-space-hilbert
A Lean formalization of the Hilbert-space classification of Gromov–Hausdorff space under five explicit assumptions drawn from the literature. Gromov–Hausdorff空間のHilbert空間としての分類を,文献に基づく五つの仮定のもとでLeanにより形式化した例です.
Origin and public scope
元になったプロジェクトと公開範囲
The public harness and paper skills build on Haruhisa Enomoto's math-research-harness and math-paper-skills. I have added portable workflows from my own use while retaining the original MIT license and attribution. Personal research records and manuscript corpora are outside these public distributions. The research harness, math-paper-skills, and Kicho are available under the MIT license.
公開ハーネスと論文用スキルは,榎本悠久(Haruhisa Enomoto)氏の math-research-harnessと math-paper-skillsを元にしています. 元のMITライセンスと著作権表示を保持し,私の運用から再利用可能な手順を加えました. 個人の研究記録や論文コーパスは公開版に含めていません.研究ハーネス,math-paper-skills,KichoはMITライセンスで公開しています.