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. 创建突破文件

使用今天的日期,以及根据突破内容提炼的简洁 kebab-case 名称,在 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. 提取可复用模式

记录后,帮助用户识别:

  • 此模式是否适用于代码库的其他部分?
  • 能否将其转化为 lint 规则、测试或自动化检查?
  • 是否应该与团队分享?

核心原则

  • 快速行动:趁上下文尚新鲜时捕获洞见——初次记录时不要过度润色。
  • 具体明确:包含具体指标、错误消息和代码。模糊的突破无法复用。
  • 考虑复用:始终从具体解决方案中提炼出可泛化的模式。
  • 便于搜索:使用一致的标签和清晰的标题,方便日后查找突破记录。

你的任务

根据用户的描述记录突破:

  1. 如果描述清楚,直接创建突破文件
  2. 如果缺少细节,先提出有针对性的澄清问题
  3. 创建文件、更新索引,并指出可复用模式

评论

支持 Markdown