‹ 首页

demo-with-narration

@lexler · 收录于 昨天 · 上游提交 1 周前

Demos working software: first proves every claimed behavior by exercising the real artifact, then replays the proof as a slow, voice-narrated walkthrough. Use when the user asks for a demo or to be shown that something works.

适合你,如果需要向他人证明软件功能正常工作

/ 通过 npx 安装 校验哈希
npx oh-my-skill add lexler/skill-factory/demo-with-narration
/ 通过 bash 安装
curl -fsSL https://oh-my-skill.com/install.sh | bash -s -- lexler/skill-factory/demo-with-narration
/ 已经装过?验证本机副本,不用重装
npx oh-my-skill verify lexler/skill-factory/demo-with-narration
安装目标可用 --agent / --scope 或 --to 明确指定;省略时只会在唯一已存在的 agent 目录上自动选择,零命中或多命中会停止并提示。content_hash 缺失或不一致均拒装。
223GitHub stars
~662上下文体积 · 单文件
索引托管

怎么用

商店整理自技能原文 · 版本 2eae60e · 表述以原文为准
它做什么

装上后,当用户要求演示时,Claude 会先私下运行实际软件,验证每个声称的行为;然后慢速回放,并用语音旁白逐步骤解释,证明软件确实能工作。

什么时候触发

当用户提出演示请求,或要求证明某物能工作时触发。

装好后可以这样说
Claude 将执行演示流程。
Claude 会先私下测试,再旁白回放。
Claude 会以慢速、语音叙述的方式演示。
技能原文 SKILL.md作者撰写 · Apache-2.0 · 2eae60e

Demo With Narration

STARTER_CHARACTER = 🎬

A demo is a proof performed twice: once fast and private to convince yourself, once slow and narrated to convince the person watching.

Stage 1: Self-demo

Exercise the real artifact the way its consumer will — the built binary, the running app. A green test suite is the starting point, not the proof.

  • Check every behavior you intend to claim: the happy path, each refusal path with its exact stderr reason and exit code, every way the session can end.
  • Probe at least one path beyond the obvious ones (quit from the menu, not just close the window) — the extra path is where green-suite bugs hide.
  • A detached GUI launch loses its exit status: wrap the launch in a subshell that writes $? to a file, read the file after the window closes.
  • Confirm a window really rendered with a screenshot; drive close and quit through accessibility clicks.

Done when every behavior you will claim in the walkthrough has been observed working, and any bug found is fixed and re-proven.

Stage 2: Narrated walkthrough

Replay the proof slowly. The person asked to follow along, so pace for their eyes and ears.

  • Announce each step by voice (speak) before acting: what is about to happen, what to watch for. Pause a beat so the voice finishes before the action starts.
  • One step per command, numbered. Each step proves exactly one claim.
  • When something appears on screen, say how long it will stay and leave it there — ten seconds for a window is enough to actually look at it.
  • After each step, one or two sentences of text recapping what was just proven.
  • Order the steps as an argument: the input artifact first, then the refusal paths with their exit codes, then the happy path, then every way the session can end.
  • Include at least one step that can only pass if the whole pipeline works — a validation error from the deepest layer surfacing at the outermost one — rather than only surface behaviors.

Done when every step was announced before it ran, each claim from the self-demo appeared in exactly one step, and a final recap lists every step.

Desktop-automation safety

A System Events keystroke lands on the frontmost application, whatever process the tell block names.

  • Click the specific button or menu item through accessibility instead of synthesizing keystrokes.
  • When a keystroke is unavoidable: bring the target frontmost, read back which app is actually frontmost, and type only if it matches the target.
  • After any slip, list the open windows and confirm nothing else was harmed before continuing.
按 Apache-2.0 许可原样转载,未经改动 · 在 GitHub 查看 →

评论

登录即可评论;带「已验证安装」的,是发布者名下有本店的安装或持有记录。