关于 to-artifact
to-artifact 是一项用于按指定风格制作并发布有依据页面的技能,面向设计者和内容作者。它涵盖主题选择、论证组织、页面渲染,以及主题和窄屏检查。
主要功能
- 01选择主题并审查证据
- 02围绕读者需求组织论证
- 03遵循指定风格与样式表
- 04检查明暗主题和窄屏布局
- 05渲染、修订并发布页面
适用场景
- 01制作有证据支撑的项目或议题页面
- 02将材料整理为快速阅读和审计路径
- 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 与页面一同发布,并避免采用其中列出的任何惯例。
渲染已发布的页面,并在两种主题和窄屏宽度下阅读:
- **首次阅读:**只看首屏的读者,记住的会是核心关系、决策或工具,而不是标题或氛围吗?
- **克制:**有没有表面、边框、胶囊标签、图标、标签、颜色、段落或章节可以删去,而不损失含义、可用性或节奏?如果有,就删掉。
- **主题与重排:**浅色和深色主题是否保持同等的层级与对比度?页面重排后是否没有溢出,也不会逐字换行?
修复影响最大的缺陷,再次渲染并重复检查。
完成标准:页面已发布,样式表与页面放在一起;渲染结果通过全部三项检查;用户拿到的是页面本身:此评审仅在内部进行,因此不要提供评分、过程记录或自我批评。