How this skill is triggered — by the user, by Claude, or both
Slash command
/handoff:createThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
- HANDOFF_PATH: $ARGUMENTS
任意のAIコーディングエージェント(Claude Code, Cursor, Copilot, Aider等)が作業を継続できるよう、
HANDOFF.md を作成してください。
現在の状態を把握するため、以下を実行してください。
!git status !git diff --stat !git log --oneline -5
会話履歴から以下を抽出してください:
以下の構造で記述してください。空のセクションは省略可。ただし Failed Approaches に該当があれば必ず記載すること。
# Handoff: [簡潔なタスクタイトル]
**Generated**: [日時]
**Branch**: [git branch]
**Status**: [In Progress / Blocked / Ready for Review]
## Goal
[1-2文: ユーザーが達成したいこと]
## Completed
- [x] [完了した具体的な項目]
- [x] [もう1項目]
## Not Yet Done
- [ ] [残作業 — 具体的に]
- [ ] [もう1項目]
## Failed Approaches (Don't Repeat These)
[何かを試して断念した場合は必ず記載すること:]
- 試したこと
- 失敗の理由(エラーメッセージ、性能問題、設計上の欠陥)
- なぜ現在のアプローチがより良いか
例:
> passport.jsでOAuthを試したが、既存のExpress middlewareと衝突しreq.userがundefinedになった。
> oauth4webapiに変更し、fetchで直接動くようにした。
## Key Decisions
| 決定事項 | 根拠 |
|---|---|
| [選択した内容] | [なぜこのアプローチか] |
## Current State
**Working**: [現在動作している箇所]
**Broken**: [動作していない箇所、関連エラーメッセージ]
**Uncommitted Changes**: [未staging/staged済みの変更サマリ]
## Files to Know
| ファイル | 重要な理由 |
|---|---|
| `path/to/key/file.ts` | [簡潔な説明] |
## Code Context
[次のエージェントが必要な実コードを含める。説明ではなく実物を示す]
**主要なinterface/signature** (呼び出し方・修正方法を理解するため):
\`\`\`typescript
// 例: hookのシグネチャ
function useAuth(): { user: User | null; login: (creds: Credentials) => Promise<void> }
\`\`\`
**APIリクエスト/レスポンス形状** (バックエンド作業の場合):
\`\`\`json
// POST /api/resource - レスポンス例
{ "id": 123, "status": "created" }
\`\`\`
**自明でないロジック** (一読では分からない箇所)
## Resume Instructions
[極めて具体的に。「機能を確認」ではなく、期待結果を含むステップバイステップで:]
1. [必要な準備 — マイグレーション、env var等]
2. [最初のアクション — 正確なコマンド・編集対象ファイル]
3. [検証ステップ — 期待結果を含めて]
- 期待: [何が起きるべきか]
- 失敗時: [何を確認するか]
例:
1. `alembic upgrade head` でマイグレーション適用
2. サーバー起動: `./start.sh`
3. ログインフローのテスト: POST /api/login に [email protected] / testpass
- 期待: 200レスポンス、{ token: "..." }
- 401の場合: DBにユーザーが存在するか確認
## Setup Required
[次のエージェントに必要な前提条件がある場合のみ:]
- 環境変数: `API_KEY`, `DATABASE_URL`
- テストアカウント: [email protected] / password123
- 必要サービス: Redisが :6379 で起動していること
## Edge Cases & Error Handling
[既知のエッジケースとその扱い:]
- [Xが失敗した場合] → [現在の挙動 / 「未対応」]
- [ユーザーがYをした場合] → [期待される挙動]
## Warnings
[落とし穴、間違って見えるが意図的なもの、避けるべき罠]
HANDOFF_PATH が指定されていればそのパスへ、未指定なら作業ディレクトリの HANDOFF.md に保存してください。
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub under-the-bridge-hq/shared-workflows --plugin handoff