Community研究&データ分析github.com

Ychris12138/md-project-kickoff

Gitファーストの研究プロジェクトセットアップ、リモートsbatchワークフロー、文献基盤、結果取得のためのCodexスキルです。

md-project-kickoff とは?

このスキルは、研究者と開発者がGitを中心に据えたワークフローで研究プロジェクトを迅速に開始し、リモートクラスター上でのsbatchジョブの管理、文献調査の基盤構築、そして実験結果の効率的な取得を可能にします。主にCodex(例:Claude CodeやCursor)上で動作し、ユーザーがプロジェクトの初期化から結果のレビューまでを一貫して行えるように設計されています。具体的には、Gitリポジトリの作成、リモートホストへの接続とsbatchスクリプトの送信、関連論文の要約や引用情報の整理、そして実行結果のダウンロードと解析をサポートします。これにより、研究の再現性とチーム内のコラボレーションが向上し、実験と分析のサイクルを高速化できます。

対応~Claude Code✓Codex CLI~Cursor
npx skills add Ychris12138/md-project-kickoff

Installed? Explore more 研究&データ分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

md-project-kickoff は何をしますか?

Gitファーストの研究プロジェクトセットアップ、リモートsbatchワークフロー、文献基盤、結果取得のためのCodexスキルです。

概要

このスキルは、研究者がCodex環境内で研究プロジェクトを効率的に管理するためのツールセットを提供します。Gitをバージョン管理とコラボレーションの基盤として使用し、リモート計算クラスターへのジョブ送信、文献調査の自動化、結果の取得をスムーズに行います。

主な機能

  • Gitファーストのプロジェクトセットアップ: 新しい研究プロジェクトをGitリポジトリとして初期化し、標準的なディレクトリ構造(例:src/, data/, results/, docs/)を作成します。
  • リモートsbatchワークフロー: SSHを使用してリモートホストに接続し、sbatchスクリプトを送信・監視します。ジョブの状態を確認し、完了を通知します。
  • 文献基盤: 論文のDOIやURLからメタデータを抽出し、BibTeX形式で保存します。また、関連文献の要約を生成します。
  • 結果取得: リモートホストからローカルに結果ファイルをダウンロードし、解析用に整形します。

前提条件

  • Codex(例:Claude Code または Cursor)がインストールされていること。
  • Gitがインストールされ、設定済みであること。
  • SSHキーがリモートクラスターに設定されていること。
  • リモートホストでsbatchコマンドが利用可能であること(Slurmワークロードマネージャー)。

使用方法

  1. プロジェクトを開始する: スキルを呼び出し、プロジェクト名と説明を指定します。自動的にGitリポジトリと標準ディレクトリが作成されます。
  2. 文献を追加する: DOIまたはURLを指定して文献を追加します。スキルが自動的にメタデータを取得し、docs/references.bibに保存します。
  3. リモートジョブを送信する: ローカルのsbatchスクリプトをリモートホストにアップロードし、ジョブを送信します。ジョブIDが表示されます。
  4. 結果を取得する: ジョブ完了後、results/ディレクトリに結果をダウンロードします。

設定

環境変数またはスキル設定で以下の値を指定できます:

  • REMOTE_HOST: リモートクラスターのホスト名(例:[email protected])
  • REMOTE_WORK_DIR: リモート上の作業ディレクトリ(例:/home/user/projects/)
  • GIT_NAME: Gitユーザー名
  • GIT_EMAIL: Gitメールアドレス

例

# プロジェクトを作成
codex run "プロジェクトを開始: 量子化学シミュレーション"

# 文献を追加
codex run "文献を追加: 10.1038/s41586-020-2649-2"

# リモートジョブを送信
codex run "sbatch job.sh をリモートの /home/user/projects/qc に送信"

# 結果を取得
codex run "最新のジョブ結果をダウンロード"

トラブルシューティング

  • SSH接続エラー: ssh -T <REMOTE_HOST> で接続確認をしてください。
  • sbatch コマンドが見つからない: リモートホストでSlurmが利用可能か確認してください。
  • Gitエラー: git config --global user.name と git config --global user.email が設定されているか確認してください。

ライセンス

MIT

関連スキル