work-brief

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Work Brief

工作简报

Explain the work produced in this session so the operator can regain context and decide what to do next.
说明本次会话完成的工作,以便操作者恢复上下文并决定下一步行动。

Scope

适用范围

  • Default: summarize the current local diff; if no local diff exists, summarize the current branch versus the resolved base branch.
  • If the operator passes a commit, branch, PR text, ticket id, or topic, use that as the target when possible.
  • This is for the human operator, not another agent. Use
    handoff
    for a resumable agent-to-agent transfer.
  • 默认:总结当前本地差异;如果不存在本地差异,则总结当前分支与已解析的基准分支之间的差异。
  • 如果操作者提供了commit、分支、PR文本、工单ID或主题,尽可能以此为目标进行总结。
  • 本内容面向人类操作者,而非其他Agent。若需Agent间可恢复的交接,请使用
    handoff

Steps

步骤

  1. Inspect
    git status --short
    , current branch, recent commits, staged diff, unstaged diff, and untracked files.
  2. If no local diff exists, resolve the base branch via
    .turkit.yaml → base_branch
    , remote HEAD, then
    main
    ; compare base to current branch.
  3. Read
    references/output-preferences.md
    and apply the configured output language/style.
  4. Read only the files needed to explain the main behavior, important decisions, verification evidence, and current state.
  5. Group the work into 2-4 meaningful pieces. Prefer product/domain boundaries over file types.
  6. Link only the key files. Do not list every changed file.
  1. 检查
    git status --short
    、当前分支、近期commit、暂存区差异、未暂存区差异以及未跟踪文件。
  2. 如果不存在本地差异,通过
    .turkit.yaml → base_branch
    、远程HEAD,最后是
    main
    来解析基准分支;对比基准分支与当前分支。
  3. 阅读
    references/output-preferences.md
    并应用配置的输出语言/风格。
  4. 仅读取解释主要行为、重要决策、验证证据和当前状态所需的文件。
  5. 将工作分为2-4个有意义的部分。优先按产品/领域边界划分,而非文件类型。
  6. 仅链接关键文件。不要列出所有已更改的文件。

Output

输出格式

Respond using the configured output language. Aim for one screen, roughly 25-45 lines. Use this shape:
markdown
<ticket or subject> fait. Voilà l'essentiel :
使用配置的输出语言进行响应。目标为一屏内容,约25-45行。采用以下格式:
markdown
<ticket or subject> fait. Voilà l'essentiel :

Quoi

Quoi

<3-5 lines: what was built/changed, not a file list>
<3-5 lines: what was built/changed, not a file list>

Pourquoi

Pourquoi

<2-4 lines: pain solved, goal, or tradeoff. If not visible, say so.>
<2-4 lines: pain solved, goal, or tradeoff. If not visible, say so.>

Les morceaux

Les morceaux

  1. <piece name> - <short explanation> - Fichiers: [path](path), [path](path)
  2. <piece name> - <short explanation> - Fichiers: [path](path)
  1. <piece name> - <short explanation> - Fichiers: [path](path), [path](path)
  2. <piece name> - <short explanation> - Fichiers: [path](path)

Qualité

Qualité

  • Tests/checks: <commands and results, or "not run / not visible">
  • Review: <done / not done / not visible>
  • Risque: <one concrete remaining risk>
  • Tests/checks: <commands and results, or "not run / not visible">
  • Review: <done / not done / not visible>
  • Risque: <one concrete remaining risk>

État

État

  • Branche: <branch>
  • Commit/PR: <hash/URL or "not yet">
  • Ticket: <id/status or "not detected">
  • Next: <one logical next action>

For English conversations, translate the headings naturally (`What`, `Why`, `Pieces`, `Quality`, `State`).
  • Branche: <branch>
  • Commit/PR: <hash/URL or "not yet">
  • Ticket: <id/status or "not detected">
  • Next: <one logical next action>

对于英文对话,需将标题自然翻译为英文(`What`, `Why`, `Pieces`, `Quality`, `State`)。

Guardrails

约束规则

  • Read-only: do not stage, commit, push, edit, create branches, update tickets, or create PRs.
  • Do not output a long audit, full code tour, or file-by-file walkthrough.
  • Do not claim tests/checks/reviews passed unless there is explicit evidence from the current session, logs, or repo state.
  • Do not invent why a change was made. If intent is not visible, say "not obvious from the diff".
  • Keep links to 3-8 important files max. If a file line matters and is known, link the line.
  • If the work is too large for one screen, summarize the top pieces and end with
    Open next: <file or command>
    .
Apply
references/output-preferences.md
for operator-facing language/style.
  • 只读操作:不要执行暂存、提交、推送、编辑、创建分支、更新工单或创建PR等操作。
  • 不要输出冗长的审计内容、完整代码导览或逐文件说明。
  • 除非从当前会话、日志或仓库状态中获得明确证据,否则不要声称测试/检查/评审已通过。
  • 不要编造更改的原因。如果意图不明确,请说明“从差异中无法看出”。
  • 最多链接3-8个重要文件。如果某文件的特定行很重要且已知,请链接该行。
  • 如果内容过多无法在一屏显示,请总结核心部分并以
    Open next: <file or command>
    结尾。
应用
references/output-preferences.md
中面向操作者的语言/风格要求。