关于 discover-presentation
通过对话访谈收集演示文稿需求,并在用户确认默认摘要后,将结果写入项目目录的 DISCOVERY.json 和 PROJECT.json。适用于需要先明确受众、目标与内容偏好的演示项目。
主要功能
- 01分三轮访谈并提取结构化信息
- 02为未回答项采用默认值
- 03确认后写入项目状态文件
- 04记录语言与编辑偏好
- 05演示文案阶段运行 unslop Skill
适用场景
- 01启动新演示项目并梳理需求
- 02补全受众画像与演示目标
- 03调整已有发现状态并比较变更
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ ken-guru/ skills --skill discover-presentation安装后在 Claude Code 中输入/discover-presentation确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
DEFAULTS.mdQUESTIONS.mdRESTART-GUARD.mdWRITE_DISCOVERY.mdevals/discover-presentation.jsonscripts/presentation-theme-invalidation.mjs详细介绍
发现演示文稿需求
通过对话式访谈收集演示文稿需求。将结果写入项目文件夹中的 DISCOVERY.json 和 PROJECT.json。
输出语气
对访谈问题、假设摘要和确认提示进行轻量的自然化润色。让对话具体、亲切,但不要刻意表现热情。当记录的内容属于项目正文时,保留用户的原话,并确保 JSON 字段名和值完全准确。记录用户提出的任何编辑偏好。每个演示文稿文案阶段都必须运行独立的 unslop Skill,将其作为必需的编辑环节。
注意事项
- 只有在至少了解 4 个角色维度中的 3 个后,才能进入步骤 2——角色画像太单薄会导致幻灯片内容泛泛而谈
- 根据用户的写作方式推断语言;只有存在歧义时才明确询问
- 只有用户在步骤 2 确认默认设置摘要后,才写入 DISCOVERY.json
启动
开始之前:
- 确认项目文件夹可写;如果不可写,则中止:
❌ Cannot write to <path>。
如果 DISCOVERY.json 已存在,请读取并保留,以便比较变更。暂时不要删除任何内容。
流程
步骤 1:访谈
按照 QUESTIONS.md 中的三个轮次提问,每轮发送一条消息。从自由回答中提取结构化数据。接受不完整的回答,并使用 DEFAULTS.md 中的默认值补全其余内容。
语言检测: 根据用户的写作方式推断演示文稿使用的语言。如果用户使用挪威语,则默认使用书面挪威语。如果用户使用英语或其他语言,则使用相应语言。将检测到的语言记录在 DISCOVERY.json 中,并在后续所有阶段遵循该语言——所有生成内容(幻灯片、演讲者备注、术语表)都必须使用该语言。
进入步骤 2 前,必须完成角色画像深度部分。当至少了解 4 个深度维度(经验水平、目标、顾虑、收获)中的 3 个时,角色画像才算充分。
步骤 2:确认默认设置
写入任何文件之前,发送一次性确认摘要:
📋 Default assumptions — correct anything that doesn’t fit:
- Topic: [topic]
- Audience: [audience]
- Experience level: [experience_level]
- Goal: [goal — implement / understand]
- Concerns: [top_concerns]
- Top 3 takeaways: [top_takeaways]
- Duration: [duration]
- Occasion: [occasion]
- Language: [language]
- Presentation style: [narrative structure from DEFAULTS.md]
- Presentation Theme: [Editorial / Signal / Field Notes] ([identifier])
- Editorial preferences: [tone, preferred styles, and styles to avoid — or none]
- External Font Override: [exact family or none]
- Pagination: Yes
- Max bullet points per slide: 5–6
- Visual preference: [Picture / Diagram / None]
同时确认文件和文件夹命名:
| 文件 / 文件夹 | 默认值 |
|---|---|
| 议程 | AGENDA.md |
| 演示文稿 | PRESENTASJON.md |
| 图片 | images/ |
| 视频 | videos/ |
| 文档 | docs/ |
| 来源 | docs/sources/ |
| 主题 | themes/ |
询问:“您想使用默认名称,还是需要调整其中任何名称?”
等待用户批准或更正后,再进入步骤 3。
如果存在先前的 Discovery 状态,现在将其与已确认的值进行比较。根据实际差异,按照 RESTART-GUARD.md 执行重启保护,并选择仅主题、仅字体或通用路径。完成保护流程后,再写入新状态。
步骤 3:写入状态文件
仅在用户于步骤 2 确认默认设置后,才阅读外部指针文件 WRITE_DISCOVERY.md,以了解后续步骤。