write-abstract について
write-abstractは、投稿先に合わせた要旨の作成や改訂を支援する研究執筆スキルです。構成、長さ、キーワード、検証済みの結果を確認し、要旨登録の期限が別にある場合は登録情報もまとめます。
主な機能
- 015段階構成に沿った要旨作成
- 02投稿先の長さとキーワード要件の確認
- 03要旨テキストとLaTeXの検査
- 04検証済みの結果と数値のみを使用
- 05要旨登録情報の作成
活用シーン
- 01投稿先に合わせた要旨の改訂
- 02語数制限への適合確認
- 03要旨登録用メタデータの準備
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ shaishavmaisuria/ research-paper-lifecycle-skills --skill write-abstractインストール後、Claude Code で/write-abstractを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/abstract-structure.mdkeywords-blocks.mdvenue-norms.mdscripts/abstract_check.pyabstract_registration.pykeywords_block.pyvenueyaml.py詳細
アブストラクトの作成
投稿先の要件に準拠したアブストラクトを作成します。適切な長さ、適切なキーワードブロック、5段階の構成、検証済みの数値のみを使用します。また、投稿先にアブストラクト登録専用の締切がある場合は、登録フォームに貼り付けられる完全な登録情報(タイトル、アブストラクト、著者、トピック、利益相反リスト)も用意します。
使用する場面
- 特定の投稿先やテンプレート系統(acmart/IEEEtran/llncs/NeurIPS 形式)に合わせてアブストラクトを作成または書き直す場合。
- アブストラクトを語数制限に収める場合、または不足している CCS Concepts/Index Terms/キーワードブロックを追加する場合。
- アブストラクト登録の締切が近づいており、論文 PDF の提出前にタイトル+アブストラクト+トピック+利益相反を登録する必要がある場合。
関連スキル:tailor-to-venue(論文全体を投稿先に合わせて調整)、parse-cfp(不足している投稿先プロフィールを作成)、preflight-check(最終的なデスクリジェクト要因のチェック)、verify-citations(参考文献に関する作業のゲート)。
入力
- 草稿(キーワードブロックを文脈内で確認できるため、メインの
.texファイルを推奨)、またはプレーンテキストのアブストラクト。または、新規に草稿を作成する場合は、論文の貢献と検証済みの結果。 - 投稿先プロフィール:
venues/conferences/<id>.ymlまたはvenues/families/<f>.yml(スキーマ:venues/schema.yml)。どちらも存在しない場合は、投稿先に関する事実を捏造せず、投稿募集(CFP)の URL を使ってparse-cfpを実行するか、最新の CFP を直接引用してください。
プロセス
1. 投稿先の規定を確認し、再検証する(必須)
プロフィールの format.abstract_words、format.keywords、deadlines.abstract/paper + timezone、review.blind を読み込みます。プロフィールの情報は古くなることがあります。ユーザーが語数制限、キーワード要件、締切を根拠にする前に、最新の cfp_url と照合して再検証し、何をいつ確認したかを伝えてください。CFP を取得できない場合、プロフィール由来の事実にはすべて「未検証 — CFP で確認」と明記してください。abstract_words が null の場合、150~250 語は一般的な目安として示し、投稿先の規則とは表現しないでください。references/venue-norms.md を参照してください。
2. 5段階の構成で草稿を作成(または診断)する
投稿先の系統に適した文体と各段階の語数配分で、アブストラクトを「動機 → ギャップ → アプローチ → 結果 → 影響」の流れに沿って構成します。 references/abstract-structure.md。
草稿作成時の必須ルール:
- 結果の数値は草稿の評価結果、またはユーザーから提示されたものを使用します。決して捏造、切り上げ、外挿してはいけません。定量的な結果は、アブストラクトの中で最も予測力の高い要素です。結果から影響に至る流れは、数値がなければ最高評価帯には達しません。結果が未確定の場合は、型付きの定量結果スロットを 1 つだけ残します。これは、指標名、単位、符号/方向、比較対象を含む構造化された契約です。例:
[RESULT: +XX% Recall@20 vs best hashing baseline under matched budget]。単なる[RESULT: ...]や自由記述の文章は使わないでください。角括弧付きのスロットが 1 つでもある場合、アブストラクトは「草稿 — 提出不可」の状態です。提出前に、すべてのスロットを検証済みの値で置き換えてください。契約の詳細:references/abstract-structure.md。 - アブストラクトに
\cite、\ref、数式、未定義の頭字語を含めないでください(単独のメタデータとして提出されるためです)。本文中で言及し、別の箇所で引用が必要となる先行研究については、verify-citationsを通してください。 - ダブルブラインドの投稿先では、所属機関、助成金番号、「自分たちの過去の研究」、個人のリポジトリ URL など、身元につながる情報を含めないでください。
書き直す場合は、まずリンターを実行し、その指摘に基づいて編集してください。
3. 決定論的に lint を実行する
リポジトリのルートから実行するか、絶対パスを指定してください:
python3 skills/write-abstract/scripts/abstract_check.py <main.tex|abstract.txt|-> \
--venue venues/conferences/<id>.yml [--strict]
会場の制限に対する長さ、キーワードブロックの有無と形式、
自己完結性(引用/参照/数式/URL/プレースホルダー)、型付き定量結果スロットの不変条件、acmart のアブストラクトが \maketitle より前に必要という注意点、語彙上の移動シグナルをレポートします。RISK と WARN の指摘を修正し、RISK がなくなるまで再実行してください。--venue は、会議のプロファイルが存在しない場合、分野のファミリープロファイルも受け付けます。
スロットゲートは上書きできません。スクリプトは未解決スロットの数を表示し、[LABEL: ...] スロットが1つでも残っていると、--strict に関係なく、ゼロ以外の終了コードで必ず失敗し、アブストラクトに DRAFT-not-submittable と表示します。結果待ちのドラフトは、型付き RESULT スロット1つと、該当するすべての [CONFIRM: ...] スロットに検証済みの値を当てはめ、文章に反映した場合にのみ合格します。数値を捏造してゲートを通過させてはいけません。
4. キーワードブロックを生成する
ユーザーとキーワードを選びます(課題+手法+分野。正直に対応できる範囲で CFP のトピック一覧に合わせます。ガイダンスは references/keywords-blocks.md を参照)。次に、ファミリーに適した LaTeX を出力します:
python3 skills/write-abstract/scripts/keywords_block.py \
--venue venues/conferences/<id>.yml --keywords "kw1, kw2, kw3"
ACM の会場では、スクリプトが CCS のひな形を出力します。概念 ID は公式ツール https://dl.acm.org/ccs で必ず確認して入力してください。CCSXML の概念 ID を捏造してはいけません。NeurIPS 形式の会場では、トピックは投稿フォームで指定するため、ブロックを出力しないのが正しい動作です。
5. 登録カードを作成する(アブストラクトの締切がある場合)
deadlines.abstract が設定されている場合(NeurIPS、ICML、KDD、CVPR、CHI、SIGSPATIAL では、論文締切の2〜7日前にアブストラクトを登録します)、フォームで求められる情報をすべてまとめます:
python3 skills/write-abstract/scripts/abstract_registration.py \
--venue venues/conferences/<id>.yml --title "<title>" \
--abstract-file <main.tex|abstract.txt> \
--authors "Name <email> (Affiliation)" --topics "t1; t2" \
[--coi-file conflicts.txt] [--track <Track>] [--out abstract-registration-<id>.md]
カードには、会場のタイムゾーンに基づく締切までのカウントダウン(AoE 以外の会場に注意してください。SIGSPATIAL は太平洋時間です)、プレースホルダーポリシーに関する警告(KDD/AAAI では仮のアブストラクトが不利に扱われます)、ユーザーの最近の共著者/アドバイザー/所属機関に基づく COI チェックリスト、投稿システムの URL が含まれます。ユーザーが実際の最近の論文に基づいて COI リストを作成できるよう支援してください。対象期間とカテゴリーは会場のフォームに記載されたものを基準とします。規定については references/venue-norms.md を参照してください。
6. 提供する
最終版のアブストラクト(LaTeX 版とプレーンテキストのフォーム入力用)、キーワードブロック、問題のない lint レポートを提示し、該当する場合はドラフトと同じ場所に abstract-registration-<venue-id>.md を作成します。登録/投稿はユーザー自身が行うことを明記してください。
出力
- 対象会場向けの
abstract_check.pyで RISK がなく、未解決スロットがゼロのアブストラクト(LaTeX 版とプレーンテキスト版)。結果待ちのドラフトは、型付き RESULT スロットが埋まるまで DRAFT-not-submittable と明示して提供します。 - 会場に適したキーワードブロック(または、そのファミリーには該当ブロックがない旨の注記)。
- 会場でアブストラクトの登録が必要な場合:タイトル、アブストラクト、著者、トピック、COI チェックリスト、締切の計算、検証記録を含む
abstract-registration-<venue-id>.md。
ガードレール
- アブストラクトの結果、数値、主張を捏造してはいけません。未検証の値は、型付き定量結果スロット(指標、単位、符号/方向、比較対象)1つのままにし、すべてのスロットに実データを反映するまでは、アブストラクトに DRAFT-not-submittable と明記します。
- 引用や CCS の概念 ID を捏造してはいけません。引用は
verify-citationsを通し、CCS ID は dl.acm.org/ccs からのみ取得します。 - 会場の制限や締切を記憶に頼って記載してはいけません。プロファイルと最新の CFP による検証のみを使い、検証できない事実には UNVERIFIED と明記します。
- ユーザーに代わって投稿システムへの登録、投稿、情報入力を行ってはいけません。成果物はカードの作成までとします。
- 別の論文のアブストラクトをひな形として貼り付けてはいけません。参考例の調査は
study-exemplarsスキルを通じて一時的に行います。