关于 show-me-artifact
将报告和决策集发布为浏览器可读页面的技能,替代冗长聊天消息或本地 HTML。它用专门视图呈现状态、比较和决策,并支持更新及重新发布页面。
主要功能
- 01将报告发布为 Artifact 页面
- 02选择状态与比较视图
- 03展示含选项和证据的决策
- 04更新页面数据并重新发布
适用场景
- 01以浏览器可读形式分享报告
- 02并排呈现多个选项
- 03收集并记录持续更新报告中的决策
MCP 相关
使用 Claude 的 `Artifact` 工具发布浏览器页面;若不可用,README 建议通过 `/show-me` 创建精简的 HTML 文件。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ yahyabedirhan/ skills --skill show-me-artifact安装后在 Claude Code 中输入/show-me-artifact确认已加载。
详细介绍
将报告发布为一个工件页面,让用户在浏览器中阅读,而不是发送冗长的聊天消息或本地 HTML 文件。这需要 Claude 的 Artifact 工具。没有该工具时,请改用 /show-me 编写一个重点突出的 HTML 文件。
步骤
-
加载
/show-me,了解其视图和原则, 并将它们发布为一个工件页面,替代它打开的本地 HTML 文件。 -
每份报告或每组决策使用一个页面。 用户询问不同主题时,另开新页面,而不是添加章节。开篇先说明读者最需要了解的内容:当前进展,以及还有多少项决策待定。然后为每个要点选择一种视图:
- 进度以进度条和检查点列表展示,每个检查点标记为已完成、进行中或等待中;
- 多个项目的状态以按状态分组的树状结构展示,每个叶节点附上一行原因;
- 多次运行、选项或版本并列呈现为表格;
- 每项待定决策分别制作一张决策卡片。
页面上只放有助于读者理解或做出决策的内容,并链接到文件以便查看要点背后的详细信息。
-
编写每张决策卡片,确保读者只看卡片就能做出决定, 无需打开文件或回看前文:说明要决定什么、为何重要、用最精简且能说明问题的可视化呈现证据、列出选项,并标明推荐选项。为每张卡片分配一个简短 ID(
D1、D2),为每个选项标上字母(A、B、C),让用户能用一行回复,例如“D3:B”。 -
使用
Artifact工具构建并发布页面。 提供页面链接,并用一行说明页面包含什么。- 页面内容会更新时, 例如每个检查点都会更新的报告:
- 数据文件:
data.json存放内容,放在项目的.scratch/中;会话结束时,会删除会话的临时工作区,因此后续会话必须能从该文件中重建页面。 - 生成器: 将
build.py放在其旁边,用于生成 HTML。编写build.py前,先加载artifact-design,以便每次重建都保留页面主题和手机屏幕宽度适配规则。 - 编辑: 所有更改都在
data.json或build.py中进行,因为重建会覆盖 HTML。 - 重新发布: 使用同一文件路径,以便用户已有的链接显示新版本。
- 数据文件:
- 工作需要交接,或拉取请求中引用了页面时, 写明页面 URL 和数据文件的位置。后续会话使用
Artifact工具的read操作读取该 URL 上的页面,然后通过设置url为该 URL 来重建并发布,而不是创建新页面。
- 页面内容会更新时, 例如每个检查点都会更新的报告:
-
用户回复卡片后, 根据回复采取行动,并在下次重新发布时将该卡片标记为已决定,确保页面不再询问已经定下的事项。
- 用户通过页面评论作答时, 使用
ArtifactComments工具读取评论,并将其视同聊天回复。
- 用户通过页面评论作答时, 使用
评论
支持 Markdown