create-handoff について
新しいセッションで別のエージェントが作業を引き継げるよう、簡潔かつ十分な引き継ぎ文書を作成するスキルです。scratchpad内の保存先、YAMLメタデータ、目的や実装詳細の記録方法を定めています。
主な機能
- 01指定パスへの引き継ぎ文書作成
- 02構造化されたYAMLフロントマター
- 03目的と実装詳細の記録
- 04大きなコードブロックを避けたファイル参照
活用シーン
- 01実装作業を別のエージェントに引き継ぐ
- 02セッション間でコンテキストを維持する
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ casper-studios/ casper-marketplace --skill create-handoffインストール後、Claude Code で/create-handoffを入力して読み込まれたか確認します。
詳細
引き継ぎドキュメントの作成
新しいセッションで別のエージェントに作業を引き継ぐためのドキュメントを作成してください。内容は十分に詳しくしつつ、簡潔にまとめてください。重要な詳細を失わずに、作業のコンテキストを簡潔に要約することが目標です。
手順
1. ファイルパスとメタデータ
ドキュメントの作成には、次の情報を使用してください。- .claude/scratchpad/handoffs/[feature]_description.md の下にファイルを作成してください。feature は、機能を簡潔に表すケバブケースの説明です。
2. 引き継ぎドキュメントの作成
指定されたファイルパスを使用し、以下の YAML フロントマターパターンに従ってください。YAML フロントマターの後に本文を記述し、ドキュメントを構成してください。
以下のテンプレート構造を使用してください。
---
date: [Current date and time with timezone in ISO format]
git_commit: [Current commit hash]
branch: [Current branch name]
repository: [Repository name]
topic: '[Feature/Task Name] Implementation Strategy'
last_updated: [Current date in YYYY-MM-DD format]
type: implementation_strategy
---
# Handoff: {ticket-id} {very concise description}
## Task(s)
{description of the task(s) that you were working on, along with the status of each (completed, work in progress, planned/discussed). If you are working on an implementation plan, make sure to call out which phase you are on. Make sure to reference the plan document and/or research document(s) you are working from that were provided to you at the beginning of the session, if applicable.}
## Critical References
{List any critical specification documents, architectural decisions, or design docs that must be followed. Include only 2-3 most important file paths. Leave blank if none.}
## Recent changes
{describe recent changes made to the codebase that you made in line:file syntax}
## Learnings
{describe important things that you learned - e.g. patterns, root causes of bugs, or other important pieces of information someone that is picking up your work after you should know. consider listing explicit file paths.}
## Artifacts
{ an exhaustive list of artifacts you produced or updated as filepaths and/or file:line references - e.g. paths to feature documents, implementation plans, etc that should be read in order to resume your work.}
## Action Items & Next Steps
{ a list of action items and next steps for the next agent to accomplish based on your tasks and their statuses}
## Other Notes
{ other notes, references, or useful information - e.g. where relevant sections of the codebase are, where relevant documents are, or other important things you leanrned that you want to pass on but that don't fall into the above categories}
##. 追加の注意事項と指示
- 情報は少なくするのではなく、多くしてください。これは、引き継ぎドキュメントに最低限含めるべき内容を定めるガイドラインです。必要に応じて、さらに情報を追加してください。
- 十分に詳しく、正確に記述してください。必要に応じて、上位レベルの目標と詳細な内容の両方を含めてください。
- コードスニペットは過剰に含めないでください。重要な変更を説明するための短いスニペットは有用ですが、大きなコードブロックや差分は避けてください。デバッグ中のエラーに関係するなど、必要な場合を除き、含めないでください。代わりに、エージェントが後で確認できるよう、
packages/dashboard/src/app/dashboard/page.tsx:12-24のような/path/to/file.ext:line形式の参照を使用してください。
コメント
Markdown 対応