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ワークロードマネージャー)。
使用方法
- プロジェクトを開始する: スキルを呼び出し、プロジェクト名と説明を指定します。自動的にGitリポジトリと標準ディレクトリが作成されます。
- 文献を追加する: DOIまたはURLを指定して文献を追加します。スキルが自動的にメタデータを取得し、
docs/references.bibに保存します。 - リモートジョブを送信する: ローカルのsbatchスクリプトをリモートホストにアップロードし、ジョブを送信します。ジョブIDが表示されます。
- 結果を取得する: ジョブ完了後、
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