rico-prompterlisted
Install: claude install-skill ricoocuii-source/rico-prompter
# rico-prompter
产出一个零依赖单 HTML:**打开即纯净逐页画面**(无页头无讲稿,右下角唯一按钮「打开提词器」)→ 点一下弹出**悬浮提词器**(永远置顶、高度=当前窗口高、跟随滚动双向联动、稿子点击即编辑、按钮随即隐藏,画面从此零多余像素)。安全模型:会议软件"共享窗口"只捕获窗口矩形,提词器放在窗口旁边即绝对不可见——结构性保障,不依赖捕获排除黑科技。
## 工作流
以下脚本路径都以本 Skill 根目录为准。执行命令前先设置:
```bash
SKILL_DIR="$HOME/.claude/skills/rico-prompter" # 按你所用 Agent 的实际安装路径调整
```
### 1. 只问两件事(缺哪问哪,别一次全问)
1. **素材形态**:只问两个默认选项——Figma 链接(有无 token)还是 PDF?→ 读 [references/source-modes.md](references/source-modes.md) 选择并执行。不要主动引导用户提供逐页图片;仅当用户自己拿出现成逐页图时才走图片兜底模式。
2. **讲稿来源**:用户自带成稿(只排版不改写),还是 AI 写稿?选 AI 写稿则按 [references/narration.md](references/narration.md) 的**三档**让用户选(讲稿大纲 / 精简讲稿 / 全文讲稿)——一、二档不加推荐标记,三档标注"不推荐"。
交付名与目录**不问用户**,直接按下方命名规范给合适的默认值(产物路径会显示在主窗地址栏里、被观众看到,必须干净);用户不满意自然会说。
### 2. 准备逐页图
按 source-modes.md 执行,得到 `<deck目录>/pages/p001.png …`。完成后抽查 2-3 张图确认清晰度和页序。中间产物(pages/、deck.json)放用户项目目录下的 deck 工作目录(如 `<项目>/presenter/<deck名>/`),用户要能重建迭代。
### 3. 写讲稿 → deck.json
读 [references/narration.md](references/narration.md)(风格规范、红线、schema)。
- AI 初稿:逐页看图写;**页面上没有的数据一个不许编**。
- 用户自带稿:只切分排版,不改写。
- `deck_id` 用短横线小写、全局唯一(它是 localStorage 前缀和窗口名,迭代时不可变)。
### 4. 构建与命名(产物路径 = 门面)
```bash
python3 "$SKILL_DIR/scripts/build_presenter.py" <deck目录> -o <交付路径>
```
**命名规范**(主窗地址栏会显示完整文件路径,观众看得到):
- 文件名:语义清晰、无歧义、小写短横线,如 `rico-portfolio.html`、`q3-design-review.html`。**禁止** test / demo / draft / copy / v2 / 副本 / 未命名 之类字样。
- 目录:放用户工作目录下语义干净的位置(新建或复用均可),如 `<项目>/presentations/`。整条路径念出来不应有让观众分神的词。
- deck.json 的 `title`(= 浏览器窗口标题)同样是门面:会出现在会议共享选窗列表和被共享画面里,**禁止含"讲稿/提词/