agentleFS
mae616mae616/ai-template/.claude/skills/session-start/SKILL.md

session-start

Skill9 starsChanged 3 months agoMITView on GitHub

セッション開始時にゴール・完了条件・タイムボックスを明確化する。作業セッションの冒頭で方向性を揃えるために使う。

  • Commits and pushes

39 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use deploy-verify, reflect and 2 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • danielarif26Skill

    deploy-verify

    Verify a Vercel deployment actually went live and serves the correct production domain. Self-improving: reads its own run history before checking and logs the outcome after. Use when the user asks "did you deploy?", "is it live?", "verify the deploy", "check vercel", or after any Vercel deploy. Part of the Agentic OS (Level 1 backbone).

    Also in 3 projects that use this

  • Microsoft AzureSkill

    reflect

    Learning capture system that extracts HIGH/MED/LOW confidence patterns from conversations to prevent repeating mistakes. Use after user corrections ("no", "wrong"), praise ("perfect", "exactly"), or when discovering edge cases. Complements .squad/agents/{agent}/history.md and .squad/decisions.md.

    Also in 4 projects that use this

  • ibahgatSkill

    autopilot

    Run autonomous multi-stage execution loops until acceptance criteria pass or blockers are reached.

    Also in 3 projects that use this

  • MicrosoftSkill

    handoff

    Compact the current conversation into a handoff document for another agent to pick up.

    Also in 3 projects that use this

The file

Files
SKILL.md

[セッション] セッション開始

入力: $ARGUMENTS

  • タスクの概要(省略可)
  • 例: PRレビュー対応 #123
  • 例: ドキュメント更新

🎯 目的

  • セッション開始時にゴール・完了条件を明確化して、「partially_achieved」を防ぐ
  • タイムボックスを意識して、中断時も進捗が残る計画を立てる
  • 複数タスクを1セッションに詰め込み過ぎない

実行手順

0. 前回からの引き継ぎ確認

history/journal.md(開発日誌)があれば最新の日付エントリを読み、前回やったこと・引き継ぎ事項を把握する。

# 存在すれば最新エントリを確認(gitignore済み・ローカルのみ)
[ -f history/journal.md ] && head -40 history/journal.md
  • 引き継ぎ事項があれば、今回のゴール設定に反映する
  • なければ(新規プロジェクト等)スキップしてよい

1. タスク確認

引数ありの場合: タスク: {$ARGUMENTS}

引数なしの場合:

## 🎯 今回のセッションで何をしますか?

以下から選択、または自由記述してください:

1. **実装** - 機能追加/バグ修正
2. **レビュー対応** - PRのレビューコメント対応
3. **ドキュメント** - ドキュメント作成/更新
4. **デザイン** - UI/デザイン作業
5. **調査** - 技術調査/リサーチ
6. **その他** - 自由記述

> 例: 「PRレビュー対応 #123」「ログイン機能のバグ修正」

2. ゴールと完了条件の定義

## 📋 セッション計画

### ゴール
{1文で完了状態を記述}

### 完了条件(Definition of Done)
- [ ] {具体的な完了条件1}
- [ ] {具体的な完了条件2}
- [ ] {具体的な完了条件3}

### 成果物
- {期待される成果物: コミット/ファイル/ドキュメント等}

⚠️ ユーザー確認: この計画で進めてよいか確認


3. タスク分割(必要に応じて)

大きなタスクの場合、1セッションで完了可能な粒度に分割:

### タスク分割

**元のタスク**: {original_task}

**分割案**:
| # | サブタスク | 優先度 | 今回対応 |
|---|-----------|--------|----------|
| 1 | {subtask1} | 高 | ✅ |
| 2 | {subtask2} | 中 | ✅ |
| 3 | {subtask3} | 低 | ❌ 次回 |

**今回のスコープ**: サブタスク1-2まで

> 💡 1セッション1-2タスクを推奨。詰め込み過ぎると後半が未完了になりがち

4. チェックポイント設定

### チェックポイント(中断対策)

途中で中断されても進捗が残るよう、以下のタイミングでコミット:

| タイミング | 内容 |
|-----------|------|
| CP1 | {最初の区切り - 例: 調査完了} |
| CP2 | {次の区切り - 例: 実装完了} |
| CP3 | {最終 - 例: テスト完了} |

> ⏰ 各チェックポイントで進捗を保存(コミット)してから次へ

5. セッション開始宣言

---

## ✅ セッション開始

**ゴール**: {goal}
**スコープ**: {scope}
**チェックポイント**: {cp_count}箇所

では、始めましょう!

---

出力例

## 📋 セッション計画

### ゴール
PR #123 のレビューコメント3件に対応し、pushする

### 完了条件(Definition of Done)
- [ ] レビューコメント3件すべてに対応済み
- [ ] 各対応ごとにコミット完了
- [ ] git push 完了
- [ ] レビュアーに再レビュー依頼

### 成果物
- コミット3件(各コメント対応)
- push済みのブランチ

### チェックポイント
| タイミング | 内容 |
|-----------|------|
| CP1 | コメント1対応 → コミット |
| CP2 | コメント2対応 → コミット |
| CP3 | コメント3対応 → コミット → push |

---

## ✅ セッション開始

**ゴール**: PR #123 レビュー対応完了
**スコープ**: コメント3件対応 + push
**チェックポイント**: 3箇所

では、始めましょう!

連携スキル

  • /session-end - セッション終了時の進捗サマリー・再開用プロンプト生成
  • /pr-respond - PRレビューコメント対応
  • /task-run - Issueベースのタスク実行

注意事項

  • 1セッション1-2タスクを目安に
  • 完了条件は具体的に(「〜する」ではなく「〜が完了している」)
  • チェックポイントは必ずコミットで進捗を保存
  • 計画に時間をかけすぎない(5分以内目安)

自己評価

  • 成功自信度: (1-10)
  • 一言理由: {短く理由を記載}

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.