SuperAPI AI 工具集

creating-artifacts

写作与研究

查看项目

更新于 10-15 16:48

技能介绍

用途:当用户要求产物或页面,或结果属于需要他人审阅、分享、反复回看的文档时使用,例如计划、提案、设计、调研与调查综述、选项对比、状态报告、需要配图的系统或变更说明。短消息即可说清、无人需分块评论时应在对话中直接回答。截图、录屏、数据文件不算页面,本技能不改变其保存与链接方式。

主要能力:以模板生成单页自包含 HTML,正文用图表达结构、流程与数据:模板提供 .flow/.node/.edge、分组、Before/After 对比、.seq 动效、.parts 标注、.bars 条形图、内联 SVG、HTML 模拟界面与控件的现成标记;每页至少一张表达主旨的图。页面为速读设计:头部与摘要独立成立,摘要首行为 Needs from you,标题写结论,一块一个观点,证据与长代码折叠进 details。所有样式与脚本内联,不加载外部资源。

使用方式:在 workspace 根目录执行,先调研代码、文档与数据再动笔。 mkdir -p .amp/in/artifacts/pages cp <skill>/reference/page-template.html .amp/in/artifacts/pages/<slug>.html 替换全部 ⟦…⟧ 占位符,删去不需要的段落,保留模板样式与脚本。检查并分享: node <skill>/scripts/share.mjs 可用 --check 只检查,--dir DIR 指定目录;脚本会检查占位符与重复 id,并打印标题与门户 URL。用 agent-browser 截图每张图与宽表核对排版,动效图需等约两秒后再截,窄屏也需查看。回复先给链接,再最多五行说明需要读者决定什么、页面要点与如何评论。

评论机制:门户页带评论按钮,读者选中元素写评论,评论以 user 消息形式回到线程,携带页面 URL、CSS 选择器与该元素前 200 字符。因此每个可评论块需有含义唯一 id(如 step-dual-write,不用 step-2),并为决定、发现、步骤、风险加可见标签 Q1、F1、S1、R1;页面分享后不重新编号或复用标签。每个元素只放一个决定/发现/步骤/风险。收到评论后定位块、修改受影响的块、在 What changed 记录并更新版本号,已决问题保留并加 Decided 标记,重新运行分享脚本后回复。

适用场景与限制:适合需要评审、分享、反复修订的文档型交付物;产出物即页面时应分享后结束该轮,页面描述某项工作时分享后可继续不受未决事项影响的部分。不适用于短消息即可说明、无需分块评论的情形;截图、录屏、数据文件不按页面处理。所有结论须有已阅读的文件、函数、命令与来源支撑,无法核实的内容标为假设;只能给出一个答案或推荐,其他选项列在 Alternatives 并写明落选原因;只向读者提问其必须决定之事,其余自行决定并在页面写明。未提供模板文件、脚本与本技能的具体安装命令,也未提供收费、价格或平台支持信息,暂未提供。