关于 eureka
一个将技术突破整理为可搜索 Markdown 笔记和可复用模式的技能。它记录问题、关键发现与变化,创建带日期的文件并更新索引。
主要功能
- 01记录问题、发现与变化
- 02索取最小可运行示例
- 03创建带日期的突破笔记
- 04按时间倒序更新索引
- 05提取可复用模式
适用场景
- 01趁上下文清晰记录解决方案
- 02建立可搜索的技术经验集
- 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 规则、测试或自动化检查?
- 是否应该与团队分享?
核心原则
- 快速行动:趁上下文尚新鲜时捕获洞见——初次记录时不要过度润色。
- 具体明确:包含具体指标、错误消息和代码。模糊的突破无法复用。
- 考虑复用:始终从具体解决方案中提炼出可泛化的模式。
- 便于搜索:使用一致的标签和清晰的标题,方便日后查找突破记录。
你的任务
根据用户的描述记录突破:
- 如果描述清楚,直接创建突破文件
- 如果缺少细节,先提出有针对性的澄清问题
- 创建文件、更新索引,并指出可复用模式
评论
支持 Markdown