从零写一个分析模板
看完这一篇，你就能从「我想要 AI 这样分析我」一直走到「在 TalkTrack 里点一下用上它」。
全程不需要会编程，只要会写 markdown 和让 ChatGPT 帮忙。
在开始之前
如果你只想知道已经写好的 .md 文件怎么传上去、或者占位符列表 / 错误码这些参考性内容，看 换一个 AI 教练 就够了。
这篇是实战手册——给那些"我有想法但不知道从哪下手"的人。
一、先想清楚：你想让 AI 帮你做什么
写一个好用的 Skill，最难的不是写 markdown，是想清楚自己到底要什么。
下面 3 个问题问自己一遍，写下来：
问题 1：复盘后我最想看到什么？
不要写「都想看」——挑一件真正能让你下次开会改进的事。例子：
| 你的目标 | Skill 该输出什么 |
|---|---|
| 「我开会时表达太啰嗦」 | 把我每段长发言改写成 3 句以内的简练版本 |
| 「我紧张时语法全错」 | 列出我犯的语法错（按 时态 / 介词 / 主谓一致 分类） |
| 「我想抄对方的地道表达」 | 提取对方说的所有 idiom / collocation，标注什么场合用 |
| 「我想模仿外企开会风格」 | 标出对方用的 hedging（"I'd say"）、softener（"perhaps"）等职场用语 |
| 「面试时我答得不结构化」 | 检查我每个回答是否符合 STAR（情境-任务-行动-结果）结构 |
写下你的：「这次我最想看到 ____」
问题 2：AI 应该用什么口气
教练？严师？朋友？这会影响 Skill 输出的语气。
- 「专业严谨」→ 适合面试 / 演讲场景，AI 该指错就指
- 「鼓励为主」→ 刚开始练习不容易坚持，需要正反馈
- 「直白吐槽」→ 已经是中高级水平，需要被戳破舒适区
- 「同事 review」→ 像组里 native 同事帮你看 PR 一样的口气
问题 3：报告长什么样
想象你开完会拿到这份报告——它应该是什么样子的？纯表格？一段话总结 + 例子？分几个 section？
提前画一下结构（哪怕脑子里），不然 AI 容易写散。
二、写 prompt 的三步法
不要直接动 .md 文件
先在 ChatGPT / Claude 里跑通，确认输出符合预期，再贴成 Skill。否则你 debug Skill 的时间会是 debug prompt 的 5 倍。
步骤 1：拿一段真实会议转写做实验
打开 TalkTrack → 任一已转写完的会议 → 复制 transcript（暂时还没"导出转写"按钮的话，从「转写」标签页手动复制几段）。
如果还没有真实数据，用这段假的也行：
[ME] So, I think we should... uh... maybe consider, you know, like, a different approach?
[THEM] What kind of approach are you thinking?
[ME] Like, for the customer onboarding, instead of doing it all in one go, we can break it into phases.
[THEM] OK, that sounds reasonable. Let's circle back on that next week.步骤 2：去 ChatGPT/Claude 里手动调试 prompt
打开 chatgpt.com 或 claude.ai，开个新对话，把刚才的转写贴进去，加上你想要的指令。比如：
下面是我的会议转写。请只看 [ME] 部分，列出我的语法错误（最多 5 条），每条按这个格式给：
| 原句 | 错误类型 | 改写 |
[ME] So, I think we should... uh... [THEM] What kind of approach... ...
让 AI 输出，反复改你的指令直到输出符合你的期待。这一步可能花 20-30 分钟，是写 Skill 最有价值的部分——因为这就是 Skill 的内核。
步骤 3：把会议转写换成占位符
调通的 prompt 里，把那段贴进去的转写整段替换成 占位符。
举例——调通的 prompt 是：
请只看 [ME] 部分，列出我的语法错误...
下面是我的会议转写：
[ME] So, I think we should...
[THEM] What kind of approach...替换后：
请只看 [ME] 部分，列出我的语法错误...
下面是我的会议转写：
{{FULL_TRANSCRIPT}}这就是 Skill 的正文部分。
三、套上 frontmatter 头部
Skill 文件比纯 prompt 多一段 YAML frontmatter（开头那块）。你只需要照着复制改：
---
id: my-grammar-coach
name: 仅语法纠错
description: 只看 [ME] 部分的语法错误
author: Me
version: "1.0"
tags: [grammar]
---
请只看 [ME] 部分，列出我的语法错误（最多 5 条），每条按这个格式给：
| 原句 | 错误类型 | 改写 |
|---|---|---|
下面是我的会议转写：
{{FULL_TRANSCRIPT}}字段含义：
| 字段 | 必填 | 说明 |
|---|---|---|
id | ✅ | 文件唯一标识。只用字母、数字、-（不能用 _ 下划线、空格、中文），1-50 字符 |
name | ✅ | 在 Settings 里显示的名字，可以是中文 |
description | ✅ | 一句话说明这个模板的用途 |
author | 可选 | 你自己；将来分享时知道是谁写的 |
version | 可选 | 自己迭代时改；如 "1.1" |
tags | 可选 | 给将来分类用 |
保存：把整段贴进任何文本编辑器（VS Code / Sublime / 系统记事本都行），保存成 my-grammar-coach.md。
文件名和 id 应该一致
推荐 文件名 = id + .md——比如 id 是 my-grammar-coach，文件名就 my-grammar-coach.md。 （实际上传时 TalkTrack 以 frontmatter 的 id 为准，不看文件名，但保持一致便于自己管理。）
四、上传到 TalkTrack
- 打开 TalkTrack → 设置 → 找到 「分析模板」 section
- 点右上 「上传 .md 模板」 按钮
- 选刚才保存的
.md文件 - 上传成功 → 列表立刻出现你的模板
如果上传失败，按错误码排查：
| 错误码 | 含义 | 修复 |
|---|---|---|
| SKILL-001 | id 含非法字符 | 改成只含字母/数字/短横线 |
| SKILL-002 | id 跟内置冲突 | 不要用 meeting-review，换一个 |
| SKILL-003 | frontmatter 不规范 | 检查是否含 id / name / description；正文是否含至少一个占位符 |
| SKILL-004 | 文件 > 100 KB | 检查是否塞了不必要的内容 |
完整错误码见 error-codes。
五、设为默认 + 临时切换
设为默认
Settings → 分析模板 → 找到你刚上传的 → 点 「设为默认」。 之后所有新会议的「生成报告」都会用这个模板。
临时切换（不改默认）
进任意会议详情页 → 在「待生成报告」面板有个「分析模板」下拉框 → 选你想用的 → 点「生成报告」。 这次切换只对当次有效，下次进新会议还是用默认的。
六、可以用的占位符
写正文时，下面这些占位符会被自动替换成真实会议数据。正文必须至少含一个（否则 AI 拿不到任何会议内容，等于在生成静态文本）。
| 占位符 | 替换成什么 | 什么时候用 |
|---|---|---|
| 完整对话（按时间轴排好，[ME] 是你、[THEM] 是对方） | 大多数情况——AI 看完整上下文判断 |
| 仅你的发言 | 只想分析自己（如语法纠错） |
| 仅对方发言 | 提取对方好表达、不分析自己 |
| 会议时长、日期、来自哪个 app | 报告里展示元信息 |
| 你说了多少词、Filler 数量等 | 给你看「你说了 23 次 you know」这种统计 |
| 报告语言（默认 zh-CN） | 让 AI 选输出中文还是英文 |
七、迭代的 SOP
写好的 Skill 几乎不会一次到位。下面是迭代节奏：
第 1 版：跑 1 场会议 → 看输出
跑完不要急着改。先问自己：
- 输出有没有把我最想看的东西讲到？
- 报告长度合适吗？太长读不下去、太短没干货？
- 格式清晰吗？markdown 表格 / 列表 / 代码块用得对吗？
第 2 版：改 prompt，bump version 到 "1.1"
回到 ChatGPT/Claude 调 prompt，确认改动有效后，更新 .md 文件的正文 + version 字段。
重新上传同 id —— TalkTrack 会自动覆盖原有版本（不报错）。
第 3 版：跑 3-5 场会议看一致性
不同会议长度 / 内容会让 AI 输出风格不稳。如果你发现「短会议时模板效果差」、「会议里有大量讨论时跑不动」，说明 prompt 还不够鲁棒，再回 ChatGPT/Claude 找 corner case 调。
v2.0：加入更复杂的逻辑
调通后可以加：
- 「如果 [ME] 发言不到 5 句，跳过 X 部分」
- 「优先报告 advanced grammar 错误，B1 级别错误（如冠词）只列总数」
- 多个 section 之间用
---分隔，结构化输出
八、灵感库：8 个值得偷的 Skill 想法
直接拿去改 prompt：
1. 面试 STAR 检查
检查我的每个回答是否符合 STAR（情境-任务-行动-结果）结构。
对没满足的回答，标出**缺哪一环**并给一句重写示范。2. 演讲教练
分析我的语速变化（开头/中段/结尾）、停顿合理性、口头禅频率。
按 1-10 分给每个维度打分，给出最有效的 3 条改进建议。3. 商务谈判信号识别
标出我说的让步信号（如 "we could possibly..."）、试探性表达（"what if..."）、
关键立场点（"we cannot..."），分析对方接收到的暗示是什么。4. 学术口语正式度
找出我说的口头化表达（如 "yeah" "you know" "kinda"），
给出适合答辩 / 学术研讨场景的更正式版本。5. 主动 vs 被动语态分析
统计我用主动语态 vs 被动语态的比例，列出值得改成主动语态的句子。
被动语态过多容易显得回避责任，主动语态显得有 ownership。6. 跨文化沟通陷阱
找出我说的可能造成 cross-cultural misunderstanding 的表达
（直接 disagree 而没 hedging、批评太直接、夸奖过度等），
按文化差异程度排序。7. 会议主持人技能
我作为主持人开会议时，分析我：
- 是否有清晰的 agenda 引导
- 是否给每个人足够发言时间
- 是否在跑题时及时拉回
- 是否在结尾有清晰的 action items 总结8. 跟读对照
从对方发言里挑 5 个**最值得我学**的英文表达（地道度高、场景适用）。
每条给：原句 / 中文释义 / 拟使用场景 / 跟我之前类似表达的对比。九、常见疑问
Q1：能让 AI 看到不止当前这次会议吗？比如和上次对比
v0.5 暂时不行——目前每次「生成报告」都是独立的 LLM 调用，AI 只看 这一场的内容。 v2.0 错题本上线后会把「跨场对比」做进去——届时会有新占位符如 。
Q2：能用英文写 prompt 吗？
可以——只是 frontmatter 的 name 用英文你 Settings 里看到的就是英文。但 LLM 输出会跟你 prompt 的语言走，如果你想报告是中文，显式在 prompt 里写「请用中文输出报告」。
Q3：上传后 AI 报告变差了，怎么回滚？
最简单的方法：把内置 meeting-review 设为默认就回到了官方版本。你的 custom skill 仍在列表里，可以改完再切回。
Q4：写好的 Skill 怎么分享给朋友？
把 .md 文件发给他，让他在 Settings 里上传就行。前提是他用相同的占位符（你的 在他那里也会自动填上他的转写）。
Q5：我写了一个超级好用的 Skill，能贡献给官方吗？
🎉 太好了。发邮件到 hello@talktrack.cn，附上 .md 文件 + 设计意图说明。 被收录后会出现在未来的「官方推荐模板库」里，你可以选择用真名或匿名作者。
下一步
- 写好第一版 → 上传到 TalkTrack
- 看看默认 Skill 怎么写的（找灵感）→ 在你 Mac 上路径：
~/Library/Application Support/com.meetingcoach.app/skills/built-in/meeting-review.md - 遇到问题 → 邮件 hello@talktrack.cn，附上你的 .md 文件，我帮你看