mcpField
S
structure-agenda

structure-agenda

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

关于 structure-agenda

用于协作制定和完善 `AGENDA.md` 的演示文稿规划 Skill。它根据 `DISCOVERY.json` 提出不同议程结构,并在用户选择后再起草内容。

主要功能

  1. 01检查项目写入权限和发现数据
  2. 02提出 2–3 种议程结构
  3. 03获批后才写入文件
  4. 04执行必需的 `unslop` 编辑流程

适用场景

  1. 01为演示文稿选择叙事结构
  2. 02在保留已批准措辞的同时完善议程

安装

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

$npx skills add https://github.com/ken-guru/skills --skill structure-agenda

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

包含的文件

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

DEFAULTS.md
DRAFT_AGENDA.md
ITERATION.md
RESTART-GUARD.md
evals/
structure-agenda.json

详细介绍

构建议程

通过与用户协作迭代,构建并完善 AGENDA.md。

输出语气

对议程方案、叙事说明和协作提示进行轻量的人工语气润色。Presentation 内容应简洁具体,保留用户期望的语气;不要仅仅为了让内容听起来更口语化,就改写已获批准的措辞。在编写或更新 AGENDA.md 之前,必须调用独立的 unslop Skill,对可编辑的议程文本进行完整的编辑润色,并使用 DISCOVERY.json.editorialPreferences。在保护检查和偏好扫描完成之前,不得视为润色已完成。

注意事项

  • 只有在用户明确批准后才能写入 AGENDA.md——过早写入会导致每次后续迭代都触发重启保护
  • 用户说“更新一张幻灯片”时,只迭代内存中的草稿;只有获得批准后才能写入磁盘
  • 每张图片都必须明确指定预期媒体方向(Portrait 或 Landscape)

启动

继续之前:

  1. 确认项目文件夹可写;如果不可写,则中止: ❌ Cannot write to <path>。

检查项目文件夹中是否存在 DISCOVERY.json。如果不存在:

❌ 未找到 DISCOVERY.json。请先运行 discover-presentation。 中止。

读取 DISCOVERY.json,加载主题、受众、时长、语言和场合。

如果下游文件已存在(检查项目文件夹中是否有 IMAGE_SPEC.md 或 PRESENTASJON.md),则在继续之前,按照 RESTART-GUARD.md 对阶段 structure-agenda 运行重启保护。

流程

步骤 1:提出议程方案

根据发现数据,生成 2–3 种截然不同的议程结构。参考 DEFAULTS.md,并根据具体主题、受众和场合进行调整。

每种方案都要提供:

  • 简短标签
  • 叙事弧线(3–5 个阶段,每个阶段用一行描述)
  • 一句话说明理由

示例格式:

A) **Problem → Solution → Demo → Implications** (classic technical)
   Starts with the pain the audience knows, builds to the "aha" moment, ends with "what now"

B) **Demo-first → Background → Deeper concepts → Next steps** (show, don’t tell)
   Captures attention immediately — explains "why" after "wow"

C) **Story → Concepts → Exercise → Takeaways** (workshop style)
   Best when the audience wants hands-on experience rather than passive listening

询问用户:

“哪种结构最符合您的想法?或者您想结合多个方案中的元素?”

等待用户选择,然后再起草完整的逐页大纲。

步骤 2:起草完整议程大纲

只有在用户选择议程方案之后,才阅读外部指引文件 DRAFT_AGENDA.md,了解起草和编写议程的说明。

评论

支持 Markdown