关于 structure-agenda
用于协作制定和完善 `AGENDA.md` 的演示文稿规划 Skill。它根据 `DISCOVERY.json` 提出不同议程结构,并在用户选择后再起草内容。
主要功能
- 01检查项目写入权限和发现数据
- 02提出 2–3 种议程结构
- 03获批后才写入文件
- 04执行必需的 `unslop` 编辑流程
适用场景
- 01为演示文稿选择叙事结构
- 02在保留已批准措辞的同时完善议程
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ ken-guru/ skills --skill structure-agenda安装后在 Claude Code 中输入/structure-agenda确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
DEFAULTS.mdDRAFT_AGENDA.mdITERATION.mdRESTART-GUARD.mdevals/structure-agenda.json详细介绍
构建议程
通过与用户协作迭代,构建并完善 AGENDA.md。
输出语气
对议程方案、叙事说明和协作提示进行轻量的人工语气润色。Presentation 内容应简洁具体,保留用户期望的语气;不要仅仅为了让内容听起来更口语化,就改写已获批准的措辞。在编写或更新 AGENDA.md 之前,必须调用独立的 unslop Skill,对可编辑的议程文本进行完整的编辑润色,并使用 DISCOVERY.json.editorialPreferences。在保护检查和偏好扫描完成之前,不得视为润色已完成。
注意事项
- 只有在用户明确批准后才能写入 AGENDA.md——过早写入会导致每次后续迭代都触发重启保护
- 用户说“更新一张幻灯片”时,只迭代内存中的草稿;只有获得批准后才能写入磁盘
- 每张图片都必须明确指定预期媒体方向(
Portrait或Landscape)
启动
继续之前:
- 确认项目文件夹可写;如果不可写,则中止:
❌ 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,了解起草和编写议程的说明。