process-lifecycle-management
Node.jsプロセスのライフサイクル管理を専門とするスキル。Linuxカーネルのプロセス管理思想に基づき、プロセスの生成、実行、監視、終了までの完全な制御と、シグナル処理、ゾンビプロセス回避を設計します。Anchors:• The Pragmatic Programmer(Andrew Hunt, David Thomas)/ 適用: プロセス管理 / 目的: 実践的改善と品質維持Trigger:process lifecycle management, application startup and shutdown control, graceful shutdown implementation, signal handler design, PM2 process management configuration
When & Why to Use This Skill
This Claude skill specializes in Node.js process lifecycle management, drawing on Linux kernel principles to ensure robust application stability. It provides comprehensive control over process creation, execution, and termination, focusing on graceful shutdowns, signal handling (SIGTERM/SIGINT), and preventing zombie processes to maintain high system reliability and resource efficiency.
Use Cases
- Implementing graceful shutdown logic in production Node.js services to ensure all pending requests and database connections are closed properly before termination.
- Designing robust signal handlers for containerized applications (Docker/Kubernetes) to handle orchestration signals and prevent abrupt process kills.
- Managing complex parent-child process hierarchies and implementing strategies to avoid zombie processes and resource leaks in high-concurrency environments.
- Configuring advanced PM2 process management settings for automated monitoring, health checks, and optimized application restarts.
- Developing custom cleanup routines and timeout mechanisms to ensure applications exit cleanly within a defined timeframe.
| name | process-lifecycle-management |
|---|---|
| description | | |
| • The Pragmatic Programmer(Andrew Hunt, David Thomas)/ 適用 | プロセス管理 / 目的: 実践的改善と品質維持 |
プロセスライフサイクル管理
概要
Node.jsプロセスのライフサイクル管理を専門とするスキル。Linuxカーネルのプロセス管理思想に基づき、プロセスの生成、実行、監視、終了までの完全な制御と、シグナル処理、ゾンビプロセス回避を設計します。
ワークフロー
Phase 1: ライフサイクル分析
目的: プロセスの要件と状態遷移を分析
アクション:
- アプリケーションの起動・終了要件を特定
- 管理対象プロセス(親・子)を洗い出し
- 必要なシグナル処理を決定
- 状態遷移図を設計
Task: agents/analyze-lifecycle.md を参照
Phase 2: シグナルハンドラ実装
目的: Graceful Shutdownとシグナル処理を実装
アクション:
assets/signal-handler.template.tsを基にハンドラーを実装- SIGTERM、SIGINT、SIGHUPの処理を定義
- クリーンアップ関数を登録
- タイムアウト処理を設定
Task: agents/implement-handlers.md を参照
Phase 3: シャットダウン検証
目的: 実装したシグナルハンドラの動作を検証
アクション:
scripts/check-process-health.mjsで動作確認- シグナル送信テストを実施
- リソースリークを検証
- PM2との連携を確認
Task: agents/validate-shutdown.md を参照
Task仕様ナビ
| Task | 起動タイミング | 入力 | 出力 |
|---|---|---|---|
| analyze-lifecycle | Phase 1開始時 | アプリケーション要件情報 | ライフサイクル設計書 |
| implement-handlers | Phase 2開始時 | ライフサイクル設計 | シグナルハンドラ実装 |
| validate-shutdown | Phase 3開始時 | 実装済みハンドラ | 検証結果レポート |
ベストプラクティス
すべきこと
- Node.jsプロセスの起動・終了フローを設計する時
- シグナルハンドラーを実装する時
- 子プロセスの管理戦略を決定する時
- PM2でプロセスを管理する設定を行う時
- Graceful Shutdownの実装時にタイムアウトを設定する
- クリーンアップ関数を逆順(後入れ先出し)で実行する
避けるべきこと
- アンチパターンや注意点を確認せずに進めることを避ける
- graceful shutdownの実装なしに本番環境へ展開することを避ける
- シグナルハンドラーなしのプロセス管理を避ける
- 子プロセスの終了確認なしの設計を避ける
- SIGKILLへのハンドラー登録(不可能)を試みることを避ける
リソース参照
references/
| リソース | パス | 用途 |
|---|---|---|
| 基本概念 | references/basics.md |
プロセス管理の基本理論 |
| 実装パターン | references/patterns.md |
パターンのナビゲーション |
| シグナル処理 | references/signal-handling.md |
シグナルハンドリング詳細ガイド |
| プロセス状態 | references/process-states.md |
状態遷移とライフサイクル管理 |
| 子プロセスパターン | references/child-process-patterns.md |
子プロセス管理の実装パターン集 |
scripts/
| スクリプト | 用途 | 使用例 |
|---|---|---|
check-process-health.mjs |
プロセスヘルスチェック | node scripts/check-process-health.mjs |
validate-skill.mjs |
スキル構造検証 | node scripts/validate-skill.mjs |
log_usage.mjs |
使用記録と自動評価 | node scripts/log_usage.mjs |
assets/
| テンプレート | 用途 |
|---|---|
signal-handler.template.ts |
Signal Handler実装テンプレート |
変更履歴
| Version | Date | Changes |
|---|---|---|
| 2.1.0 | 2026-01-02 | 18-skills.md完全準拠: references/構造変更(Level1-4→basics/patterns)、validate-shutdown追加 |
| 2.0.0 | 2026-01-02 | 18-skills.md仕様準拠版に再構築: agents/Task仕様書追加、references統合 |
| 1.1.0 | 2025-12-31 | Anchors/Trigger追加、Task仕様ナビ(テーブル形式)追加 |
| 1.0.0 | 2025-12-24 | 初版作成 |