工作台:需求打磨 prompt 文件化沉淀(prompts/clarify.md+模板注入+契约文档)

project/短视频脚本创作/V1.0/mcn-work-shop/docs/AI会话任务输入输出对照.md

@@ -101,6 +101,27 @@
 请帮我把抖音账号 {账号名称「x」, 账号地址「y」} 添加：通过抖音网页获取账号信息与视频列表，写入账号列表并保存到本地
 ```
 
+### 9 需求打磨 clarify（09-02 弹窗内对话式 · 09-07 模板文件化）
+
+> 账号列表「AI创作」弹窗底部的对话打磨,非 AI 会话任务(不走 /api/run),直调 Dify chat-messages。
+
+**调用**：前端 `POST /api/ai/clarify`，body `{ accountName, turn, reqMd, history, attach }` → `{ answer }`
+
+**answer 三段协议（顺序固定，09-07 定稿）**：
+
+| 段 | 标记 | 内容 | 前端处理 |
+|----|------|------|---------|
+| 正文 | 无 | 对用户说的话(150 字内)；追问时问题**独占一段**；收尾时提示「可直接点击右下角 ✓ 提交创作」 | 渲染为 AI 气泡 |
+| 候选 | `==OPTS==` | 每行一个候选,格式「骨架词——具体展开」(≤45 字、无编号)；结合本条创意/人设落地,禁干巴术语 | 解析为气泡下内嵌按钮行,点选=以整行文本发一轮 |
+| 需求 | `==REQ==` | 5 行清单：一句话创意/创新·爆点/痛点·爽点/叙事结构/其他约束(空项留空) | 解析回填需求框字段 |
+
+**System Prompt 已抽为文件**：`mcn-work-shop/prompts/clarify.md`（==PROMPT== 与 ==CHANGELOG== 之间为正文,头尾说明不发模型）。**迭代 prompt 只改该文件**,server.js 启动按 mtime 缓存读取、占位符注入（`{{accountName}}/{{personaText}}/{{contentText}}/{{attachText}}/{{reqMdText}}/{{histText}}/{{turnText}}`）,不再改 server.js 字符串。
+
+**关键规则（clarify.md 内固化）**：
+- 候选骨架受控词表：叙事结构(钩子前置/悬念反转/递进铺垫/先抑后扬)、内容形式(剧情/Vlog/口播/**视觉短片**)、剧情人物关系(一次一层)；每项必须结合本条创意给「具体形态」
+- 收尾门槛：创意/爆点/爽点/叙事结构 **至少 3 项明确**才可提示提交,否则继续补缺口
+- 前端草稿缓存：`localStorage aicreate_draft_{账号}`(w/convo/attach,每轮回复后存、提交后删)；点遮罩外不关闭,仅 X/「重置」可关
+
 ## 关键细节
 
 - **前缀常量定义位置**：data-pages.js 顶部 L7-16（SKILL_HINT_CREATE/EXTRACT/STORYBOARD/REVIEW）、app.js 顶部 L27（SKILL_HINT_ACCOUNT）。所有入口 prompt 必须带对应前缀，`executeTask/confirmRun` 必须传 `skills` 数组（参数级技能挂载→skills_json）。