save-conversation

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Save Conversation

保存对话

Write a conversation recap to
.agent-state/conversations/<conversation>.md
.
将会话摘要写入
.agent-state/conversations/<conversation>.md

Identity

标识

Resolve the conversation id:
  1. Explicit
    --conversation <name>
    (always create new conversations this way)
  2. .agent-state/ACTIVE_CONVERSATION
  3. CODEX_THREAD_ID
    (Codex runtime)
  4. Current branch name (last resort)
Treat any text after the conversation name as
next_focus
— write it as
## Next Focus
.
解析会话ID:
  1. 显式指定
    --conversation <name>
    (始终通过此方式创建新会话)
  2. .agent-state/ACTIVE_CONVERSATION
  3. CODEX_THREAD_ID
    (Codex 运行时)
  4. 当前分支名称(最后手段)
将会话名称后的任何文本视为
next_focus
—— 将其写入为
## Next Focus

Structure

结构

Stable summary (rewrite every save)

稳定摘要(每次保存时重写)

  • Conversation Summary
    — 1-3 sentences covering the whole conversation
  • Current Objective
    — a single current target
  • Key Decisions
    — only decisions that still matter
  • Constraints
    — only active constraints
  • Open Questions
    — only unresolved
  • Conversation Summary
    —— 1-3句话概述整个对话
  • Current Objective
    —— 单个当前目标
  • Key Decisions
    —— 仅保留仍有意义的决策
  • Constraints
    —— 仅保留当前生效的约束条件
  • Open Questions
    —— 仅保留未解决的问题

Action layer

操作层

  • Active Tasks
    — task-grouped checklists. Simple tasks inline; complex tasks reference
    .planning/conversations/<id>/<task>/
  • Known Issues
  • Key Context
  • Active Tasks
    —— 按任务分组的清单。简单任务直接内联;复杂任务引用
    .planning/conversations/<id>/<task>/
  • Known Issues
  • Key Context

Constraints

约束条件

  • Do not duplicate. If information already lives in
    .planning/
    ,
    AGENTS.md
    ,
    .proposal/
    , or
    .research/
    , reference the path — don't copy the content.
  • Merge, don't append. When new information arrives, fold it into existing summaries instead of adding raw recent context.
  • Compress aggressively. The file should fit in a single screen of context.
  • 请勿重复。 如果信息已存在于
    .planning/
    AGENTS.md
    .proposal/
    .research/
    中,请引用路径——不要复制内容。
  • 合并而非追加。 当有新信息时,将其整合到现有摘要中,而非添加原始的近期上下文。
  • 高度压缩。 文件内容应适配单屏上下文显示。