mcpField
D
discover-presentation

discover-presentation

github.com/ken-guru文档处理184 次安装1 周前更新
代码仓库

关于 discover-presentation

通过对话访谈收集演示文稿需求,并在用户确认默认摘要后,将结果写入项目目录的 DISCOVERY.json 和 PROJECT.json。适用于需要先明确受众、目标与内容偏好的演示项目。

主要功能

  1. 01分三轮访谈并提取结构化信息
  2. 02为未回答项采用默认值
  3. 03确认后写入项目状态文件
  4. 04记录语言与编辑偏好
  5. 05演示文案阶段运行 unslop Skill

适用场景

  1. 01启动新演示项目并梳理需求
  2. 02补全受众画像与演示目标
  3. 03调整已有发现状态并比较变更

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/ken-guru/skills --skill discover-presentation

安装后在 Claude Code 中输入/discover-presentation确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

DEFAULTS.md
QUESTIONS.md
RESTART-GUARD.md
WRITE_DISCOVERY.md
evals/
discover-presentation.json
scripts/
presentation-theme-invalidation.mjs

详细介绍

发现演示文稿需求

通过对话式访谈收集演示文稿需求。将结果写入项目文件夹中的 DISCOVERY.json 和 PROJECT.json。

输出语气

对访谈问题、假设摘要和确认提示进行轻量的自然化润色。让对话具体、亲切,但不要刻意表现热情。当记录的内容属于项目正文时,保留用户的原话,并确保 JSON 字段名和值完全准确。记录用户提出的任何编辑偏好。每个演示文稿文案阶段都必须运行独立的 unslop Skill,将其作为必需的编辑环节。

注意事项

  • 只有在至少了解 4 个角色维度中的 3 个后,才能进入步骤 2——角色画像太单薄会导致幻灯片内容泛泛而谈
  • 根据用户的写作方式推断语言;只有存在歧义时才明确询问
  • 只有用户在步骤 2 确认默认设置摘要后,才写入 DISCOVERY.json

启动

开始之前:

  1. 确认项目文件夹可写;如果不可写,则中止: ❌ 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,以了解后续步骤。

评论

支持 Markdown