YFan945

sp-outline

Use only for a clearly student-owned academic context when the user explicitly requests a PPT or slide outline, not an editable deck. Do not use for generic presentations, standalone scripts, Q&A-only work, or non-student tasks.

YFan945 2 Actualitzat fa 2 setm.

Recursos

1
GitHub

Instal·la

npx skillscat add yfan945/student-ppt-create/sp-outline

Instal·la des del registre de SkillsCat.

SKILL.md

Student Presentation

规划学生演示文稿,不创建 .pptx 文件。

快速约束

  • 中文正文 ≥ 22pt / 英文正文 ≥ 20pt / 标题 ≥ 24pt
  • 每页一条核心信息,≤ 4 条要点,≤ 80 中文字 / 40 英文词(引用、图表标注不计)
  • 避免 AI 套话("在当今快速发展..."、"具有重要意义...")
  • 使用具体课程/项目背景,直接主张,承认局限
  • 按目录→逐页主张→PPT文案→演讲版→Slide Spec 分层生成
  • 全程遵守 ../../references/cost-discipline.md:调用并行批量发出、禁止整文件重写、产物写盘即弃、外部检索只走 sp-research(由它显式 spawn presentation-researcher),禁止名叫 researcher 的 teammate
  • 输出写入 outputs/,不得写入 ${CLAUDE_PLUGIN_ROOT}

职责

  • 大纲、结构、讲稿 → 本 skill
  • 外部事实、数据、引用的检索与交叉验证 → sp-research(需要时先跑,再排页)
  • 可编辑 PPTX/PowerPoint 文件 → sp-deck
  • 审查/评分/诊断已有文件 → sp-review
  • 不得声称能创建 .pptx 文件

工作流

  1. 按需读一次 ../../references/presentation-intake.md,使用 outline-only 模式;提炼清单后不再重读。
  2. 按需读一次 ../../references/presentation-brief.md,分类场景、受众、结构、交互和质量模式。仅确认会影响故事/时间/证据/归属的约束。
  3. Research Need Analysis:排页前先在主流程里只做“是否需要证据”的轻量判定,把待证内容拆成 Claim 并标 A/B/C/D;这一步本身不联网。若存在 A/B Claim,则调用 sp-research;D 类不派子代理——运行 ${CLAUDE_PLUGIN_ROOT}/scripts/import_user_materials.py <材料文件...> --work-dir <wd> --spec <spec> --json 做结构化导入(sources 全为哈希绑定的 user-file、queries 为空、写 research-import.json 凭据,plan 直接接受该凭据),仅当用户点名要研究员整理时才走 sp-research scope:D。若全部是 C(仅重排/概括用户已有内容、过渡页等),不要启动子代理,也不要制造空 Research Pack。只要调用过 sp-research,必须拿到 research-pack.json + passing validation report 后才能排页。不要先写正文再补来源。
  4. 缺哪条规则再读哪份(各一次):references/slide-structures.md、references/transition-phrases.md、references/group-handoff.md、references/qa-prediction.md、../../references/content-workflow.md、../../references/evidence-and-citations.md、../../references/research-workflow.md、../../references/revision-training-export.md、../../references/slide-spec.md、../../references/image-strategy.md。不要 grep 插件源码。
  5. 宽泛主题时,根据时长和证据提供 2-3 个角度选择。
  6. 沿单一主线构建,按序生成:目录→每页主张/要点→PPT文案→演讲版→Slide Spec(用户表明将转 PPTX 时必写)。
  7. 每页内容幻灯片提供故事角色、主张、精简文案、可选视觉、证据引用、讲稿、时间、归属、转场。研究支持的 draft Slide Spec 在 evidence_refs 中直接使用 Research Pack 的 F/D/Q id;不要生成 E<n>、不要手写 Research Evidence Ledger。confidence: low 或 conflict 条目必须写成区间/限定语。sp-deck 后续由 research_pack_to_evidence.py 机械编译为 E ids、ledger 与 used_on_slides。
  8. 新手模式下解释关键结构/布局选择。用 analyze_presentation_spec.py 做结构/证据/密度风险检查;需要训练卡、Q&A、词汇表、提词版或修订元数据时运行 build_support_outputs.py。
  9. 如需文件输出并转 PPTX:若走过 Research Gate,写 outputs/<topic>-brief.yaml 与 draft outputs/<topic>-slide-spec.yaml,将 Brief、draft spec、Research Pack、research validation 一并交给 sp-deck;若是 C-only,则按普通无 research 流程交接。最终冻结的是 sp-deck 编译/验证后的 Slide Spec,而不是研究型 draft。交给 sp-deck 时仍保留完整 intake 门禁,outline 阶段不能替代其 Production Summary 确认。

输出契约

使用 outputs/<topic>-outline.md、outputs/<topic>-speaker-notes.md、outputs/<topic>-handoff-plan.md;转 PPTX 时另写 outputs/<topic>-brief.yaml 与 outputs/<topic>-slide-spec.yaml。研究型 spec 是 draft,普通 C-only spec 可直接按既有流程使用。不得写入 ${CLAUDE_PLUGIN_ROOT}。