debrief

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Write a Debrief

编写 Debrief

A debrief is a run's last message. The run ends here: you write it, the user reads it.
A run that was handed its answers by a caller is one leg of a wider span — its lines go up to that caller, and the caller's debrief closes.
debrief 是 run 的最后一条消息。run 到此结束:由你撰写,用户阅读。
一个由调用方提供答案的 run,是更广泛的 span 中的一条支线——其各行上溯至该调用方,并由调用方的 debrief 收尾。

The three parts

三个部分

Walk the span back to collect them. Each part carries its lines, or the word
none
.
  1. Built — what the run produced, one line per task or ticket, and the state the suite was left in: the last full run and its result.
  2. Assumed — every
    Assumed:
    sentence written during the run, in the words you wrote it.
  3. Standing — every break left in place, each at
    file_path:line_number
    , with why it stayed: it was already red before you started, or the fix sits outside the task.
回溯整个 span 以收集这些内容。每个部分列出其对应的各行;如果没有,则写上
none
。
  1. Built——run 产出了什么,每项任务或工单占一行;同时说明测试套件所处的状态:最近一次完整运行及其结果。
  2. Assumed——run 期间写下的每一条
    Assumed:
    ,保留当时的原话。
  3. Standing——每一个仍未解决的问题,每项使用
    file_path:line_number
    格式,并说明它为何被保留:在你开始之前它就已经是红色,或修复不在当前任务范围内。

Every line is a statement

每一行都是一个陈述

A question you find yourself writing is a decision you already made: the reading goes under Assumed, the work you left goes under Standing. An assumption the user would rather flip, or a break they want cleared, comes back later as its own task.
Written when: every assumption carried since the briefing is listed, every finding the run's reviews turned up is either fixed or standing here with its reason, and the debrief has gone out as the run's last message — or up to the caller whose span it closes.
如果你发现自己想写的是一个问题,那就说明你已经做出了决定:相关解读归入 Assumed,未完成的工作归入 Standing。如果用户希望推翻某项假设,或希望清除某个问题,之后会将其作为独立任务重新处理。
写入时机:自 briefing 以来 carried 的每项假设均已列出;run 的各项 review 发现的每个问题,要么已经修复,要么作为 Standing 保留在此并附上原因;并且 debrief 已作为 run 的最后一条消息发出——直接发给用户,或发给其 span 所收束的上级调用方。