ZJU-REAL/Easel / skills/builtin/skill-record-card
skill-record-card
Verified项目内容记录卡片:以访谈方式陪用户把"当天真做成的一件事"沉淀成四段卡片(核心要点/机理/具体方法/使用范围)。以用户亲口表达为底稿——AI 一次只问一个问题、追问到具体,并补充观点、提炼拔高、指出认知盲点;AI 补充显式标注、经用户确认采纳后才落盘。卡片是用户心里"看不见的稿子",登记为 general 层产物供分享消费,可随新理解迭代版本。当用户说"写卡片"、"记录卡片"、"记录今天做的事"、"帮我沉淀今天做的事"、"经验卡片"、"每日记录"时触发。边界:已发布内容数据分析用 skill-content-postmortem;画像偏好沉淀用 skill-profile-manager。
| File | Kind | Size |
|---|---|---|
| EASEL-META.md | markdown | 1.5 KB |
| SKILL.md | skill md | 7.1 KB |
| references/interview-guide.md | markdown | 6.2 KB |
| scripts/card.py | script | 21.2 KB |
| tests/test1.expected | other | 95 B |
| tests/test1.prompt | other | 79 B |
references/interview-guide.md
View on GitHub# 访谈技巧库 — 把用户的思考逼出来,再帮他想得更高更全面
> 本文件是 `skill-record-card` 的领域知识,访谈中按需查阅。
> 核心立场:用户是思考主体与终审,AI 是访谈者 + 顾问——
> 先通过追问让用户自己把模糊的感觉说成清晰的结构,
> 再主动补充观点、提炼拔高、指出盲点,经用户确认采纳后进入卡片。
## 方法论依据(访谈设计为什么这么定)
- **背稿讲不好**:背稿说明还没真正理解。不懂的人靠记忆,眼神不自然、声音紧张;
真懂的人心里有框架,随机应变,像聊天。卡片的四段结构就是"心里的框架"——
所以访谈必须让用户自己把框架说出来,AI 代写的框架用户背不下来也用不上。
- **网红 2-3 年就凉的原因**:把拍视频当全部工作、每天追流量,没有积累,每条重新想,
内容不进步。卡片是积累层:每次讲同一个话题,卡片先升级,内容自然升级。
- **没话可说的真正原因**:不是不会说,是没在做新事。所以"定事"环节必须是
真实发生的事,不接受空想。
## 通用访谈规则
1. 一次只问一个问题,等回答再追问。
2. 用户答得笼统时,用"具体是……?"收窄,先让用户自己说到位。
3. 用户说出金句时原样记下,放进"原话摘录"。
4. 每段用户说到位后做一次小镜像:"这段我理解成……,是你的意思吗?"
5. 镜像确认后,进入 AI 补充环节(见下节),补充采纳与否由用户裁决。
6. 用户卡壳时先给支架(提问角度),再给示范答案,但示范也要经用户认可改写后才算数。
## AI 补充与拔高的方式(每段用户说完后进行)
每段给 1-3 条补充,以提问方式请用户裁决("把这条加进卡片吗?"):
- **补盲点**:"你有没有考虑过……(反例/边界/代价)?"——指出用户没思考到的点。
- **提炼拔高**:把用户的口语表达向上抽象一层,提炼成金句或模型,
但保留用户的用词风格,不引入用户不认可的新立场。给用户看两个版本:原话版、提炼版。
- **连认知**:把这张卡片和用户已知的更大框架连起来("这其实就是复利/飞轮/边际成本"),
帮用户看清自己的经验在更大图景中的位置。
裁决规则:采纳 → 进入正文,并记一条"AI 补充与提炼"说明;修改 → 按用户改后的版本进正文;
拒绝 → 不进卡片、不留痕。正文必须始终是用户认可的表达。
## 分段时间与追问树(全程约 30 分钟)
### 0. 定事(约 5 分钟)
- 开场:"今天做成或推进了哪一件具体的事?"
- 收窄空泛回答:
- "学习了 XX" → "学完之后你动手做了什么?做出了什么?"
- "想了下方案" → "想出了什么结论?写在哪儿了?下一步动作是什么?"
- 验证真实性:"如果让你现在演示/展示一下,能拿出什么?"
- 拿不出任何痕迹 → 建议先去做事,今天不记录。这是帮用户,不是刁难。
### 1. 核心要点(约 5 分钟)
- 首问:"如果这件事你只能记住一句话,是什么?"
- 追问:
- "这句话里哪个词最关键?换成别的词行不行?"
- "如果只能讲给昨天的自己听,你会怎么说?"
- 卡壳支架:"做完这件事,你和昨天相比多会了什么?"
- 合格标准:一句话,具体,没有"很重要""很有意思"这类空词。
### 2. 机理(约 8 分钟,最难也最重要)
- 首问:"为什么这样做是有效的?它是怎么发生的?"
- 连续问为什么,沿着因果链往下挖,直到用户能说出 A→B→C 的链条。
- 拒绝循环回答:"因为效果好" → "效果为什么好?中间发生了什么?"
- 区分相关与因果:"是它的功劳,还是恰好那天的热点/时间/运气?"
- 卡壳支架:"如果反过来做,会发生什么?为什么会那样?"
- 合格标准:有一条用户自己认可的因果链,能说清"因为…所以…"。
### 3. 具体方法(约 7 分钟)
- 首问:"让一个完全不懂的人照着做,第一步做什么?第二步呢?"
- 追问:
- "这一步容易做错的地方是什么?你当时怎么发现的?"
- "做这一步需要什么前提/工具/材料?"
- 卡壳支架:"把你自己昨天到现在的动作按顺序回忆一遍,哪几步是关键?"
- 合格标准:步骤可执行、有顺序、有易错点提示;别人看完能动手。
### 4. 使用范围(约 5 分钟,必须逼出边界)
- 首问:"什么时候这个方法能用?什么时候会失效?"
- 必须至少问出一条不适用边界:
- "如果条件 X 不成立,还能用吗?"
- "你这个方法对新手和老手一样有效吗?对别的领域呢?"
- 用户说"什么时候都能用" → 追问:"那你觉得哪种人用它反而会搞砸?"
- 强规范行业(法律/医疗等):此段必须保留必要规范表述,提醒用户边界就是合规线。
- 合格标准:适用、不适用各至少一条,且具体(有条件,不是"看情况")。
## 镜像确认话术
- 小镜像(每段):"我复述一下你刚才的意思:……。这是我的理解,你的原意是这样吗?"
- AI 补充呈现:"你刚才说的我提炼成一句话:……(提炼版)。另外我有一个补充:……(盲点/反例)。这两条要进卡片吗?"
- 总镜像(落盘前):把四段完整读给用户,标明哪些是用户原话、哪些是已采纳的 AI 补充,
问"有没有要改的?哪句不像你会说的话?"
- 用户指出"这句不像我说的" → 立刻换回用户原话。
- 确认后才允许调用 `card.py` 落盘。
## 升级访谈(revise 时专用)
- 首问:"这次改了什么?为什么改?"
- 定位版本:"是上次说错了,还是这阵子又有新理解?"(说错→修正;新理解→演进,都值得记)
- 只重访变动的段落,其余段落从上一版继承。
- 变动段落同样先挖用户、再补 AI,新采纳的补充追加进"AI 补充与提炼"说明。
- 变更说明用用户自己的话写:"这次改动机理,因为我发现……"
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |