---
name: skill-record-card
description: >-
  项目内容记录卡片：以访谈方式陪用户把"当天真做成的一件事"沉淀成四段卡片（核心要点/机理/具体方法/使用范围）。以用户亲口表达为底稿——AI 一次只问一个问题、追问到具体，并补充观点、提炼拔高、指出认知盲点；AI 补充显式标注、经用户确认采纳后才落盘。卡片是用户心里"看不见的稿子"，登记为 general 层产物供分享消费，可随新理解迭代版本。当用户说"写卡片"、"记录卡片"、"记录今天做的事"、"帮我沉淀今天做的事"、"经验卡片"、"每日记录"时触发。边界：已发布内容数据分析用 skill-content-postmortem；画像偏好沉淀用 skill-profile-manager。
layer: general
---

# 项目内容记录卡片

> 做事→思考→记录→分享→改进。本 SKILL 负责"记录"环：通过访谈把用户当天做成的事沉淀成可演进的经验卡片。

## 协作规则（最高优先级，违反即失败）

1. **用户是思考主体与终审**。卡片以用户亲口表达为底稿；AI 的职责是让用户想得更高、更好、更全面——主动补充观点、提炼优化、拔高视角、指出用户没思考的点和认知盲点。
2. **AI 补充必须显式标注、经确认才落盘**。所有 AI 贡献以"AI 补充"名义呈现，用户采纳/修改/拒绝；只有用户确认的版本才能写入卡片，用户有权拒绝任何补充。
3. **先挖用户的，再补 AI 的**。每段先通过追问让用户自己说到位，AI 的补充在后，不打断用户的思考主线。
4. **一次只问一个问题**。不批量抛问题清单，等用户答完再问下一个。
5. **可追溯**：用户原话进"原话摘录"区；AI 补充与提炼记入"AI 补充与提炼"说明区，演进过程保持诚实。
6. **没做事就不记录**。用户没有真实做过的事，提示"先去做，做完再来写卡片"，不编造事实。

## 输入

用户当天真实完成/推进的一件具体的事（一个功能、一次谈判、一条视频的发布、一次失败尝试均可）。不需要数据指标，不需要成稿。

## 输出

卡片文件 `outputs/<主题>/assets/cards/card-NNN.md`，四段结构，同一卡片可多版本演进：

```markdown
# 记录卡片 card-001：<标题>
- 做的事：<用户口述的那件事>
- 创建：<日期>  当前版本：v1
## v1 · <日期>
### 核心要点      —— 这件事最重要的是什么（用户的一句话）
### 机理          —— 为什么这样做、怎么发生的（因果链）
### 具体方法      —— 怎么操作（别人能照着做的步骤）
### 使用范围·适用  /  ### 使用范围·不适用 —— 什么时候能用、什么时候失效
### 原话摘录      —— 访谈中值得保留的用户原句
### AI 补充与提炼  —— 本版中 AI 贡献、经用户确认采纳的内容说明
```

## 执行步骤

1. **定事**：问"今天做成/推进了哪一件具体的事？"若回答空泛（"学习了""想了下"），追问到可验证的动作与结果；确认主题名（人类可读，作为 `outputs/<主题>/`，已有内容项目则复用）。
2. **四段访谈**：按 核心要点→机理→具体方法→使用范围 顺序逐段访谈，每段的追问树与卡壳支架见 `references/interview-guide.md`：
   - 核心要点："如果这件事你只能记住一句话，是什么？"
   - 机理：连续问"为什么"，直到用户自己说出因果链，不接受"因为效果好"这类循环回答。
   - 具体方法："让一个完全不懂的人照做，第一步做什么？"追问到步骤可执行。
   - 使用范围："什么时候这个方法会失效？"必须逼出至少一条不适用边界。
   - **每段用户说到位后，AI 主动补一轮**：1-3 条补充——一个用户没思考的盲点、一个反例或边界、一次提炼拔高（把口语提炼成金句但保留用户的说法风格）；以提问方式请用户裁决"把这条加进卡片吗？"，采纳的才留下。
3. **整体确认**：把四段正文（含已采纳的 AI 补充项）和"AI 补充与提炼"说明完整复述给用户，等待确认或修正；有修正则按修正版再次确认。
4. **落盘**（正文为用户确认稿，脚本只做确定性存档）：
   ```bash
   python skills/builtin/skill-record-card/scripts/card.py new --topic <主题> \
     --title "<标题>" --did "<做的事>" --point "<核心要点>" \
     --mechanism "<机理>" --method "<具体方法>" \
     --scope-use "<适用>" --scope-nouse "<不适用>" --quote "<用户原句>" \
     --ai-note "<本版 AI 补充说明，可多次>"
   ```
   字段较长时可先写 JSON 再用 `--data <文件>` 传入，命令行参数覆盖 JSON 同名字段。
5. **登记编排**（仅与策划、制作等层组合时执行；单层记录不建 manifest）：
   ```bash
   python skills/shared/scripts/manifest.py record --topic <主题> --layer general \
     --skill record-card --outputs assets/cards/card-NNN.md --summary "<用户确认的核心要点一句话>"
   ```
6. **闭环提示**：告知用户两个下一步——分享（拿卡片当"看不见的稿子"，讲的时候不用背，进入策划/制作层做口播视频或图文）；改进（实践或发布后收集反馈，回来升级卡片）。
7. **升级（改进环）**：用户带着新理解回来时，先问"这次改了什么、为什么改"，对改动段落重新访谈、补充、确认，然后：
   ```bash
   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` 替换新版说明；无新说明则清空。旧版原话和说明仍保留，不把撤回观点继续标成新版采纳内容。
8. **断线续谈**：访谈被打断时先查当前会话记录和该主题已确认卡片。未确认草稿不落盘；上下文不完整时询问用户上次进度，不假定脚本保存了未确认部分。

## 不适用情况（主动告知用户）

- **没有新输入**：每天不做新事、没有新体验，就没有材料可写——这不是表达问题，是输入问题，先去做事。
- **行业强规范**：法律、医疗等需要严格统一表达的领域，在卡片"使用范围"中保留必要规范表述，不即兴发挥。
- **内容类型不匹配**：本方法服务知识分享、经验交流；纯表演、纯娱乐内容不适用。

## Profile 感知

**有 Profile 时：** 读 `identity.md`、`audience.md`，访谈中代入受众视角追问（"你的受众会在哪一步卡住？""这句话他们会怎么转述？"），帮助卡片更贴近真实表达场景。

**无 Profile 时：** 走通用访谈流程，不影响卡片质量；可提示建立画像后分享环节更贴账号定位。

> 自研溯源见同目录 `EASEL-META.md`。