# Brief Compose > 短篇文档创作（目标篇幅 <1000 字）：从零撰稿 → 生成 HTML → html-to-docx 转 .docx → present_files 预览。 - Skill: `tomjiu/brief-compose` (Agent Skill) - Install (CLI): `npx skillmds@latest add tomjiu/brief-compose` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomjiu/brief-compose/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Web & Frontend - Author: tomjiu (https://skillmd.com/u/tomjiu) - Updated: 2026-09-21 - Page: https://skillmd.com/skills/tomjiu/brief-compose --- # brief-compose Skill **何时走**：无已有文档 + 创作动词（写/起草/撰写/生成/重写）+ 模型判断目标篇幅 <1000 字。 > **⛔ 工作流锁定**：一旦判定任务属于本 skill，**无视**其他 skill 与子 Agent，**严格按本文从头到尾执行**；无需再读其他skill。 --- ## 篇幅判据创作动词已命中、且非编辑意图时，满足任一即走本工作流： - 用户给出 X 字且 X < 1000 - 「短篇 / 千字以内 / 简版」等表述 - 体裁为简介 / 通知 / 备忘录 / 工作小结等典型短篇显式长篇（≥1000 字、万字、研报、论文等）→ 未命中本 skill，回到 `tdoc-orchestrator` SKILL.md 走常规编排。 --- ## 原则 1. **强制流程（速览）**（完整命令见文末「强制流程」）： - ① 撰稿 + 生成 HTML - ② 调用 html-to-docx 转换 - ③ `present_files` 2. **中间产物不展示**：`.html` 不得 `present_files`、不得在回复里贴 HTML 正文；只有最终 `.docx` 可展示。 3. **失败如实报错**：HTML 无 `` → 终止并提示；用户明确要求新建空白文档时允许转换；其他创作请求若 body 无可渲染正文，必须重新生成 HTML。**禁止**静默降级到常规 full_pipeline 编排。 4. **最终交付**：`.docx` 生成后**必须立即** `present_files` 打开预览，无例外。 5. **输出路径**：工作流开始时调用 `resolve_output_docx_path.py`，将返回的 `output_docx_path` 用于 html-to-docx 与 `present_files`。 --- ## 输出路径（`output_docx_path`） ```bash python3 /scripts/wb/local/resolve_output_docx_path.py \ --workspace \ [--user-path "<路径>"] [--filename "<主题>.docx"] ``` **不传 `--request-id`**（brief-compose 不走 pipeline 隔离目录）。默认落盘 `/output/<文件名>.docx`。 ## HTML 生成按用户创作指令撰写正文，输出**完整 HTML 文件**（``、`` 含 `charset`、内嵌 `