القائمة
Claude Codeセッションの技術的学びを抽出し、learnリポジトリにマークダウンとして保存・pushするスキル。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Start implementation work with worktree isolation and cross-session file conflict avoidance. Use this skill when beginning any non-trivial code change: after plan mode, when creating a new branch, implementing features, fixing bugs across multiple files, or refactoring. Also use when the user mentions worktree, bit issue, session coordination, or parallel work.
Turn a report into a portable SVG by authoring a structured/graphical HTML layout and rendering it to SVG with satoru-render. Use when the user asks to compile, summarize, or visualize a report, or wants graphical output that stays viewable in environments that cannot render HTML (chat, PDF viewers, image-only tools, git diffs). Proactively offer SVG output whenever you produce a report that benefits from layout, charts, tables, or styling.
Plan modeで作成したプランに対して、プロジェクト特性を分析し適切なレビューエージェントを自動選択・並列起動するスキル。引数なしで実行可能。
Persist mid-session progress (plan refinements, task progress notes, scope changes, decisions, blockers) to the bit issues created by start-work. Use as a checkpoint before context compaction, after meaningful progress (multiple tasks done, plan refined, scope shifted), before pausing work, or when the user mentions 'save session', 'snapshot', 'checkpoint', 'update bit issue', or 'persist progress'.
Restore session state (plan, target files, in-flight tasks) from bit issues created by the start-work skill. Use when resuming work after Claude Code restart, when the in-memory task list is empty but bit issues exist for the current branch, or when the user mentions "restore session", "repair session", "pick up where I left off", or references a prior bit-issue-tracked session.
agent 向けテキスト指示（skill / slash command / task プロンプト / CLAUDE.md 節 / コード生成プロンプト）を、バイアスを排した実行者に動かしてもらい、両面（実行者の自己申告 + 指示側メトリクス）で評価して反復改善する手法。改善が頭打ちになるまで回す。プロンプトや skill を新規作成・大幅改訂した直後、またはエージェントの挙動が期待通りにならない原因を指示側の曖昧さに求めたいときに使う。
| name | output-learn |
| description | Claude Codeセッションの技術的学びを抽出し、learnリポジトリにマークダウンとして保存・pushするスキル。 |
Claude Codeセッション中の技術的学びを体系化し、ushironoko/learnリポジトリに保存する。
/Users/ushironoko/ghq/github.com/ushironoko/learn/src/<category>/<topic-slug>.md
5フェーズで動作する：
会話履歴から技術的学びを抽出する。
抽出対象：
学びが見つからない場合は、セッションが技術的内容でないことをユーザーに通知して終了。
キーワードから候補カテゴリを自動検出し、AskUserQuestionでユーザー確認を行う。
カテゴリ例：
| カテゴリ | 対象 |
|---|---|
typescript | TypeScript言語機能、型システム |
bun | Bun runtime、API |
testing | テスト手法、Vitest、Jest |
git | Git操作、ワークフロー |
cli | CLI開発、コマンドライン |
architecture | 設計パターン、アーキテクチャ |
library/<name> | 特定ライブラリの使い方 |
devops | CI/CD、インフラ |
performance | パフォーマンス最適化 |
AskUserQuestionで確認：
- 検出されたカテゴリ候補を提示
- カスタムカテゴリの入力も許可
以下のテンプレートに基づいてマークダウンを生成する。
ファイル名: <topic-slug>.md（小文字ケバブケース）
テンプレート:
# <タイトル>
## 概要
<学びの概要を1-2文で>
## 背景・きっかけ
<どのような状況でこの学びを得たか>
## 学んだこと
### <サブトピック>
<詳細な説明>
```<language>
// コード例
```
## ポイント
- <重要ポイント1>
- <重要ポイント2>
## 参考
- [リンクテキスト](URL)
生成したマークダウンのプレビューを表示し、ユーザー確認を行う。
確認内容：
AskUserQuestionで確認：
- 承認して保存
- 内容を修正（修正点を指示）
- ファイル名を変更
- キャンセル
同名ファイルが存在する場合の選択肢：
AskUserQuestionで確認：
- 上書き
- 別名で保存（サフィックス追加）
- 既存ファイルに追記
- キャンセル
承認後、以下の手順でファイルを保存しPushする。
# 1. learnリポジトリの存在確認
LEARN_REPO="/Users/ushironoko/ghq/github.com/ushironoko/learn"
if [ ! -d "$LEARN_REPO" ]; then
echo "learnリポジトリが見つかりません"
echo "ghq get ushironoko/learn を実行してください"
exit 1
fi
# 2. カテゴリディレクトリ作成（必要時）
mkdir -p "$LEARN_REPO/src/<category>"
# 3. ファイル作成
# Writeツールでマークダウンを書き込む
# 4. Git操作
cd "$LEARN_REPO"
git add "src/<category>/<topic-slug>.md"
git commit -m "Add: <タイトル>"
git push origin main
| 状況 | 対応 |
|---|---|
| learnリポジトリ未クローン | ghq get ushironoko/learnの実行を提案 |
| 技術的学びが抽出できない | セッションが技術的内容でないことを通知して終了 |
| Git push失敗 | エラー内容を表示し、手動対応（認証、ネットワーク）を提案 |
| 同名ファイル存在 | 上書き/別名/追記の選択をAskUserQuestionで確認 |
| カテゴリディレクトリ作成失敗 | パーミッションエラーを報告 |
> /output-learn
=== Phase 1: セッション分析 ===
会話履歴を分析中...
検出された学び:
1. c12の環境別設定オーバーライド機能
2. defuによるディープマージの挙動
3. Bunのテスト用一時ディレクトリ作成パターン
=== Phase 2: カテゴリ決定 ===
検出されたキーワード: c12, defu, Bun, テスト
推奨カテゴリ: library/c12
カテゴリを選択してください:
[1] library/c12 (推奨)
[2] typescript
[3] testing
[4] カスタム入力
> 1
=== Phase 3: マークダウン生成 ===
ファイル名: c12-environment-config-override.md
# c12の環境別設定オーバーライド
## 概要
c12を使用して環境ごとに異なる設定を適用する方法...
=== Phase 4: ユーザー確認 ===
[プレビュー表示]
操作を選択:
[1] 承認して保存
[2] 内容を修正
[3] キャンセル
> 1
=== Phase 5: 保存・Push ===
ファイル作成: /Users/ushironoko/.../learn/src/library/c12/c12-environment-config-override.md
git add完了
git commit完了: "Add: c12の環境別設定オーバーライド"
git push完了
✓ 学びをlearnリポジトリに保存しました