SuperAPI AI 工具集

friction-log

智能体与模型

查看项目

更新于 10-15 19:57

技能介绍

friction-log 是 Astroshots 中的一项技能,用于编写、列出并执行摩擦日志(friction log)。摩擦日志是本地智能体像真实用户一样走完产品流程的运行:显式步骤、干净环境、截图和诚实的 UX 笔记。Astroshots 在托盘 Friction Logs 标签页展示它们,与一次性 Shots 分开。

用途与模式:作者(编写场景 prompt.md)、列出(查看已有日志)、运行(执行场景并产出 JSONL)。

文件结构:prompt.md(场景)、meta.json(可选标题/描述/状态)、runs/<run-id>/log.jsonl 及按序命名的 PNG。一次性截图放在 .astroshot/<feature>/,摩擦日志放在 .astroshot/friction-logs/<slug>/。

作者要点:prompt.md 需含目标(用户结果)、人物、环境(干净会话、临时账号)、前置条件、编号步骤(用户视角、每步的“完成”信号与截图位置)、范围外、输出契约。建议 5–12 步,slug 用 kebab-case,不在 prompt.md 写密钥。

运行要点:每次尝试新建唯一 runs/<run-id>/ 目录,不追加到已有 run;先准备干净环境;每步执行动作、等待完成信号、截图(如 0001-land-home.png)、追加一行 JSONL。JSONL 必填字段:step、id、title、description、transcript、screenshots、good、improve;url、captured_at 可选。transcript 为口播叙述,第一人称现在时,2–5 句、约 40–90 词,须跨步骤连贯过渡。

完成与失败:结束将 meta.json 状态置 complete 或 failed;无法准备环境时写单条说明阻塞的步骤并置 failed;中途失败仍记录失败状态并视情况继续;无任何步骤的空 run 目录应删除。

限制:摩擦日志是智能体撰写的 UX 叙述,不是 harness 的通过/失败;不得用一段 astroshot 录屏替代每步截图;叙述 MP4 为可选功能,由 Astroshots 应用在启用 Narration 后渲染,智能体只需写好 transcript。与 astroshot、agent-browser、browser-ui-harness 等技能按场景配合使用。其它平台、收费等信息暂未提供。