mcpField
S
show-me-artifact

show-me-artifact

github.com/yahyabedirhan文档处理257 次安装6 天前更新
代码仓库

关于 show-me-artifact

将报告和决策集发布为浏览器可读页面的技能,替代冗长聊天消息或本地 HTML。它用专门视图呈现状态、比较和决策,并支持更新及重新发布页面。

主要功能

  1. 01将报告发布为 Artifact 页面
  2. 02选择状态与比较视图
  3. 03展示含选项和证据的决策
  4. 04更新页面数据并重新发布

适用场景

  1. 01以浏览器可读形式分享报告
  2. 02并排呈现多个选项
  3. 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 文件。

步骤

  1. 加载 /show-me,了解其视图和原则, 并将它们发布为一个工件页面,替代它打开的本地 HTML 文件。

  2. 每份报告或每组决策使用一个页面。 用户询问不同主题时,另开新页面,而不是添加章节。开篇先说明读者最需要了解的内容:当前进展,以及还有多少项决策待定。然后为每个要点选择一种视图:

    • 进度以进度条和检查点列表展示,每个检查点标记为已完成、进行中或等待中;
    • 多个项目的状态以按状态分组的树状结构展示,每个叶节点附上一行原因;
    • 多次运行、选项或版本并列呈现为表格;
    • 每项待定决策分别制作一张决策卡片。

    页面上只放有助于读者理解或做出决策的内容,并链接到文件以便查看要点背后的详细信息。

  3. 编写每张决策卡片,确保读者只看卡片就能做出决定, 无需打开文件或回看前文:说明要决定什么、为何重要、用最精简且能说明问题的可视化呈现证据、列出选项,并标明推荐选项。为每张卡片分配一个简短 ID(D1、D2),为每个选项标上字母(A、B、C),让用户能用一行回复,例如“D3:B”。

  4. 使用 Artifact 工具构建并发布页面。 提供页面链接,并用一行说明页面包含什么。

    • 页面内容会更新时, 例如每个检查点都会更新的报告:
      • 数据文件: data.json 存放内容,放在项目的 .scratch/ 中;会话结束时,会删除会话的临时工作区,因此后续会话必须能从该文件中重建页面。
      • 生成器: 将 build.py 放在其旁边,用于生成 HTML。编写 build.py 前,先加载 artifact-design,以便每次重建都保留页面主题和手机屏幕宽度适配规则。
      • 编辑: 所有更改都在 data.json 或 build.py 中进行,因为重建会覆盖 HTML。
      • 重新发布: 使用同一文件路径,以便用户已有的链接显示新版本。
    • 工作需要交接,或拉取请求中引用了页面时, 写明页面 URL 和数据文件的位置。后续会话使用 Artifact 工具的 read 操作读取该 URL 上的页面,然后通过设置 url 为该 URL 来重建并发布,而不是创建新页面。
  5. 用户回复卡片后, 根据回复采取行动,并在下次重新发布时将该卡片标记为已决定,确保页面不再询问已经定下的事项。

    • 用户通过页面评论作答时, 使用 ArtifactComments 工具读取评论,并将其视同聊天回复。

评论

支持 Markdown