work-brief
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseWork 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 for a resumable agent-to-agent transfer.
handoff
- 默认:总结当前本地差异;如果不存在本地差异,则总结当前分支与已解析的基准分支之间的差异。
- 如果操作者提供了commit、分支、PR文本、工单ID或主题,尽可能以此为目标进行总结。
- 本内容面向人类操作者,而非其他Agent。若需Agent间可恢复的交接,请使用。
handoff
Steps
步骤
- Inspect , current branch, recent commits, staged diff, unstaged diff, and untracked files.
git status --short - If no local diff exists, resolve the base branch via , remote HEAD, then
.turkit.yaml → base_branch; compare base to current branch.main - Read and apply the configured output language/style.
references/output-preferences.md - Read only the files needed to explain the main behavior, important decisions, verification evidence, and current state.
- Group the work into 2-4 meaningful pieces. Prefer product/domain boundaries over file types.
- Link only the key files. Do not list every changed file.
- 检查、当前分支、近期commit、暂存区差异、未暂存区差异以及未跟踪文件。
git status --short - 如果不存在本地差异,通过、远程HEAD,最后是
.turkit.yaml → base_branch来解析基准分支;对比基准分支与当前分支。main - 阅读并应用配置的输出语言/风格。
references/output-preferences.md - 仅读取解释主要行为、重要决策、验证证据和当前状态所需的文件。
- 将工作分为2-4个有意义的部分。优先按产品/领域边界划分,而非文件类型。
- 仅链接关键文件。不要列出所有已更改的文件。
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
- <piece name> - <short explanation> - Fichiers: [path](path), [path](path)
- <piece name> - <short explanation> - Fichiers: [path](path)
- <piece name> - <short explanation> - Fichiers: [path](path), [path](path)
- <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 for operator-facing language/style.
references/output-preferences.md- 只读操作:不要执行暂存、提交、推送、编辑、创建分支、更新工单或创建PR等操作。
- 不要输出冗长的审计内容、完整代码导览或逐文件说明。
- 除非从当前会话、日志或仓库状态中获得明确证据,否则不要声称测试/检查/评审已通过。
- 不要编造更改的原因。如果意图不明确,请说明“从差异中无法看出”。
- 最多链接3-8个重要文件。如果某文件的特定行很重要且已知,请链接该行。
- 如果内容过多无法在一屏显示,请总结核心部分并以结尾。
Open next: <file or command>
应用中面向操作者的语言/风格要求。
references/output-preferences.md