mcpField
E
eureka

eureka

github.com/feiskyer生産性1.7k117 回インストール4 週間前に更新
リポジトリ

eureka について

技術的なブレークスルーを、検索可能な Markdown ノートと再利用できるパターンにまとめるスキルです。問題や気づき、変化を記録し、日付付きファイルと索引を作成します。

主な機能

  1. 01問題、気づき、変化の記録
  2. 02最小限の実行例の確認
  3. 03日付付きノートの作成
  4. 04新しい順で索引を更新
  5. 05再利用可能なパターンの抽出

活用シーン

  1. 01文脈が新しいうちに解決策を記録
  2. 02検索可能な技術知見の蓄積
  3. 03テストや自動化に適したパターンの特定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/feiskyer/claude-code-settings --skill eureka

インストール後、Claude Code で/eurekaを入力して読み込まれたか確認します。

詳細

Eureka

技術的なブレークスルーを記録し、状況を覚えているうちに、実用的で再利用可能な知識資産へと変換します。

プロセス

1. ブレークスルーを記録する

呼び出されたら、すぐに重要な詳細を収集します。

  • どのような問題でしたか? 直面した具体的な課題や障害。
  • どのような気づきがありましたか? 解決の糸口となった重要な発見。
  • 何が変わりましたか? 具体的な変更点(指標、動作、コード)。
  • 最小限の実行可能な例はありますか? 提示されていない場合は、例を求めてください。

不明な点があれば確認の質問をします。ただし、状況を覚えているうちに記録するため、迅速に対応してください。

2. ブレークスルーファイルを作成する

今日の日付を使い、ブレークスルーの内容から簡潔なケバブケース名を付けて、breakthroughs/YYYY-MM-DD-[brief-name].md に構造化された Markdown ファイルを作成します。

次のテンプレートを使用してください。

# [Descriptive Title]

**Date**: YYYY-MM-DD
**Tags**: [relevant, searchable, tags]

## One-Line Summary

A single sentence capturing the core insight.

## The Problem

What was the challenge? What wasn't working? Include specific error messages, performance numbers, or behavioral descriptions.

## The Insight

The key realization or discovery. What made this non-obvious? Why did previous approaches fail?

## Implementation

Minimal working code demonstrating the solution:

\`\`\`[language]
# concrete code example
\`\`\`

## Impact

| Metric | Before | After |
|--------|--------|-------|
| [relevant metric] | [value] | [value] |

## Reusable Pattern

Abstract the specific solution into a general principle that can be applied elsewhere:

- **When you see**: [symptom or situation]
- **Consider**: [the general approach]
- **Because**: [why it works]

## Related Resources

- Links to relevant documentation, issues, or discussions
3. インデックスを更新する

breakthroughs/INDEX.md に新しい項目を追加します。インデックスファイルが存在しない場合は、次の構成で作成してください。

# Breakthrough Index

| Date | Title | Tags | Link |
|------|-------|------|------|
| YYYY-MM-DD | [Title] | [tags] | [link to file] |

項目を新しい順に並べ、テーブルに新しい項目を追加します。

4. 再利用可能なパターンを抽出する

記録した後、次の点をユーザーと一緒に検討します。

  • このパターンはコードベース内のほかの箇所にも適用できますか?
  • リントルール、テスト、自動チェックにできますか?
  • チームで共有すべきですか?

重要な原則

  • 迅速に対応する:状況を覚えているうちに気づきを記録します。最初から過度に仕上げようとしないでください。
  • 具体的にする:具体的な指標、エラーメッセージ、コードを含めます。曖昧なブレークスルーは再利用できません。
  • 再利用を意識する:個別の解決策から、一般化できるパターンを必ず抽出します。
  • 検索しやすくする:ブレークスルーを後から見つけられるよう、一貫性のあるタグと明確なタイトルを使用します。

タスク

ユーザーの説明に基づいてブレークスルーを記録します。

  1. 説明が明確であれば、すぐにブレークスルーファイルを作成します
  2. 情報が不足している場合は、まず要点を絞った確認の質問をします
  3. ファイルを作成し、インデックスを更新して、再利用可能なパターンを強調します

コメント