mcpField
T
to-artifact

to-artifact

github.com/angusfretwell设计与 UI147 次安装2 天前更新
代码仓库

关于 to-artifact

to-artifact 是一项用于按指定风格制作并发布有依据页面的技能,面向设计者和内容作者。它涵盖主题选择、论证组织、页面渲染,以及主题和窄屏检查。

主要功能

  1. 01选择主题并审查证据
  2. 02围绕读者需求组织论证
  3. 03遵循指定风格与样式表
  4. 04检查明暗主题和窄屏布局
  5. 05渲染、修订并发布页面

适用场景

  1. 01制作有证据支撑的项目或议题页面
  2. 02将材料整理为快速阅读和审计路径
  3. 03检查页面在不同主题与窄屏下的呈现

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/angusfretwell/skills --skill to-artifact

安装后在 Claude Code 中输入/to-artifact确认已加载。

附带文件assets/style.cssreferences/design.md

详细介绍

交付物是一份按既定风格发布的 Artifact。

设计前加载 artifact-design 和 humanize,编写任何图表前加载 dataviz。references/design.md 规定了既定风格:它的语气、构成风格的字体与颜色、设定这些样式的样式表,以及它刻意摒弃的惯例。页面文案的每个字都遵循 humanize。

1. 确定主题

从第一个有主题的来源中选取主题:调用中指定的主题、本次会话讨论的主题,或与当前任务相关的 PR 或 issue。如果所有来源都为空,就提问。

完成标准:主题写成一行,并且已掌握支撑材料。

2. 明确读者要完成的任务

设计前检查所有可用材料。私下明确以下问题:

  • 谁会在什么情境下打开这份内容?他们要据此做出什么决定,或理解什么?
  • 有材料支持的最有力答案是什么?
  • 什么证据能让这个答案可信?
  • 哪些取舍、不确定性或限制会影响对答案的解读?
  • 哪些内容应保留以供审计,但不应主导首次阅读?

规范事实、单位、日期、来源、公式、矛盾、未知事项和隐私限制。区分观察、推导、预测、建议和因果关系。绝不虚构意图、归属、紧迫性、确定性、截止日期、审批、未来行为或保密性。

按照读者的需求而非来源顺序组织内容,并兼顾两种阅读方式:快速浏览路径中,标题、各级标题、关键数值、图注和结论应能迅速传达论点;审计路径中,精确表格、假设、方法、注意事项和来源应能完整保留记录。

完成标准:已写明论点——读者的问题、有材料支持的最有力答案,以及能让这个答案可信的证据;每个部分都回答一个其他部分未回答的读者问题;每项主张都有一个证据归属处:后续表格可以保留精确查询信息,但不得再用另一份摘要、图表或结论,以同等显著程度重述同一个答案。

3. 制作并检查

让论点决定结构。首屏应直接呈现论点,而不是页眉和铺垫;之后按材料所需自由编排。采用 references/design.md 中的字体、颜色和语气,按其中的说明将 assets/style.css 与页面一同发布,并避免采用其中列出的任何惯例。

渲染已发布的页面,并在两种主题和窄屏宽度下阅读:

  1. **首次阅读:**只看首屏的读者,记住的会是核心关系、决策或工具,而不是标题或氛围吗?
  2. **克制:**有没有表面、边框、胶囊标签、图标、标签、颜色、段落或章节可以删去,而不损失含义、可用性或节奏?如果有,就删掉。
  3. **主题与重排:**浅色和深色主题是否保持同等的层级与对比度?页面重排后是否没有溢出,也不会逐字换行?

修复影响最大的缺陷,再次渲染并重复检查。

完成标准:页面已发布,样式表与页面放在一起;渲染结果通过全部三项检查;用户拿到的是页面本身:此评审仅在内部进行,因此不要提供评分、过程记录或自我批评。

评论

支持 Markdown