用途:把当前任务中的证据持久化为报告。默认生成带交互的 HTML 报告,使用已安装的 playground 技能;加 --md 则生成简洁 Markdown,不依赖 playground。
主要能力:默认输出 ./.ai/debriefs/<slug>/index.html;--md 输出 ./.ai/debriefs/<slug>/index.md。省略 slug 时自动生成简短的 kebab-case 主题名。只允许写入所选 debrief 目录;若输出已存在,会停止并询问覆盖还是换 slug。内容只能使用当前任务中真实存在的证据,如发现、路径、已验证位置、指标、决策和未解决风险,不得编造填充内容。
使用方式:在目标仓库运行 bash <skill-dir>/scripts/prepare.sh [--md] <slug>,使用其 MODE、PLAYGROUND_DIR、DEBRIEF_PATH、EXISTS 输出;遇到依赖或 slug 错误需转达并停止。HTML 模式需读取解析出的 playground SKILL.md,并只选一个匹配模板(diff review、document critique、code map、concept map、data explorer 或 design playground),把其交互模型适配到证据上,不要加载全部模板。最终构建单个自包含文件:HTML 保留实时控件、预设、证据视图、自然语言提示输出和复制反馈,无外部依赖;Markdown 先给结论,再列带严重程度/证据/建议的发现和可执行下一步,仅在精确文本重要时使用片段。
验证与完成:确认每条声明可追溯到任务记录或工具证据、无占位符、文件可打开或渲染,然后运行 open "$DEBRIEF_PATH" 并报告绝对路径。完成条件为所选路径存在非占位 debrief、内容有证据支撑、渲染或文件检查成功,并显式处理覆盖。
限制:仅限当前任务证据;只写入所选目录;输出已存在时必须先确认;HTML 依赖 playground 技能,Markdown 无此依赖。