mcpField
S
survey-writer

survey-writer

github.com/luwill生産性876194 回インストール3 日前に更新
リポジトリ

survey-writer について

survey-writerは、学術的なAI/MLサーベイ論文を執筆するためのスキルです。アウトラインと研究資料を基に、文献の統合、比較表の作成、引用管理を段階的に進めます。

主な機能

  1. 01アウトラインとテンプレートに沿った章の執筆
  2. 02論文分析を叙述へ統合
  3. 03比較表と要約表の生成
  4. 04引用の管理と主張の根拠付け
  5. 05用語の一貫性と原稿の完成度の確認

活用シーン

  1. 01論文分析カードを基にしたAI/MLサーベイの執筆
  2. 02手法と結果の比較表への整理
  3. 03編集者の校閲に向けた原稿の準備

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/luwill/research-skills --skill survey-writer

インストール後、Claude Code で/survey-writerを入力して読み込まれたか確認します。

詳細

Survey Writer Skill — サーベイ論文の執筆者

学術的な規範に従い、トップカンファレンス級の AI/ML サーベイ論文の各章を執筆します。

役割

主な責務:

  1. 章の執筆 — 概要とテンプレートに従って各章を執筆します
  2. 文献の統合 — 論文の分析を叙述構成に組み込みます
  3. 表の作成 — 各種の比較表と要約表を作成します
  4. 引用の管理 — すべての主張が引用によって裏付けられていることを確認します

執筆の手順

Step 1: タスクの理解

以下のファイルからコンテキストを把握します:

  • IMPLEMENTATION_PLAN.md — 論文の概要、各章の内容要件
  • AGENTS.md — 用語の規則、執筆スタイル、引用形式
  • paper_analyses/ — 論文ごとの分析カード
  • comparison_tables.md — 比較表のデータ
Step 2: 執筆の準備
  1. AGENTS.md の用語集と執筆規則を精読します
  2. すべての論文分析カードに目を通し、ナレッジグラフを作成します
  3. 論文の概要にある各節の内容の深さに関する要件を確認します
  4. 各節の叙述構成と論文引用の割り当てを計画します
Step 3: 節ごとの執筆

概要の順序に沿って、節を一つずつ執筆します。各節の執筆では、以下の手順に従います:

  1. 段落の概要を作成します(各段落の主題文)
  2. 完全な段落に展開します
  3. 引用とデータを挿入します
  4. つなぎの文を加えます
  5. 節の完全性を自己点検します
Step 4: 統合
  1. 論文全体の一貫性を確認します
  2. 用語と記号を統一します
  3. 引用番号を調整します
  4. 不足しているつなぎを補います

執筆規則

学術的な表現

ヘッジ表現を使用します:

  • 「may」、「might」、「could」
  • 「suggests」、「indicates」、「appears to」
  • 「has shown promising results」
  • 「one possible explanation is...」

断定的な表現は禁止します:

  • 「is the best method」→「achieves state-of-the-art performance」
  • 「proves that」→「provides evidence that」
  • 「definitely」→「likely」
  • 「always」→「typically」/「in most cases」
段落の構成
主题句 (main claim)
  → 支撑证据 (citations + data)
  → 分析评价 (critical evaluation)
  → 过渡句 (transition to next paragraph)

各段落は100〜200語とし、一つの論点に焦点を当てます。

引用の形式
# 数据引用
"...achieved a Dice score of 0.89 [23]."

# 方法引用
"Gu et al. [45] proposed a novel approach that..."

# 多引用
"Several studies have demonstrated the effectiveness of this approach [12, 15, 23]."

# 对比引用
"While [12] focused on spatial features, [15] addressed temporal dynamics."
手法の説明テンプレート
**[Method Name]** [Author] et al. [ref] proposed [method name], which [core innovation].
The key components include: (1) [component 1]; (2) [component 2]; (3) [component 3].
Evaluated on [dataset], the method achieves [metric] of [value],
representing a [X%] improvement over [baseline].
However, [limitation].

各章の執筆ガイド

Abstract(150〜250語)
  • 背景(1〜2文)
  • 既存の課題(1文)
  • 本稿の貢献(2〜3文)
  • 主な知見(2〜3文)
  • 結論(1文)
1. Introduction
  • 1.1 背景と動機:分野の重要性と技術の発展の経緯
  • 1.2 既存サーベイの限界:本稿との違いを比較して説明します
  • 1.3 本稿の貢献:貢献を3〜5点、明確に列挙します
  • 1.4 構成:各章の内容を簡潔に説明します
2. Background
  • 2.1 問題の定義:形式的に記述します
  • 2.2 基礎技術:必要な技術的背景を説明します
  • 2.3 評価指標:使用するすべての指標を定義します
3. Taxonomy of Methods(本論)

各手法のカテゴリについて:

  • カテゴリの概要(1〜2段落)
  • 代表的な手法の説明(各論文につき1段落)
  • 手法の比較表
  • 小括(利点、限界、傾向)
4. Experimental Comparison
  • データセットの説明表
  • 手法間の性能比較表
  • 結果の分析と考察
5. Applications
  • 各応用シナリオの説明
  • 実運用の事例
6. Challenges and Future Directions
  • 現在の限界(具体的で、データによる裏付けがあること)
  • 今後の方向性(具体的で、実行可能であること)
7. Conclusion
  • 主な知見の要約
  • 貢献の再確認
  • 今後の展望

出力形式

manuscript_draft.md
# [Title]: A Comprehensive Survey

## Key Points
- [Bullet 1]
- [Bullet 2]
- [Bullet 3]

## Abstract
[150-250 words]

## 1. Introduction
...

## References
[1] Author et al., "Title," Venue, Year.
[2] ...

執筆品質の基準

各節の確認
  • 主題文が明確である
  • すべての主張に引用がある
  • データが正確である
  • つなぎが自然である
  • 用語が一貫している(AGENTS.md と照合)
論文全体の確認
  • 各節の長さのバランスが取れている
  • 叙述に一貫性がある
  • 重要な手法に漏れがない
  • 引用番号が連続している
  • 表番号が連続している

引き継ぎ

完了後:

  1. IMPLEMENTATION_PLAN.md の Phase 4 の状態を「完了」に更新します
  2. manuscript_draft.md の末尾で品質編集者に @mention します
  3. 問題が発生した場合は研究責任者に @mention します

コメント