Claude Code Artifact 标题与描述规范：如何为发布内容取一个稳定、可检索的好名字

• 文档
• 提示工程
• 人工智能

导读

本文围绕 Claude Code System Prompts 仓库中 Artifact 发布时的**标题（title）与描述（description）**生成规范展开，说明 Claude 在创建与重新发布 Artifact 时如何为页面命名、把解释性内容放到描述参数中，以及如何保证标题在多次重新发布之间保持稳定。读完本文，你将掌握一套可直接照做的命名规则、底层实现原理（8KB 扫描范围、<title>与title参数的取舍逻辑），并能结合仓库内配套的 HTML 骨架、图库与发布流程文档，写出专业、可检索、可长期维护的 Artifact 页面。

一、规范出处与适用范围

本规范来自仓库中的两份配套文档：

• tool-description-artifact-title-and-description-guidance-app-wording.md（app 版措辞，对应 ccVersion 2.1.271）
• tool-description-artifact-title-and-description-guidance.md（完整版措辞，对应 ccVersion 2.1.284）

它们属于 Artifact 工具描述（Tool Description）体系的一部分，与仓库中同一命名空间下的 tool-description-artifact-publishing-and-update-guidance.md、tool-description-artifact-html-document-skeleton.md、tool-description-artifact-gallery-and-publish-response-guidance.md 等文档共同约束 Artifact 的创建、命名、发布与更新行为。适用场景是：当 Claude 通过 Artifact 工具发布一个 HTML/Markdown 页面（包括首次发布和后续重新发布）时，如何填写页面的标题与描述。

二、核心机制：<title>标签、title参数与 8KB 扫描

要理解命名规范，首先要分清两个容易混淆的概念：

1. HTML 文件里的<title>标签是唯一命名来源。

Claude 会把<title>放在 HTML 文件的最顶部；发布时系统只扫描文件前 8KB来寻找该标签（only the first 8KB is scanned）。这意味着：

• <title>必须写在文件靠前的位置，不能藏在 1KB 的注释或超长的<style>之后；
• 这个标签决定了 Artifact 在**浏览器标签页（tab）和图库（gallery）**中显示的名字。

这与 tool-description-artifact-html-document-skeleton.md 的要求完全吻合：发布时文件会被包裹进<!doctype html>…<head>…</head><body>骨架，头部仅携带 charset、viewport meta 和一段小型 reset，因此 Claude 必须自己把<title>和<style>写在文件顶部，而不是依赖框架自动生成。

2. 发布调用中的title参数只是兜底方案。

title参数仅在 HTML 文件没有<title>标签时才会生效；对于 Markdown 页面，则始终保留文件名作为标题（Markdown pages keep their filename）。也就是说，一份规范的 Artifact 页面应当把标题写死在 HTML 内容中，title参数只是防御性兜底。

3. 标题在重新发布时保持稳定。

规范明确要求 Claude在多次重新发布（redeploy）之间保持标题稳定，不因一次内容微调就改换页面名字——这与 tool-description-artifact-publishing-and-update-guidance.md 中对icon参数"同一 Artifact 生命周期内保持不变"的要求是同一设计原则：Artifact 的身份标识（标题、图标）一旦建立就不应随意漂移。

三、命名规则：写"名字"，不写"摘要"

标题是 Artifact 在标签页与图库中的名字，因此规范要求的是一个简短的名称（a name），而不是一句话总结（a summary）。具体规则如下：

3.1 剪裁规则：保留"名字"，去掉"通用词"

规范给出了一条精妙的剪裁规则：当一个自然的标题把"名字"和一个"通用词"配对时，保留下来的应当是名字那一半。例如：

• "Revenue Dashboard"→ 剪裁为"Revenue"（保留名字，去掉通用词 Dashboard）；
• "Paris Trip Itinerary"→ 剪裁为"Paris Trip"（保留专名，去掉 Itinerary）。

反过来，一个多词标题如果本身已经读起来像一个完整的专有名字，就视为成品，不再继续剪裁。例如"Q3 Board Meeting"本身就是一个具体名称，不应再削成"Q3"。这条规则的实质是：标题的辨识度来自"名字"部分而非"类型"部分，类型信息交给描述去表达。

