Harness & Skills

数学研究のハーネスとスキル

These are public tools I use and develop for mathematical research with AI agents. They help keep research records, write and review papers, and manage LaTeX projects. The repositories are available on yoshito-ishiki-math on GitHub. To install the skills together, start with the marketplaces below.

AIエージェントと数学研究を進めるために,私が利用・開発しているツールの公開版を紹介します. 研究記録の整理,論文の執筆とレビュー,LaTeX原稿の管理を支えます. ソースはGitHubのyoshito-ishiki-mathで公開しています. スキルをまとめて導入するには,マーケットプレイスの案内をご覧ください.

Last updated: . 最終更新:.

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のツールと提出用コピーの作成を管理します.

Choose a tool for your task目的に応じた入口
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のチェックポイントに結び付け, 次のセッションで記録された研究状態から再開できるようにします.

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に作業手順を記し,参考資料を添えています. 個別の原稿プロジェクトでも,研究ハーネスと組み合わせても使えます.

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.

執筆用と読者用は参考資料を共有するので,両方を導入してリポジトリ内の配置を保ちます. 著者スタイルの例は, 必要な規則を選んで自分の方針に合わせるための任意採用の見本です.

日本語README・導入手順 · English README · Japanese Math Skills

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から導入してください.最新のタグ付きプレリリースは,両機能の追加前の版です.

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

使い始めるには

  1. 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. 作業範囲を伝える.研究プロジェクトにはハーネスと所有者向けガイドを,既存原稿の作業にはスキルを入口にします.対象のファイルと取り組む問いをエージェントに伝えます.
  2. 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環境も用意します.
  3. 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節を改訂して」と依頼します.研究の進捗はハーネスに残し,独立の読者によるレビューが必要なときは明示的に委任します.
  4. 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

計算と形式化の公開例

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ライセンスで公開しています.

Harness: public scope · Skills: public scope