mcpField
W
workspace-init

workspace-init

github.com/willoscarエージェントワークフロー51740 回インストール3 週間前に更新
リポジトリ

workspace-init について

workspace-initは、指定したディレクトリに基本ファイルとフォルダーを作成し、研究用ワークスペースを初期化します。既定では不足分だけを作成し、明示的な承認なしに既存ファイルを置き換えず、ワークフローの選択は後続のルーティングに委ねます。

主な機能

  1. 01対象ディレクトリの検証
  2. 02基本テンプレートの作成
  3. 03既存ファイルの既定保持
  4. 04コアファイルとCSVスキーマの確認
  5. 05ワークフローへの引き渡し

活用シーン

  1. 01研究プロジェクト用ワークスペースの作成
  2. 02初期化途中のワークスペースの確認と補完

インストール

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

$npx skills add https://github.com/willoscar/research-units-pipeline-skills --skill workspace-init

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

assets/workspace-template/
CHECKPOINTS.md
DECISIONS.md
GOAL.md
queries.md
STATUS.md
UNITS.csv
assets/workspace-template/citations/
ref.bib
verified.jsonl
assets/workspace-template/outline/
claim_evidence_matrix.md
mapping.tsv
outline.yml
taxonomy.yml
assets/workspace-template/output/
DRAFT.md
QUALITY_GATE.md
RUN_ERRORS.md
SNAPSHOT.md
assets/workspace-template/papers/
core_set.csv
paper_notes.jsonl
papers_dedup.jsonl
papers_raw.jsonl
scripts/
run.py

詳細

Workspace の初期化

初期化は境界です。Workspace が所有する状態を作成し、上書きがオペレーターによって明示的に決定されない限り、既存の状態には手を加えません。 Workflow の選択や Unit の実行は行いません。

入力

  • workspaces/<name>/ 配下の対象ディレクトリ。
  • 任意の明示的な上書き決定。

出力

  • STATUS.md、CHECKPOINTS.md、UNITS.csv、DECISIONS.md。
  • GOAL.md、queries.md。
  • papers/、outline/、citations/、output/ ディレクトリ。

手順

1. 出力先を検証する

対象パスを解決し、リポジトリルートが指定されている場合は拒否します。既存ファイルを確認してから、初期化が未実施、一部実施済み、または完了済みのいずれであるかを判断します。一部のみ初期化された Workspace を根拠に、上書きの許可を推測してはいけません。

完了条件：出力先が Workspace のパスであり、置き換えられる可能性のある既存ファイルがすべて把握されていること。

2. ベーステンプレートを配置する

リポジリ所有のテンプレートを対象にコピーします。デフォルトでは不足分のみ作成し、明示的な置き換えの決定があった場合に限り --overwrite を使用します。

完了条件：不足しているベースファイルとディレクトリがすべて配置され、明示的な許可なく既存ファイルが置き換えられていないこと。

3. コア要件を検証する

STATUS.md、UNITS.csv、CHECKPOINTS.md、DECISIONS.md が存在することを確認します。UNITS.csv のヘッダーを解析し、見かけ上だけ初期化された Workspace を残さないよう、不正な CSV を拒否します。

完了条件：4 つのコアファイルが存在し、UNITS.csv が必須のスキーマに従っていること。

4. Workflow のバインドに引き継ぐ

Workflow の選択と Pipeline 固有の Unit の配置は、pipeline-router または Pipeline アダプターに任せます。汎用テンプレートは、Goal がルーティングされたことの証拠にはなりません。

完了条件：チャット履歴の状態を必要とせず、Workspace をルーターに渡せること。

コンテキストポインター

  • ベーステンプレートの要件を確認または変更する場合に限り、assets/workspace-template/ を読みます。
  • Workflow のバインド後に限り、選択された pipelines/*.pipeline.md を読みます。
  • ユーザーが初期化の先まで続行するよう求めた場合は、research-pipeline-runner を使用します。

スクリプト

クイックスタート
uv run python .codex/skills/workspace-init/scripts/run.py \
  --workspace workspaces/<name>
すべてのオプション
  • --workspace <path>：対象の Workspace。
  • --overwrite：明示的な承認を得た後、既存のテンプレート所有ファイルを置き換えます。
  • --unit-id、--inputs、--outputs、--checkpoint：Pipeline-runner との互換性を保つための引数。
例

使用前にインターフェースを確認します。

uv run python .codex/skills/workspace-init/scripts/run.py --help

明示的なリセット決定の後に限り、テンプレートファイルを置き換えます。

uv run python .codex/skills/workspace-init/scripts/run.py \
  --workspace workspaces/<name> \
  --overwrite

トラブルシューティング

  • 既存のファイルはデフォルトでは変更されません。これは想定される冪等な動作であり、初期化の失敗ではありません。
  • スクリプトの対象にリポジトリルートを指定してはいけません。workspaces/<name>/ を使用してください。

コメント

Markdown 対応