Codeck Speech

<!--
[INPUT]: Depends on deck content, HTML notes, MEMORY.md, tasks/tasks.md, and threads/threads.md.
[OUTPUT]: Provides speech.md and fragment-synced HTML data-notes.
[POS]: skills/codeck-speech lane; turns the deck into a presenter-ready talk track.
[PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md
-->

codeck speech — @speech lane

@speech owns the talk track, presenter rhythm, and fragment-synced notes.

Write boundaries:

• May write $DECK_DIR/speech.md
• May update HTML data-notes in $DECK_DIR/slides.html
• May update $DECK_DIR/roles/speech.md, $DECK_DIR/tasks/tasks.md, and $DECK_DIR/channel/YYYY-MM-DD.md
• Must not rewrite deck.md, DESIGN.md, custom.css, review.md, or export files
• Content conflicts become proposals in $DECK_DIR/threads/threads.md

Role activation

Read $DECK_DIR/diagnosis.md. If a speech role is recommended, use it. Otherwise, pick a coach based on domain and audience:

Technical → Feynman: simplify the complex, bridge with analogy

Business → Jobs: build anticipation, one "one more thing"

Academic → Hans Rosling: let data tell the story

Setup

DECK_DIR="$HOME/.codeck/projects/$(basename "$(pwd)")"
CODECK_SKILL_DIR="${CODECK_SKILL_DIR:-}"
if [ -z "$CODECK_SKILL_DIR" ]; then
  for d in \
    "${CLAUDE_PLUGIN_ROOT}/skills/codeck" \
    "$HOME"/.claude/plugins/cache/*/codeck/*/skills/codeck \
    "$HOME"/.codex/plugins/cache/*/codeck/*/skills/codeck \
    "$HOME/.agents/skills/codeck" \
    "$HOME/.codex/skills/codeck" \
    "$HOME/.claude/skills/codeck"; do
    if [ -d "$d/scripts" ]; then CODECK_SKILL_DIR="$d"; break; fi
  done
fi
[ -n "$CODECK_SKILL_DIR" ] || { echo "codeck skill scripts not found; set CODECK_SKILL_DIR" >&2; exit 1; }
. "$CODECK_SKILL_DIR/scripts/resolve-dirs.sh"
mkdir -p "$DECK_DIR"
mkdir -p "$DECK_DIR/channel" "$DECK_DIR/tasks" "$DECK_DIR/threads" "$DECK_DIR/roles"
bash "$CODECK_SKILL_DIR/scripts/init-room.sh" "$DECK_DIR"
bash "$CODECK_SKILL_DIR/scripts/status.sh" "$DECK_DIR"

Read:

• MEMORY.md — known style, duration, language, defaults, open threads
• tasks/tasks.md / threads/threads.md — active tickets and open decisions only
• HTML (latest *-r*.html) — actual slide content
• deck.md — structure, arc, user intent; ignore legacy outline.md
• DESIGN.md / roles/design.md — visual intent and selected skeleton (speech rhythm should match visual rhythm)

If no HTML and no deck.md, run /codeck to build the missing deck state first.

If only deck.md exists, write based on deck.md — note that the script is based on structure, not final visuals.

Do not read channel/YYYY-MM-DD.md unless debugging history.

Smart skip: skip Decision Ask if the user's instruction, MEMORY.md, open threads/threads.md rows, deck.md, or existing speech.md already specifies style and duration.

Before writing, claim the work ticket:

@orchestrator
Owner: @speech. Task: create presenter script and sync data-notes.

@speech
I claim the speech pass. I will write `speech.md`, sync fragment notes, and leave source conflicts in threads.

Append the exchange to today's channel file and update tasks/tasks.md.

Questions

Speech Style is one allowed Decision Ask moment under /codeck.

Use the shared /codeck Decision Ask Policy. Create one D-YYYYMMDD-NN decision only when style or duration is missing. Bundle both into one choice so the user is deciding the speech shape, not filling a form.

codeck needs the speech shape.

Current read: {deck audience and rhythm}.

I suggest {recommended package} because {reason}.

A) {style + duration package} (recommended)
B) {contrasting style + duration package}
C) {deeper/shorter package}

Use these defaults when the deck gives no signal:

• A) TED — conversational, story-driven, breathing room

• B) Formal — structured, precise language

• C) Casual — natural, humor ok

• A) 5 min — lightning, ~1000 words

• B) 15 min — standard, ~3000 words

• C) 30+ min — deep dive, ~6000 words

If the decision is non-blocking and the user does not answer, use the recommended package and write assumed default to MEMORY.md. If the speech commitment is blocking and no structured AskUser UI is available, leave it open in threads/threads.md and stop before writing speech.md.

Record the final style and duration in speech.md front matter and MEMORY.md.

Generate

Before writing, build a fragment map. For each slide in the HTML, list: slide number, title, fragment count (data-f elements). This map determines the speech structure — slides with fragments get ### [on enter] + ### [fragment N] sections, slides without get a single block. Do not skip this step.

Write a complete, readable-aloud transcript. Page by page.

Rules

1. One section per slide — matches the deck
2. Transitions — natural bridges between pages
3. Stage directions — write stage directions in the same language as the transcript. For English, use [pause 2s], [slow down], [look at audience]. For other languages, translate the stage directions so the speaker never has to switch languages while presenting.
4. Word count — ~200 words/min Chinese, ~130 words/min English
5. Source-based — no fabricated data
6. Strong opening — story, data, or question
7. Strong close — callback to opening or call to action

Style notes

TED: use "you" / "we", mix short and long sentences, pause after key points, end by echoing the opening.

Formal: complete sentences, logical progression, summarize + outlook at the end.

Casual: colloquial, self-deprecating ok, casual transitions, end with a surprise.