语轨 TalkTrack

主题

换一个 AI 教练 ​

默认的复盘风格不喜欢？想让 AI 只挑语法错误、或者按你自己的偏好来评？没问题，自己写一份就行。

📖 第一次写 Skill？ 强烈建议先看 从零写一个分析模板——一篇带你从「我想要什么」到「上传成功」全流程的实战手册。 这篇文档是功能参考：上传操作、字段格式、错误码速查。

简单说 ​

TalkTrack 的复盘报告由一个叫 Skill 的小文件控制 — 你可以理解成「告诉 AI 该怎么写复盘的指令书」。

我们提供一份默认的 Skill（叫 meeting-review），从语法、地道度、用词、流畅度四个维度给你打分。如果你不喜欢这种风格，写一份 .md 文件传上去就能换一个 AI 教练，不需要重装 app。

上传自定义 Skill（v0.5.0-beta.2 起） ​

1. 写一份 Skill 文件 ​

新建一个 .md 文件，比如想要一个「只挑语法错误」的 AI 教练，叫 my-grammar-coach.md：

markdown
---
id: my-grammar-coach
name: 仅语法纠错
description: 只挑语法错误，不评流畅度
author: Me
version: "1.0"
tags: [grammar]
---

请仅针对 [ME] 的发言中的**语法错误**给出 markdown 报告：

会议对话：
{{FULL_TRANSCRIPT}}

# 语法错误列表

| 原文 | 错误类型 | 改写 |
|---|---|---|
| ... | ... | ... |

2. 在 app 里上传 ​

打开 TalkTrack → 设置 → 分析模板 section → 点 上传 .md 模板 → 选刚才的文件。

上传成功后会立即出现在列表里，可以**点「设为默认」**让以后所有新会议都用它。

3. 临时切换（不改默认） ​

进会议详情页 → 「分析模板」下拉框 → 选要用的模板 → 点「生成报告」。 切换只对当次有效，下次进新会议还是用 default。

frontmatter 字段说明 ​

yaml
---
id: my-skill              # 必填，alphanumeric + dash，1-50 字符
name: 显示名               # 必填
description: 描述           # 必填
author: Me                # 可选
version: "1.0"            # 可选
tags: [tag1, tag2]        # 可选，方便分类
---

id 规则：

  • 只能包含字母、数字、-（短横线）
  • 不能用 _ 下划线、空格、中文
  • 不能以 - 开头或结尾
  • 不能跟内置模板冲突（目前内置 id：meeting-review）

可以用的占位符 ​

写 Skill 的时候，下面这些占位符会被自动替换成真实内容：

占位符替换成什么
完整对话（按时间排好，[ME] 是你说的、[THEM] 是对方说的）
仅你的发言
仅对方发言
会议时长、日期、来自哪个会议软件
你讲了多少词、Filler 数量等
报告语言（默认 zh-CN）

正文必须至少含一个占位符（ / / 任选其一），否则上传时会被拒绝——没有占位符的 prompt 拿不到任何会议内容，就是个静态文本，没用。

写不出满意的 prompt？

最简单的办法：先在 ChatGPT 或 Claude 里手动调试，找到能写出满意复盘的 prompt 之后，把对话部分换成 这个占位符，存成 Skill 文件再上传。

删除自定义 Skill ​

设置 → 分析模板 → 找到对应模板 → 点垃圾桶图标 → 确认删除。

注意：

  • 内置模板（meeting-review）不能删除（有保护）
  • 删除当前默认模板时，默认会自动回退到 meeting-review
  • 删除是即时的，没有撤销

上传被拒绝？ ​

按错误码查：

错误码含义修复
SKILL-001id 含非法字符或长度超限id 改成只含字母/数字/短横线，1-50 字符
SKILL-002id 跟内置模板冲突换一个 id（不要用 meeting-review）
SKILL-003frontmatter 格式异常检查是否有 id/name/description，正文是否含至少一个占位符
SKILL-004文件超过 100 KB这通常是有问题的——TalkTrack 的内置 skill 才 1.6 KB

完整错误码查询见 error-codes。

一些有意思的 Skill 想法 ​

  • 面试准备：让 AI 检查你的回答是否符合 STAR 结构（情境、任务、行动、结果）
  • 演讲教练：分析你的语速、停顿、口头禅频率
  • 商务谈判：标出你说的让步信号、试探性表达、关键立场点
  • 学术口语：检查正式度，把口头化表达改成更适合答辩、研讨的版本

写出好玩的 Skill？发邮件 hello@talktrack.cn 给我们，可能会被收录到官方推荐列表里。

进阶：手动放置文件（可选） ​

如果你想批量管理 Skill 不通过 UI 上传，也可以直接放文件：

~/Library/Application Support/com.meetingcoach.app/skills/custom/

文件名格式 {id}.md，重启 app 后会被自动加载。这条路径主要给开发者 / 高级用户用，普通用户走 UI 上传更稳妥（有 frontmatter 校验）。