process-lifecycle-management

daishiman 的头像作者 daishiman

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

📖 中文导读: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 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: process-lifecycle-management description: | 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 allowed-tools: - Read - Write - Edit - Bash - Glob - Grep

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

概要

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 初版作成