devstack について
Devstackは、process-composeで開発環境を管理するスキルです。ヘルスチェック、依存関係に基づく起動順序、TUIを備え、人による操作とAIエージェントのヘッドレス運用に対応します。
主な機能
- 01process-composeによるプロセス管理
- 02サービスのヘルスチェック
- 03依存関係に基づくサービス順序
- 04TUIでの環境管理
- 05エージェント向けヘッドレス実行
活用シーン
- 01プロジェクト開発環境の初期設定
- 02開発サービスの起動・停止
- 03サービス状態とログの確認
- 04開発中のサービス再起動
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ steveclarke/ dotfiles --skill devstackインストール後、Claude Code で/devstackを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/daily-reference.mdinit-reference.mdtemplates/bin-devbin-worktreeDEVSTACK.mdprocess-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 を読んでください。上記のコマンドは慣例であり、保証されているわけではありません。
コメント
Markdown 対応