mcpField
P
ptns

ptns

github.com/guojie-hongエージェントワークフロー143 回インストール6 日前に更新
リポジトリ

ptns について

ptns は、新しいエージェントセッションが初期状態から作業を引き継げるよう、引き継ぎプロンプトを作成するスキルです。検証済みの進捗、現在の状態、決定事項、次の手順をまとめ、利用可能なエージェントツールに応じて提示します。

主な機能

  1. 01目標と検証済みの進捗の収集
  2. 02状態、決定事項、試した方法の記録
  3. 03正確なファイル名とコマンドの特定
  4. 04引き継ぎ内容の機密情報の伏字化
  5. 05プロンプトの送信またはコピー用整形

活用シーン

  1. 01未完了タスクの新しいセッションへの引き継ぎ
  2. 02デバッグ時の判断や知見の保存
  3. 03焦点を絞った継続用プロンプトの作成
  4. 04接続可能な Claude Code セッションへの引き継ぎ送信

インストール

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

$npx skills add https://github.com/guojie-hong/skills --skill ptns

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

同梱ファイルagents/openai.yaml

詳細

新しいセッションへの引き継ぎ

引き継ぎプロンプトを書いてください。別のセッションは、この文章だけを受け取って開始します。その初見の読者に向けて書いてください。

ユーザーが引数を渡した場合、それは次のセッションの焦点を示しています。それに合わせてプロンプトを作成してください。

1. 状況を把握する

この会話から情報を集め、環境で確認できることがあれば確認してください。

  • 目標を一文で示してください。
  • 完了した作業と、それぞれの検証方法を示してください。未検証のものは未検証と明記してください。
  • 現在の状況:ブランチ、未コミットの変更、実行中または作業途中のもの。
  • 次のステップ。すぐ着手できる程度に具体的にしてください。
  • 決定事項と、それぞれの理由。次のセッションで再検討されないようにしてください。
  • すでに試した行き詰まりと、実際に試して見つかった注意点。
  • 次のステップで触れる正確なファイル、シンボル、コマンド。

一度の参照で次のセッションが見つけられる情報(git log、ファイルの内容、--help)は省いてください。理由、行き詰まり、文書化されていない慣例など、次のセッションでは見つけられない情報を残してください。

2. プロンプトを書く

ユーザーが使っている言語で書いてください。

  • 次のセッションに直接、命令形で語りかけてください(「続けて…」「次に…」など)。
  • パス、シンボル、コマンドは正確なままにしてください。
  • 秘密情報を伏せてください。API キー、パスワード、トークン、個人情報はすべて、<API_KEY> のようなプレースホルダーに置き換えてください。
  • 簡潔にしてください。各行には、次のセッションが改めて調べたり尋ねたりせずに済む情報を記載してください。
  • 次のセッションが作業するディレクトリから始めてください。
  • 次のステップと、完了を判断する方法で締めくくってください。

初見の読者が質問を一つもせずに次のステップを開始できれば完了です。

3. 引き継ぎを行う

まず、このスキルを実行しているエージェントを確認してください。

  • Claude Code — ListAgents と SendMessage ツールが使えます。3a に従ってください。
  • それ以外(Codex、agy、またはそれらのツールを持たないエージェント)— 3b に従ってください。

ユーザーに使用中のエージェントを尋ねないでください。実際に使えるツールを確認してください。

3a. Claude Code — 稼働中のセッションに送信する
  1. ListAgents を呼び出して、接続可能なセッションを一覧表示してください。
  2. 接続可能なセッションを、名前、種類、わかる場合は作業ディレクトリを含む簡潔な番号付きリストでユーザーに示してください。このセッション自体は除いてください。
  3. どのセッションに送るか尋ねてください。選択肢が2~4個の場合は AskUserQuestion を使ってください。必ず 「送信しない — プロンプトを表示するだけ」 という選択肢を含めてください。ユーザーがこれを選んだ場合は、3b に従ってください。
  4. 一覧が空の場合は、その旨を一行で伝え、3b に従ってください。
  5. ユーザーの回答後、ListAgents に表示された名前を正確に使い、引き継ぎプロンプトを選択されたセッションに SendMessage してください。プロンプトの最後に要約依頼を加えてください。受信者は次のステップを始める前に、受け取った引き継ぎメッセージの from アドレスへ、目標と次のステップを自分の言葉で述べ、疑問点があればすべて列挙して返信し、その後こちらの返答を待つよう依頼してください。
  6. 送信先のセッション名と、その要約を待っている旨を一行で伝えてください。プロンプト全体を再掲しないでください。
  7. 要約が届いたら、この会話の内容と照合してください。この会話ですでに解決している質問にはそれぞれ回答し、誤解があればそれぞれ訂正して、すべてを一度の SendMessage で送ってください。ユーザーには、この会話で解決していない質問だけを提示し、その回答も同じメッセージで伝えてください。
  8. 受信者が、誤解と質問すべてに対する返答を受け取ったら完了です。受信者が次のステップに進める状態になったことを一行でユーザーに伝え、その過程でユーザーが下した決定があれば示してください。

ユーザーが回答する前に送信してはいけません。送信先を推測してはいけません。

3b. その他のエージェント — コピー可能なブロックで引き継ぐ

プロンプト全体を、一度にコピーできるように、フェンス付きコードブロック一つの中に入れてください。

コードブロックだけを返信してください。ただし、プロンプトが依存する情報に不確実な点がある場合は、ブロックの後にその内容を一行で示してください。

コメント