mcpField
W
wrap-session

wrap-session

github.com/product-on-purposeエージェントワークフロー76960 回インストール4 日前に更新
リポジトリ

wrap-session について

wrap-sessionは、作業セッション終了時にプロジェクトの状態と進捗を記録するワークフロー型スキルです。プロジェクト文書やエージェントのコンテキストファイルを更新し、必要に応じて計画資料を保存して、次の作業への提案を含むログを作成します。

主な機能

  1. 01READMEと変更履歴の更新
  2. 02エージェントのコンテキストとタスクの管理
  3. 03必要に応じた計画資料の保存
  4. 04構造化されたセッションログの作成
  5. 05次回作業の開始点を提案

活用シーン

  1. 01セッション終了時に完了作業を記録
  2. 02次の作業セッションに向けてプロジェクト記録を整理

インストール

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

$npx skills add https://github.com/product-on-purpose/pm-skills --skill wrap-session

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

同梱ファイル

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

assets/
CHANGELOG.template.md
references/
changelog-format.md
context-files.md
session-log-format.md

詳細

セッション終了時のワークフロー

作業セッションを終了するときは、このワークフローを実行してプロジェクトの継続性を保ちます。

実行手順

1. プロジェクトのルートを特定する

README.md と CHANGELOG.md があるプロジェクトのルートを見つけます。不明な場合は、ユーザーに確認してください。

2. README.md を更新する

現在の状態を反映するように、プロジェクトの説明とステータスを更新します。変更は最小限にとどめ、意味のある変更があった箇所のみ更新してください。

3. CHANGELOG.md を更新する

Keep a Changelog 形式を使って、[Unreleased] セクションに変更を追記します。形式の詳細は references/changelog-format.md を参照してください。

変更カテゴリ：

  • Added — 新機能／ファイル
  • Changed — 機能の変更
  • Fixed — バグ修正
  • Deprecated — 近日削除予定
  • Removed — 機能の削除
  • Security — 脆弱性の修正

CHANGELOG.md が存在しない場合は、assets/CHANGELOG.template.md を使って作成します。

4. エージェントのコンテキストファイルを更新する

AGENTS/<model>/（例：AGENTS/claude/）にファイルを作成／更新します。

ファイル目的更新するタイミング
CONTEXT.md現在のプロジェクトの状態常に
TODO.mdタスクの追跡タスクに変更があったとき
DECISIONS.md技術的な決定決定を行ったとき

AGENTS フォルダーが存在しない場合： 次の構成をすべて作成します。

AGENTS/
└── claude/
    ├── CONTEXT.md
    ├── TODO.md
    ├── DECISIONS.md
    ├── SESSION-LOG/
    └── PLANNING/

ファイル形式については references/context-files.md を参照してください。

4b. 計画資料を保存する（該当する場合）

セッションに、レビューが必要な資料を作成する計画、レビュー、分析作業が含まれていた場合は、AGENTS/<model>/PLANNING/ に保存します。

PLANNING ドキュメントを作成するタイミング：

  • アーキテクチャの提案または設計ドキュメント
  • コードレビューの要約と推奨事項
  • 調査レポートと調査結果
  • 実装計画とロードマップ

ファイル名：

  • 内容が分かる kebab-case の名前を使用します：auth-system-design.md、api-migration-plan.md
  • 時間依存のドキュメントには日付を先頭に付けます：2025-01-14_performance-analysis.md

必須のフロントマター：

---
created: YYYY-MM-DD
updated: YYYY-MM-DD
sessions:
  - SESSION-LOG/YYYY-MM-DD_HH-MM_session.md
status: draft | in-review | approved | superseded
tags: [planning, review, analysis]
---
5. セッションログを作成する

次の内容を含む AGENTS/<model>/SESSION-LOG/YYYY-MM-DD_HH-MM_session-<ハイフンで区切った4～6語の要約>.md を作成します。

  1. 要約（2～3文）
  2. 主な成果
  3. 決定事項
  4. 発生した問題
  5. 次のセッションへの推奨事項
  6. 次のセッション用プロンプト（作業を続けるためのコピー＆ペースト可能なプロンプト）
  7. セッションのハイライト（主要なプロンプト／応答。全文書き起こしではありません）

テンプレートについては references/session-log-format.md を参照してください。

6. 完了を確認する

ユーザーに次の内容を報告します。

  • 更新／作成したファイル
  • 記録した主な変更
  • 次のセッションで作業を再開する際の推奨箇所

ディレクトリ構成

project-root/
├── README.md
├── CHANGELOG.md
└── AGENTS/
    └── claude/
        ├── CONTEXT.md
        ├── TODO.md
        ├── DECISIONS.md
        ├── SESSION-LOG/
        │   └── YYYY-MM-DD_HH-MM_session.md
        └── PLANNING/
            └── <descriptive-name>.md

実行しない場合

  • 意味のある作業が行われなかった
  • ユーザーがドキュメント作成を明示的に断った
  • プロジェクトが一時的なもの、または使い捨てのものである

コメント

Markdown 対応