3.2 为什么这样命名：可检索性与引用价值

从仓库的设计意图看（app wording版明确指出标题会出现在浏览器标签页和图库卡片中），一个稳定、具体、简短的名字直接决定了用户在 claude.ai 图库（tool-description-artifact-gallery-and-publish-response-guidance.md 中提到的claude.ai/code/artifacts）中能否一眼找到并再次打开自己的作品；同时它也作为图库卡片的标题被搜索引擎、Agent 和 LLM 索引，因此"名字而非摘要"的写法对后续检索、引用和分享都有直接价值。

四、description参数：一句话解释，图库卡片的副标题

规范的另一个重点是把解释性内容与标题分离：

• 标题（<title>/title）只承担"名字"职责，不承担解释职责；
• 解释放在一句话的description参数中，它最终成为图库卡片（gallery card）的副标题（subtitle）。

因此成对写法应当是：

<title>Quarterly Revenue</title>

同时发布调用中提供：

description: "Interactive chart of quarterly revenue with regional filters and year-over-year comparison"

这样一个完整图库卡片就同时具备"快速辨识的名字"和"理解内容的说明"两层信息，避免了把卡片副标题内容挤进标题导致的冗长与重复。

五、完整落地流程：从写文件到发布

结合 tool-description-artifact-page-authoring-and-html-skeleton-app-wording.md 与 tool-description-artifact-html-document-skeleton.md，一份合规页面的完整产出路径是：

1. 写页面内容：直接书写页面内容，由发布流程自动包裹<!doctype html>骨架，因此不要自己写<html>、<head>、<body>标签；
2. 在文件顶部放<title>与<style>：确保<title>位于前 8KB 内，是页面唯一的命名来源；
3. 命名遵循"名字而非摘要"规则：2～4 个词的短名词短语，优先沿用用户已有命名；
4. 解释性内容放入description参数：一句话即可，作为图库卡片副标题；
5. 保持稳定：重新发布时沿用既有标题，不随意改名。

此外，tool-description-artifact-type-creation-guidance.md 说明：从已发布的 Artifact 类型（模板/starters）创建新 Artifact 时，title参数应传用户对该内容的叫法或一个简短描述性名字——这与本规范"优先沿用用户命名"的原则一脉相承。而 tool-description-artifact-preview-action.md 提示：正式发布前可用preview动作在本地以浅色/深色主题、桌面/手机宽度渲染单页文件并返回截图与布局检查清单，可以在发布前确认标题在两种主题下都正常显示。

六、常见错误与自查清单

基于规范，以下是发布标题时最容易踩的坑及自查要点：

• ❌ 标题写成一句话摘要 → ✅ 改为 2～4 词的名字，摘要移入description；
• ❌ 只用"Chart"、"Calendar"等类别词 → ✅ 名字+类别词配对，如"Sprint Calendar"；
• ❌ 标题后接— 用途说明或: 副标题→ ✅ 去掉解释，全部放入description；
• ❌ 用户已有命名却另起新名 → ✅ 沿用用户的名字；
• ❌<title>写在文件深处，超出前 8KB 扫描范围 → ✅ 置于文件顶部，紧邻<style>之前；
• ❌ 每次重新发布都微调标题 → ✅ 标题保持稳定，仅在用户明确要求时修改。

七、小结

Claude Code 的 Artifact 标题规范可以概括为一句话：标题是名字，描述是解释。页面命名完全由 HTML 顶部前 8KB 内的<title>标签决定（title参数仅作兜底，Markdown 保留文件名），名字要短（2～4 词）、要具体、要稳定、要优先沿用用户已有的命名，而所有解释性信息统一交给一句话的description参数作为图库卡片副标题。这套规则与仓库中 HTML 骨架、图库展示、重新发布等配套文档共同保证了 Artifact 从创建、发布到反复更新的全生命周期内，页面身份始终清晰、可辨识、可检索。

延伸阅读（仓库内配套文档）：

• Artifact HTML 骨架规范
• Artifact 页面编写与骨架（app 措辞版）
• Artifact 发布与更新总规范
• Artifact 图库与发布响应规范
• Artifact 类型创建规范

• 文档
• 提示工程
• 人工智能