用途:将当前任务的证据持久化为可交互的 HTML 报告,默认采用桌面浏览器布局,除非用户要求,否则不实现或检查响应式/移动端行为。
主要能力:输出到 ./.ai/debriefs/<slug>/index.html,使用已安装的 html-playground 技能;slug 省略时自动生成简短的 kebab-case 主题标识;只写入所选 debrief 目录;若推断的 slug 已存在,则选择无冲突的语义限定词,必要时回退到时间戳后缀,绝不静默覆盖;若用户显式提供 slug 且已存在,则停止并询问是覆盖还是换新 slug。内容仅使用当前任务中真实存在的证据:发现、路径、已验证位置、指标、决策和未解决风险,不编造填充内容。
使用方式:在目标仓库运行捆绑的 preparer:bash <skill-dir>/scripts/prepare.sh <slug>,使用其 PLAYGROUND_DIR、DEBRIEFS_DIR、DEBRIEF_PATH 和 EXISTS 输出。推断 slug 的 EXISTS 为 true 时,派生唯一 slug 并重跑 preparer 再写入;显式 slug 的 EXISTS 为 true 时,按上述询问处理。依赖或 slug 校验错误需原样转达并停止。读取解析后的 HTML playground SKILL.md,并只匹配一个模板:diff review、document critique、code map、concept map、data explorer 或 design playground,将其交互模型适配到证据,不要加载所有模板。构建一个自包含 HTML 文件,包含 playground 的实时控件、有用预设、证据视图、自然语言提示输出和复制反馈,不使用外部依赖。
验证与完成:确认每条声明都可追溯到任务记录或工具证据,输出无占位符,文件能在桌面浏览器渲染;然后运行 open "$DEBRIEF_PATH",以 ### 📊 Debrief ready — <title>、可点击的绝对路径、Opened in desktop browser 以及一行说明证据视图和预设结束。完成条件:所选路径存在非占位符 HTML debrief、内容有证据支撑、成功渲染/检查文件、冲突处理绝不静默覆盖。preparer 的 KEY=VALUE 输出、依赖命令、路径和 slug 错误需保持原样、不加修饰。
限制:仅限当前任务证据;默认桌面布局;不处理移动端;不覆盖已有文件;未提供收费、价格、平台或效果信息。