用途：user-story 用于以真实用户视角走查产品，编写并执行带显式步骤、干净环境、截图和 UX 记录的本地智能体场景，即“用户故事”。该类内容曾称为 friction logs，新故事存放在 .astroshot/stories/，旧 .astroshot/friction-logs/ 仍会被读取且不会被搬移或删除；同名 slug 时以 stories/ 为准。审查托盘第二个标签页列出用户故事，终端 astroshot review 中该标签显示为 User stories，macOS 应用更新前可能仍显示 Friction Logs。
主要能力与用法：分三种模式——Author（设计场景、编写 prompt.md 与可选 meta.json，状态有 draft/ready/running/complete/failed）、List（查看已有日志）、Run（执行场景生成 JSONL）。支持原生 archdev shots 命令（如 archdev shots stories new/list/show/run-dir/upload），不可用时用手动 shell 步骤，二者读写同一磁盘布局。故事目录含 prompt.md、meta.json 与 runs/<run-id>/ 下的 log.jsonl、meta.json 和零填充命名的 PNG 截图。每个 JSONL 步骤必填 step、id、title、description、transcript、screenshots、good、improve；transcript 为口头旁白，需覆盖动作、优点与问题，段落间连贯衔接。
限制与注意：步骤应为用户操作而非调用 API 或代码断言，建议 5–12 步，slug 用 kebab-case，不要在 prompt.md 中写密钥。每次尝试需新建 runs/<id>/，不得复用；若运行未产生任何步骤应删除该目录。截图不可用单段 astroshot 录像替代。旁白视频为可选，由应用在启用 Settings → Narration 后渲染，智能体本身不调用 TTS。上传 Web 审查需原生支持。部分 UI 标签名称在应用中可能尚未更新，具体以实际为准。