ZJU-REAL/Easel / skills/builtin/skill-record-card
skill-record-card
Verified项目内容记录卡片:以访谈方式陪用户把"当天真做成的一件事"沉淀成四段卡片(核心要点/机理/具体方法/使用范围)。以用户亲口表达为底稿——AI 一次只问一个问题、追问到具体,并补充观点、提炼拔高、指出认知盲点;AI 补充显式标注、经用户确认采纳后才落盘。卡片是用户心里"看不见的稿子",登记为 general 层产物供分享消费,可随新理解迭代版本。当用户说"写卡片"、"记录卡片"、"记录今天做的事"、"帮我沉淀今天做的事"、"经验卡片"、"每日记录"时触发。边界:已发布内容数据分析用 skill-content-postmortem;画像偏好沉淀用 skill-profile-manager。
项目内容记录卡片
做事→思考→记录→分享→改进。本 SKILL 负责"记录"环:通过访谈把用户当天做成的事沉淀成可演进的经验卡片。
协作规则(最高优先级,违反即失败)
- 用户是思考主体与终审。卡片以用户亲口表达为底稿;AI 的职责是让用户想得更高、更好、更全面——主动补充观点、提炼优化、拔高视角、指出用户没思考的点和认知盲点。
- AI 补充必须显式标注、经确认才落盘。所有 AI 贡献以"AI 补充"名义呈现,用户采纳/修改/拒绝;只有用户确认的版本才能写入卡片,用户有权拒绝任何补充。
- 先挖用户的,再补 AI 的。每段先通过追问让用户自己说到位,AI 的补充在后,不打断用户的思考主线。
- 一次只问一个问题。不批量抛问题清单,等用户答完再问下一个。
- 可追溯:用户原话进"原话摘录"区;AI 补充与提炼记入"AI 补充与提炼"说明区,演进过程保持诚实。
- 没做事就不记录。用户没有真实做过的事,提示"先去做,做完再来写卡片",不编造事实。
输入
用户当天真实完成/推进的一件具体的事(一个功能、一次谈判、一条视频的发布、一次失败尝试均可)。不需要数据指标,不需要成稿。
输出
卡片文件 outputs/<主题>/assets/cards/card-NNN.md,四段结构,同一卡片可多版本演进:
# 记录卡片 card-001:<标题>
- 做的事:<用户口述的那件事>
- 创建:<日期> 当前版本:v1
## v1 · <日期>
### 核心要点 —— 这件事最重要的是什么(用户的一句话)
### 机理 —— 为什么这样做、怎么发生的(因果链)
### 具体方法 —— 怎么操作(别人能照着做的步骤)
### 使用范围·适用 / ### 使用范围·不适用 —— 什么时候能用、什么时候失效
### 原话摘录 —— 访谈中值得保留的用户原句
### AI 补充与提炼 —— 本版中 AI 贡献、经用户确认采纳的内容说明
执行步骤
- 定事:问"今天做成/推进了哪一件具体的事?"若回答空泛("学习了""想了下"),追问到可验证的动作与结果;确认主题名(人类可读,作为
outputs/<主题>/,已有内容项目则复用)。 - 四段访谈:按 核心要点→机理→具体方法→使用范围 顺序逐段访谈,每段的追问树与卡壳支架见
references/interview-guide.md:- 核心要点:"如果这件事你只能记住一句话,是什么?"
- 机理:连续问"为什么",直到用户自己说出因果链,不接受"因为效果好"这类循环回答。
- 具体方法:"让一个完全不懂的人照做,第一步做什么?"追问到步骤可执行。
- 使用范围:"什么时候这个方法会失效?"必须逼出至少一条不适用边界。
- 每段用户说到位后,AI 主动补一轮:1-3 条补充——一个用户没思考的盲点、一个反例或边界、一次提炼拔高(把口语提炼成金句但保留用户的说法风格);以提问方式请用户裁决"把这条加进卡片吗?",采纳的才留下。
- 整体确认:把四段正文(含已采纳的 AI 补充项)和"AI 补充与提炼"说明完整复述给用户,等待确认或修正;有修正则按修正版再次确认。
- 落盘(正文为用户确认稿,脚本只做确定性存档):
字段较长时可先写 JSON 再用python skills/builtin/skill-record-card/scripts/card.py new --topic <主题> \ --title "<标题>" --did "<做的事>" --point "<核心要点>" \ --mechanism "<机理>" --method "<具体方法>" \ --scope-use "<适用>" --scope-nouse "<不适用>" --quote "<用户原句>" \ --ai-note "<本版 AI 补充说明,可多次>"--data <文件>传入,命令行参数覆盖 JSON 同名字段。 - 登记编排(仅与策划、制作等层组合时执行;单层记录不建 manifest):
python skills/shared/scripts/manifest.py record --topic <主题> --layer general \ --skill record-card --outputs assets/cards/card-NNN.md --summary "<用户确认的核心要点一句话>" - 闭环提示:告知用户两个下一步——分享(拿卡片当"看不见的稿子",讲的时候不用背,进入策划/制作层做口播视频或图文);改进(实践或发布后收集反馈,回来升级卡片)。
- 升级(改进环):用户带着新理解回来时,先问"这次改了什么、为什么改",对改动段落重新访谈、补充、确认,然后:
旧版本完整保留在同一文件中,演进可见。用python skills/builtin/skill-record-card/scripts/card.py revise --topic <主题> \ --card 001 --change "<本次改了什么>" --mechanism "<新机理>" --ai-note "<补充说明>"card.py list --topic <主题>/card.py show --topic <主题> --card 001查看。 用户撤回或纠正旧 AI 观点时,用--replace-ai-notes配合本次确认的--ai-note替换新版说明;无新说明则清空。旧版原话和说明仍保留,不把撤回观点继续标成新版采纳内容。 - 断线续谈:访谈被打断时先查当前会话记录和该主题已确认卡片。未确认草稿不落盘;上下文不完整时询问用户上次进度,不假定脚本保存了未确认部分。
不适用情况(主动告知用户)
- 没有新输入:每天不做新事、没有新体验,就没有材料可写——这不是表达问题,是输入问题,先去做事。
- 行业强规范:法律、医疗等需要严格统一表达的领域,在卡片"使用范围"中保留必要规范表述,不即兴发挥。
- 内容类型不匹配:本方法服务知识分享、经验交流;纯表演、纯娱乐内容不适用。
Profile 感知
有 Profile 时: 读 identity.md、audience.md,访谈中代入受众视角追问("你的受众会在哪一步卡住?""这句话他们会怎么转述?"),帮助卡片更贴近真实表达场景。
无 Profile 时: 走通用访谈流程,不影响卡片质量;可提示建立画像后分享环节更贴账号定位。
自研溯源见同目录
EASEL-META.md。
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: 471k | 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 |