mcpField
D
devstack

devstack

github.com/steveclarke開発3695 回インストール今日更新
リポジトリ

devstack について

Devstackは、process-composeで開発環境を管理するスキルです。ヘルスチェック、依存関係に基づく起動順序、TUIを備え、人による操作とAIエージェントのヘッドレス運用に対応します。

主な機能

  1. 01process-composeによるプロセス管理
  2. 02サービスのヘルスチェック
  3. 03依存関係に基づくサービス順序
  4. 04TUIでの環境管理
  5. 05エージェント向けヘッドレス実行

活用シーン

  1. 01プロジェクト開発環境の初期設定
  2. 02開発サービスの起動・停止
  3. 03サービス状態とログの確認
  4. 04開発中のサービス再起動

インストール

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

$npx skills add https://github.com/steveclarke/dotfiles --skill devstack

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

同梱ファイル

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

references/
daily-reference.md
init-reference.md
templates/
bin-dev
bin-worktree
DEVSTACK.md
process-compose.yml

詳細

Devstack — 開発環境のオーケストレーション

process-compose を使用して、ヘルスチェック、依存関係に基づく起動順序、TUI を備えたヘッドレスなプロセスオーケストレーションで開発環境を管理します。人間と AI エージェントのどちらにも対応しています。

ステータス: 開発中です。実行中のスタックの操作で予期しない問題(クライアントコマンドの失敗、接続拒否、ソケットエラー)が発生した場合は、回避策を黙って講じるのではなく、すぐにユーザーに伝えてください。ユーザーはこのスキルを管理しており、改善のためのフィードバックを必要としています。

モードの判定

コンテキストを確認し、使用するモードを判定します。

初期化モード — プロジェクトにまだ DEVSTACK.md がない場合、またはユーザーが明示的に devstack のセットアップを依頼した場合:

  • 初期化のリファレンスを読みます:references/init-reference.md

日常モード — プロジェクトに DEVSTACK.md があり、ユーザーがワークツリーの作成、サービスの起動・停止、または開発環境の管理を希望している場合:

  • プロジェクトのルートにある DEVSTACK.md を読み、その指示に従います
  • トラブルシューティングや高度なパターンについては、次を読みます:references/daily-reference.md

クイックリファレンス(日常モード)

DEVSTACK.md が存在する場合、以下が標準コマンドです。

タスクコマンド
起動(人間、TUI)bin/dev
起動(エージェント、ヘッドレス)bin/dev -D
停止bin/dev stop
ステータス(テーブル)bin/dev status
ステータス(JSON)bin/dev status --json
ログbin/dev logs <service>
サービスの再起動bin/dev restart <service>
ヘルスチェック完了まで待機bin/dev status(すべてのサービスが Ready と表示されるまでポーリング)

プロジェクト固有の詳細については、必ず DEVSTACK.md を読んでください。上記のコマンドは慣例であり、保証されているわけではありません。

コメント