task-closeout

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Task Closeout

任务收尾

Goal

目标

Create a temporary handoff packet for later learning extraction.

创建一个临时交接包，供后续提取学习经验使用。

Output location

输出位置

Write inside the repo to

.agents/sessions/<session-folder>/

The session folder name is a sortable storage label. The canonical task/session identifier is the

task_id

field inside the bundle's

summary.json

在仓库内的

.agents/sessions/<session-folder>/

目录下写入内容。

会话文件夹名称是一个可排序的存储标签。标准的任务/会话标识符是包内

summary.json

中的

task_id

字段。

Required outputs

必填输出

summary.json
active-task.md
learning-candidate.md
changed-files.txt
validation.txt

summary.json
active-task.md
learning-candidate.md
changed-files.txt
validation.txt

Example bundle

示例包

Filled-in reference files live under

.agents/skills/task-closeout/example/task-bundle/

when this skill is installed under

.agents/skills/task-closeout/

当此技能安装在

.agents/skills/task-closeout/

下时，已填充内容的参考文件位于

.agents/skills/task-closeout/example/task-bundle/

。

Rules

规则

Record only observable facts in active-task.md.
Record only candidate lessons in learning-candidate.md.
Distinguish clearly between what failed, what worked, and what is only a hypothesis.
Do not update
```
.agents/AGENTS.md
```
or any other durable repo knowledge file.
Do not write narrative summaries longer than necessary.
Prefer concise bullet lists.

在active-task.md中仅记录可观察到的事实。
在learning-candidate.md中仅记录候选经验。
明确区分失败内容、成功内容以及仅为假设的内容。
不要更新
```
.agents/AGENTS.md
```
或任何其他可持久化的仓库知识文件。
不要撰写过长的叙述性摘要。
优先使用简洁的项目符号列表。

Procedure

流程

Determine or create
```
repo_id
```
.
Determine or create
```
task_id
```
.
Create a session folder using the pattern
```
YYYYMMDD-HHMMSS-short-topic
```
.
Keep one task-closeout bundle per session folder.
Collect changed files.
Collect commands run and validation results.
Write active-task.md.
Write learning-candidate.md.
Write summary.json with status, metadata,
```
repo_id
```
,
```
task_id
```
, and optional agent identifiers when available.
Mark the session bundle ready for distillation.

确定或创建
```
repo_id
```
。
确定或创建
```
task_id
```
。
使用
```
YYYYMMDD-HHMMSS-short-topic
```
格式创建会话文件夹。
每个会话文件夹仅保留一个任务收尾包。
收集已变更的文件。
收集已执行的命令和验证结果。
编写active-task.md。
编写learning-candidate.md。
编写summary.json，包含状态、元数据、
```
repo_id
```
、
```
task_id
```
，以及可用时的可选Agent标识符。
标记会话包已准备好进行提炼。

Optional agent metadata

可选Agent元数据

Record agent provenance whenever the active tool can supply it. Record session provenance whenever the active tool can supply a stable session identifier.

In
```
summary.json
```
, add
```
agent
```
when the active agent/tool identity is known.
In
```
summary.json
```
, add
```
agent_session_id
```
when the active agent/tool exposes a stable session ID.
In
```
active-task.md
```
, add an Agent section when the agent/tool identity is known.
In
```
active-task.md
```
, add an Agent Session ID section when the active agent/tool exposes a stable session ID.
Treat
```
agent
```
and
```
agent_session_id
```
independently: record either one when available; omit only the specific field/section that is unavailable.
Do not invent session IDs or require manual lookup outside the agent/tool's supported session history.

只要当前工具能够提供，就记录Agent来源信息。只要当前工具能够提供稳定的会话标识符，就记录会话来源信息。

在summary.json中，当已知当前Agent/工具身份时，添加
```
agent
```
字段。
在summary.json中，当当前Agent/工具暴露稳定会话ID时，添加
```
agent_session_id
```
字段。
在active-task.md中，当已知Agent/工具身份时，添加Agent章节。
在active-task.md中，当当前Agent/工具暴露稳定会话ID时，添加Agent Session ID章节。
独立处理
```
agent
```
和
```
agent_session_id
```
：只要有可用信息就记录其中任意一个；仅省略不可用的特定字段/章节。
不要编造会话ID，也不要要求在Agent/工具支持的会话历史之外进行手动查找。

Session folder naming

会话文件夹命名规则

Use a deterministic, sortable folder name such as
```
YYYYMMDD-HHMMSS-short-topic
```
.
Keep the slug short, lowercase, and tied to the task goal.
Reuse the same session folder only for the single task-closeout bundle it was created for.
Do not treat the folder name as the canonical task identity; use the
```
task_id
```
field in
```
summary.json
```
.

使用确定性、可排序的文件夹名称，例如
```
YYYYMMDD-HHMMSS-short-topic
```
。
保持短标签为小写，且与任务目标相关。
仅为创建该文件夹时对应的单个任务收尾包重复使用同一个会话文件夹。
不要将文件夹名称视为标准任务标识；请使用summary.json中的
```
task_id
```
字段。

active-task.md sections

active-task.md章节

Task ID
Agent (optional)
Agent Session ID (optional)
Goal
Outcome
Files Changed
Commands Run
Validation
Remaining Work
Notes

Task ID
Agent（可选）
Agent Session ID（可选）
目标
结果
已变更文件
已执行命令
验证
剩余工作
备注

learning-candidate.md sections

learning-candidate.md章节

Task
What failed
What worked
Reusable pattern
Candidate
```
.agents/AGENTS.md
```
update
Candidate troubleshooting note
Candidate repo decision
Candidate playbook
Confidence

任务
失败内容
成功内容
可复用模式
候选
```
.agents/AGENTS.md
```
更新内容
候选故障排除说明
候选仓库决策
候选操作手册
置信度