agentleFS
Akikukeo1Akikukeo1/alignment-under-pressure-benchmark/.agents/skills/paper-review/SKILL.md

paper-review

Skill1 starsChanged 3 months agoMITView on GitHub

論文を初見の一般読者視点でレビューする。中学生とAI・機械学習の専門知識がない成人を読者に、前提知識・提示順序・内部実装露出・説明不足・表現の5観点で精査し、Critical/Major/Minor形式で指摘する。ユーザー承認後は修正まで行う。

29 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use paper-writing.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • MLNLP-WorldSkill

    paper-writing

    学术论文写作检查与优化助手。基于 MLNLP-World 社区整理的论文写作技巧,帮助检查和优化学术论文。Use when: (1) 检查论文 LaTeX 格式和排版, (2) 优化公式符号使用, (3) 改进图表设计, (4) 润色英文学术表达, (5) 检查参考文献格式, (6) 投稿前终稿检查, (7) 用户询问论文写作技巧或规范。

    Also in 6 projects that use this

The file

Files
SKILL.md

Paper Review(読者視点論文レビュー)

論文を「初見の読者」として読み、理解の妨げになる箇所を特定し、承認を経て修正するまでの一連の流れを実行する。

入力と前提

  • 対象: ユーザーが指定する論文ファイル(例: @paper/main.tex)。
  • 対象読者(デフォルト): 中学生、AI・機械学習の専門知識を持たない一般成人。ユーザーが別の読者層を指定した場合はそれに従う。
  • 応答は日本語。指摘は「単なる好み」ではなく「読者が理解できない」「誤解する」「情報を探さないと理解できない」を優先する。

フェーズ1: 通読

修正案や検索をせず、初見の読者として上から最後まで通す。

  • 各時点で「その時点までに理解に必要な情報があるか」だけを問い、つまずいた箇所を記録する。
  • 後の節で初めて説明される内容が前の文章の理解に必要になっていないか(結果→説明→実はこういうタスク、という逆転構造)を特に記録する。

フェーズ2: 精査(5観点)

観点1: 前提知識

  • 専門用語、難解な表現、一般人に伝わりにくいカタカナ語を洗い出す。LLM・ベンチマーク等の明らかな専門語だけでなく、「一見専門用語に見えない語」も検討する。
  • 判定基準は「専門用語を使っていること」ではなく**「その用語が、その時点までに十分説明されているか」**。
  • 脚注・括弧内補足など上手くできている説明も記録しておく。追加説明の形式を統一するときに使う。

観点2: 提示順序

  • 「結果を提示 → その結果について説明 → 実はその結果はこういうタスクから得られた」のような、理解に必要な情報が後から出てくる構造を探す。
  • 説明が分散している箇所(同じテーマの説明が複数節に分かれる)も対象。
  • 各指摘には「何が先に必要だったか」「どこへ移動すべきか」まで提案する。 移動を伴う場合は挿入位置まで具体化する。

観点3: 内部実装の露出

  • 内部ディレクトリ構造、設定ファイル上の項目名、CSV保存場所、内部ファイル名、実装上の都合だけで存在する情報を探す。
  • ただし再現性・研究方法の理解に必要な情報は削除対象にしない。「研究として必要な情報」と「実装者にしか意味がない情報」を区別する。

観点4: 説明不足

  • 文章単体では意味が通っても、初見の読者が「これは何?」「なぜこれをするの?」「この数字は何?」となる箇所。
  • 具体例自体の難解さもここで扱う。特に「最重要結果の説明が最难解」だと論文全体のボトルネックになるため優先度が高い。

観点5: 表現

  • です・ます調/だ・である調の統一、曖昧な主語、長すぎる文、重複、不自然な日本語、図表との対応、節構成。
  • 会話例・引用文中の文体変更は意図的なものとして除外する。
  • 「私」などの一人称は、基本的に使わない。「本研究では」「本論文では」など、研究主体を示す表現に統一する。

フェーズ3: 出力

## Critical
研究内容の理解を妨げる問題

## Major
読者が理解するうえで大きな問題になる箇所

## Minor
改善すると読みやすくなる箇所

各指摘には次を示す。

  • ページ / 節 / 該当文
  • 問題
  • なぜ問題なのか
  • 推奨修正

加えて:

  • 数値整合性(合計・平均・差分)は必ず検算して報告する。
  • 「問題なし」と判断した部分を無理に指摘しない。判断した点を最後に参考として列挙する。

フェーズ4: 妥当性検証(指摘の鵜呑み禁止)

出力前に、リポジトリ内の実データ・コード・ドキュメント・git履歴と突き合わせて指摘を検証する。

  • タスク定義、採点仕様、結果CSV、README/docs、git log 等を確認し、本文の説明が実態と一致しているか確かめる。
  • ソース調査でしか出てこない重大な問題(条件間プロンプトの同一性、採点ルールとの不一致、データと本文の矛盾)を優先的に探す。
  • 不確かな事実は推測で書かず、ユーザーに質問して確認する。
  • 前回レビューの指摘をすべて正しいとは仮定しない。毎回妥当性を再評価する。ユーザーが却下した指摘パターンは繰り返さない。

フェーズ5: 修正(ユーザーの承認後)

  1. ユーザーが確認・承認してから編集する。移動を伴う修正は「削除」と「挿入」に分解して適用する。
  2. 編集後、次の精査チェックリストを確認する。
    • \ref の懸垂参照(存在しない図・表・節への参照)がないか
    • ハードコードされた節番号がないか(移動・挿入で番号がずれるため、ラベル参照に統一する)
    • LaTeX特殊記号の誤用がないか(\* は印字されない改行命令、等)
    • 数値整合性(合計・平均・差分の再検算)
    • 移動元に残骸(重複コンテンツ)が残っていないか
    • 追加・修正した文の文体(だ・である調)と用語が既存部分と一致しているか
  3. ビルドはユーザーの環境(クラウド)で行われるため、ローカルではビルド検証しない。クラウドビルド後に確認してほしい点(表レイアウト、参照表示など)を報告に含める。

運用上の注意

  • 問題がない箇所を無理に変更しない。
  • 修正方針でユーザーの決定があった場合(用語の扱い、対象範囲など)、その判断を以後のフェーズで守る。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.