Skip to content
cccskills
FreePublished on GitHub

session-retrospective

セッション終了時に自己改善Issueを自動生成するスキル。「振り返りIssue出して」「レトロスペクティブ」「改善点をIssueにして」等のリクエストで発動。

The English summary is being prepared. Showing the original description.

Works withGitHub
See how to install

Files included (5)

  • SKILL.md4.8 KB
  • agents/openai.yaml281 B
  • scripts/create_issues.py4.2 KB
  • SKILL.en.md4.4 KB
  • SKILL.es.md4.8 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Session Retrospective - セッション自己改善Issue生成

概要

セッション(会話)の終了時に、遭遇した問題・非効率・改善すべき点を振り返り、 GitHub Issue として自動登録するスキルです。

トリガー

以下のようなリクエストで発動:

  • 「振り返りIssue出して」「自己改善Issue」
  • 「レトロスペクティブ」「session-retro」
  • 「改善点をIssueにして」
  • セッション終了時の自動ルーティンとして

ワークフロー

Phase 1: セッション振り返り(自動分析)

会話履歴から以下のカテゴリで改善点を抽出:

カテゴリラベル検出パターン
認証・設定の不備authトークン取得失敗、API認証エラー、環境変数の不整合
パス・規約の欠如convention形式のバラつき、命名規約の不統一、テンプレート非準拠
ツール・スクリプト不足toolingワンオフスクリプトで対処した箇所、自動化すべき手作業
ドキュメント不整合docsCLAUDE.mdとMEMORYの矛盾、古い記載、情報の重複管理
ワークフローの非効率workflow試行錯誤が多かった箇所、フォールバックが必要だった処理
エラーハンドリングerror想定外のエラー、不親切なエラーメッセージ、リトライが必要だった処理

Phase 2: Issue ドラフト生成

各改善点について以下の構造でIssueを生成:

## 背景
(何をしている時に問題が発生したか)

## 問題
(具体的な問題点。エラーメッセージやコマンドがあれば含める)

## 提案
(改善案を1〜3つ、具体的に)

## 発生状況
(どのセッション・タスクで発生したか)

Phase 3: ユーザー確認

AskUserQuestion で各Issue候補を表示し、登録するか選択してもらう:

  • 「全て登録」
  • 「選んで登録」(1件ずつ確認)
  • 「修正して登録」(内容を編集してから)

Phase 4: GitHub Issue 登録

# GH_TOKEN取得(git remote URLから抽出)
export GH_TOKEN=$(git remote get-url origin | grep -oP '(?<=https://)[^@]+(?=@)' | sed 's/x-access-token://')    # Mac/Linux/WSL

# Issue登録(--body-file を使用。heredoc だと Markdown のコードブロックでエスケープ問題が発生する)
cat > /tmp/issue_body.md << 'EOF'
Issue本文(Markdown)
EOF
gh issue create --repo minicoohei/ai-agent-camp \
  --title "改善: <タイトル>" \
  --body-file /tmp/issue_body.md

実行方法

方法1: スキル呼び出し

振り返りIssueを出して

方法2: スクリプト直接実行(テンプレートからIssue生成)

# JSONファイルから一括登録
python skills/session-retrospective/scripts/create_issues.py --input issues.json

# テストモード(dry-run、実際には登録しない)
python skills/session-retrospective/scripts/create_issues.py --input issues.json --dry-run

Issue品質ガイドライン

良いIssue

  • 再現可能な具体的な問題記述
  • 実行したコマンドやエラーメッセージを含む
  • 1 Issue = 1 改善点(スコープが明確)
  • 提案が実装可能で具体的

悪いIssue(出すべきでないもの)

  • 「もっと良くしたい」のような漠然とした内容
  • セッション固有の一時的な問題(再発しないもの)
  • ユーザーの操作ミスに起因するもの
  • 既存のIssueと重複する内容

分析テンプレート

セッションを振り返る際の思考フレームワーク:

  1. ブロッカー: 作業が止まった瞬間はあったか? → 根本原因は?
  2. ワークアラウンド: 正規の方法ではなく迂回策を使った箇所はあるか?
  3. 繰り返し: 同じ作業を2回以上行った箇所はあるか?
  4. ドキュメント参照: CLAUDE.mdやMEMORYを見ても答えがなかった質問は?
  5. 手作業: スクリプトやツールで自動化できた手作業は?

出力

  • GitHub Issues(minicoohei/ai-agent-camp リポジトリ)
  • コンソールにIssue URLを一覧表示

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

A/Bテストや実験の設計・実装を支援するスキル。 「A/Bテストを設計して」「スプリットテストしたい」「仮説を立ててテストしたい」「バリアントを比較」等のリクエストで発動。 トラッキング実装は analytics-tracking を参照。

The English summary is being prepared. Showing the original description.

minicoohei/ai-agent-camp346Updated Oct 7, 2026

マルチエージェントシステムのアーキテクチャ設計ツールキット。 「エージェントを設計して」「マルチエージェント構成」「エージェントのアーキテクチャ」「オーケストレーション設計」等のリクエストで発動。

The English summary is being prepared. Showing the original description.

minicoohei/ai-agent-camp346Updated Oct 7, 2026

ai-agent-campのローカル環境セットアップを確認するスキル。 「セットアップ確認」「環境チェック」「初期設定できてる?」「インストール確認」「依存関係チェック」等のリクエストで発動。

The English summary is being prepared. Showing the original description.

minicoohei/ai-agent-camp346Updated Oct 7, 2026

ai-agent-campのスラッシュコマンドをCodexでルーティングするスキル。 「/start-0-1を実行」「スラッシュコマンドを使いたい」「コマンドルーティング」「Cursorのコマンドを使いたい」等のリクエストで発動。

The English summary is being prepared. Showing the original description.

minicoohei/ai-agent-camp346Updated Oct 7, 2026

ai-agent-campの環境変数・認証情報を安全に管理するスキル。 「APIキーを設定」「.envを管理」「環境変数の設定」「credential managerを使いたい」「秘密情報の管理」等のリクエストで発動。

The English summary is being prepared. Showing the original description.

minicoohei/ai-agent-camp346Updated Oct 7, 2026

ai-agent-campリポジトリの案内・オリエンテーションスキル。 「リポジトリ案内」「次のレッスンは?」「どこから始める」「ツールの違い」「aiagent概要」等のリクエストで発動。

The English summary is being prepared. Showing the original description.

minicoohei/ai-agent-camp346Updated Oct 7, 2026

See all skills by minicoohei

Report a problem with this skill