jpskill.com
🛠️ 開発・MCP コミュニティ

reflect-on-work

Pattern for producing quality reflections after completing work. Required for all agent outputs.

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux 
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o reflect-on-work.zip https://jpskill.com/download/17962.zip && unzip -o reflect-on-work.zip && rm reflect-on-work.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/17962.zip -OutFile "$d\reflect-on-work.zip"; Expand-Archive "$d\reflect-on-work.zip" -DestinationPath $d -Force; ri "$d\reflect-on-work.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して reflect-on-work.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → reflect-on-work フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動
⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-18
取得日時
2026-05-18
同梱ファイル
1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

作業の振り返りスキル

質の高い振り返りを作成するためのパターンです。

このスキルをロードするタイミング

  • 何らかのタスクを完了しているとき
  • 必須の振り返りフィールドを作成する必要があるとき
  • システムの進化に貢献したいとき

必須の出力フィールド

すべてのエージェントの出力には、以下のフィールドがコンパクトな JSON 形式で含まれている必要があります。

{"knowledge_updates":[{"category":"codebase","content":"What you learned","confidence":"certain"}],"reflection":{"what_worked":["string"],"what_failed":["string"],"patterns_noticed":["string"]}}

知識の更新

カテゴリ

  • codebase: 発見された構造、コンポーネント、データフロー
  • convention: コーディングスタイル、パターン、命名
  • decision: 設計の選択とその根拠
  • gotcha: 落とし穴、回避策、自明ではない動作

信頼度

  • certain: 検証済み、テスト済み、文書化済み
  • likely: 強力な証拠があるが検証されていない
  • uncertain: 観察されたが確認が必要

例

{"knowledge_updates":[{"category":"convention","content":"Project uses barrel exports in each directory","confidence":"certain"},{"category":"gotcha","content":"Must call init() before using AuthService","confidence":"certain"},{"category":"codebase","content":"API routes follow /api/v1/{resource} pattern","confidence":"likely"}]}

振り返りフィールド

what_worked

  • 成功した戦略
  • 役立ったツール
  • 繰り返す価値のあるアプローチ

what_failed

  • うまくいかなかった戦略
  • 間違ったアプローチに費やした時間
  • 発生した問題

patterns_noticed

  • 繰り返されるシーケンス（スキル候補）
  • コードベース内の共通パターン
  • ワークフローの改善

例

{"reflection":{"what_worked":["Parallel explorers found context quickly","Starting with types helped structure code"],"what_failed":["Initial approach missed edge case","Spent time on wrong file before exploring"],"patterns_noticed":["Error handling always uses Result type","Tests colocated with source files"]}}

完全な出力例

振り返りを含む最小限の有効な出力：

{"task_id":"task-001","status":"pre_complete","files_modified":[],"knowledge_updates":[],"reflection":{"what_worked":[],"what_failed":[],"patterns_noticed":[]}}

コンテンツを含む完全な出力：

{"task_id":"task-001","status":"pre_complete","files_modified":[{"path":"src/auth.ts","change_type":"modified","summary":"Added login function"}],"knowledge_updates":[{"category":"convention","content":"Auth uses JWT tokens","confidence":"certain"}],"reflection":{"what_worked":["Found existing patterns quickly"],"what_failed":["Initial test approach was wrong"],"patterns_noticed":["All services use dependency injection"]}}

原則

  • Be honest - 失敗を報告する、それらは貴重です
  • Be specific - 行動につながる洞察、曖昧ではない
  • Be brief - 簡潔、網羅的ではない
  • Use compact JSON - 単一行、フォーマットなし
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Reflect on Work Skill

Pattern for producing quality reflections.

When to Load This Skill

  • You are completing any task
  • You need to produce the mandatory reflection fields
  • You want to contribute to system evolution

Required Output Fields

EVERY agent output MUST include these fields in compact JSON:

{"knowledge_updates":[{"category":"codebase","content":"What you learned","confidence":"certain"}],"reflection":{"what_worked":["string"],"what_failed":["string"],"patterns_noticed":["string"]}}

Knowledge Updates

Categories

  • codebase: Discovered structure, components, data flow
  • convention: Coding style, patterns, naming
  • decision: Design choice and rationale
  • gotcha: Pitfall, workaround, non-obvious behavior

Confidence Levels

  • certain: Verified, tested, documented
  • likely: Strong evidence but not verified
  • uncertain: Observed but needs confirmation

Examples

{"knowledge_updates":[{"category":"convention","content":"Project uses barrel exports in each directory","confidence":"certain"},{"category":"gotcha","content":"Must call init() before using AuthService","confidence":"certain"},{"category":"codebase","content":"API routes follow /api/v1/{resource} pattern","confidence":"likely"}]}

Reflection Fields

what_worked

  • Strategies that succeeded
  • Tools that helped
  • Approaches worth repeating

what_failed

  • Strategies that didn't work
  • Time wasted on wrong approaches
  • Issues encountered

patterns_noticed

  • Repeated sequences (skill candidates)
  • Common patterns in codebase
  • Workflow improvements

Example

{"reflection":{"what_worked":["Parallel explorers found context quickly","Starting with types helped structure code"],"what_failed":["Initial approach missed edge case","Spent time on wrong file before exploring"],"patterns_noticed":["Error handling always uses Result type","Tests colocated with source files"]}}

Complete Output Example

Minimal valid output with reflection:

{"task_id":"task-001","status":"pre_complete","files_modified":[],"knowledge_updates":[],"reflection":{"what_worked":[],"what_failed":[],"patterns_noticed":[]}}

Full output with content:

{"task_id":"task-001","status":"pre_complete","files_modified":[{"path":"src/auth.ts","change_type":"modified","summary":"Added login function"}],"knowledge_updates":[{"category":"convention","content":"Auth uses JWT tokens","confidence":"certain"}],"reflection":{"what_worked":["Found existing patterns quickly"],"what_failed":["Initial test approach was wrong"],"patterns_noticed":["All services use dependency injection"]}}

Principles

  • Be honest - Report failures, they're valuable
  • Be specific - Actionable insights, not vague
  • Be brief - Concise, not exhaustive
  • Use compact JSON - Single line, no formatting