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

⭐3stars🔀0forks📁View on GitHub🕐Updated Jan 10, 2026

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.
nameprocess-lifecycle-management
description|
• The Pragmatic Programmer(Andrew Hunt, David Thomas)/ 適用プロセス管理 / 目的: 実践的改善と品質維持

プロセスライフサイクル管理

概要

Node.jsプロセスのライフサイクル管理を専門とするスキル。Linuxカーネルのプロセス管理思想に基づき、プロセスの生成、実行、監視、終了までの完全な制御と、シグナル処理、ゾンビプロセス回避を設計します。

ワークフロー

Phase 1: ライフサイクル分析

目的: プロセスの要件と状態遷移を分析

アクション:

  1. アプリケーションの起動・終了要件を特定
  2. 管理対象プロセス(親・子)を洗い出し
  3. 必要なシグナル処理を決定
  4. 状態遷移図を設計

Task: agents/analyze-lifecycle.md を参照

Phase 2: シグナルハンドラ実装

目的: Graceful Shutdownとシグナル処理を実装

アクション:

  1. assets/signal-handler.template.ts を基にハンドラーを実装
  2. SIGTERM、SIGINT、SIGHUPの処理を定義
  3. クリーンアップ関数を登録
  4. タイムアウト処理を設定

Task: agents/implement-handlers.md を参照

Phase 3: シャットダウン検証

目的: 実装したシグナルハンドラの動作を検証

アクション:

  1. scripts/check-process-health.mjs で動作確認
  2. シグナル送信テストを実施
  3. リソースリークを検証
  4. 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 初版作成