关于 debrief
debrief 是一项任务技能，可将当前任务中的证据整理成交互式 HTML 报告或简洁的 Markdown。它规定报告制作、证据核验和成品检查流程。
主要功能
- 01生成交互式 HTML 报告
- 02支持精简 Markdown 模式
- 03自动生成主题 slug
- 04核验内容是否有证据
- 05限制输出位置并处理覆盖
适用场景
- 01记录已核实的发现与风险
- 02审查代码或文档变更
- 03以 Markdown 分享任务结论
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/debrief确认已加载。
附带文件agents/openai.yamlscripts/prepare.sh
详细介绍
复盘
将当前任务中的证据保存为一份观点鲜明、可交互的 HTML 报告，或使用 --md 保存为简洁的 Markdown。
输出与权限
- 默认：使用已安装的
playground技能，保存到./.ai/debriefs/<slug>/index.html。 --md：保存到./.ai/debriefs/<slug>/index.md，无需依赖playground。- 如果未提供 slug，则根据主题生成一个简短的 kebab-case slug。
- 仅在选定的复盘目录中写入。如果输出已存在，请停止并询问是覆盖还是选择新的 slug。
- 仅使用当前任务中已有的证据：真实发现、路径、已验证的位置、指标、决策和未解决的风险。不要编造填充内容。
工作流
-
从目标仓库运行捆绑的准备程序：
bash <skill-dir>/scripts/prepare.sh [--md] <slug>使用其
MODE、PLAYGROUND_DIR、DEBRIEF_PATH和EXISTS输出。如果出现依赖项或 slug 错误，请转达错误并停止。 -
对于 HTML，读取已解析的 playground
SKILL.md，并且只读取一个匹配的模板：差异审查、文档评析、代码地图、概念地图、数据探索器或设计 playground。根据证据调整其交互模式；不要加载所有模板。 -
构建一个独立文件：
- HTML 保留 playground 的实时控件、实用预设、证据视图、自然语言提示词输出和复制反馈。不依赖外部资源。
- Markdown 先给出结论，然后列出简洁的发现，并注明严重程度／证据／建议以及可执行的后续步骤。只有在精确文本很重要时才使用代码片段。
-
验证每项声明都能追溯到任务记录或工具证据，输出中不含占位符，并且文件能够打开／渲染。然后运行
open "$DEBRIEF_PATH"并报告绝对路径。
完成任务必须满足以下要求：在选定路径生成非占位内容的复盘，内容以证据为依据，成功完成渲染／文件检查，并明确处理覆盖问题。
评论
支持 Markdown