@jennie-shawn/starwork 0.1.0-alpha.2 → 0.1.0-alpha.21

package/docs/multiagent/04-claude-code-session-management-research-instructions.md

@@ -0,0 +1,209 @@
+# Claude Code 会话管理能力调研指令
+
+## 基本信息
+
+- 日期：2026-06-02
+- 优先级：中
+- 用途：把本文复制或引用给 Claude Code，让 Claude Code 在自己的原生 CLI / IDE 集成环境中实测会话管理能力。
+- 目标：获得可用于 StarWork `multiagent` / Agent Lanes 适配设计的 Claude Code 会话管理能力矩阵。
+
+## 调研前提
+
+这不是调研 Claude Code 的编码能力，也不是调研 Claude 模型能力。
+
+本次只关心 Claude Code 如何管理“会话 / conversation / transcript / project context / resume / memory”：
+
+- 能不能识别当前会话。
+- 能不能获得稳定会话 ID。
+- 能不能重命名当前会话。
+- 能不能列出历史会话。
+- 能不能读取、恢复、继续、导出、删除、归档或置顶会话。
+- 能不能将历史会话或 transcript 作为新会话上下文。
+- CLI、配置文件、本地 transcript、IDE 集成和 slash commands 是否提供可用入口。
+
+## 给 Claude Code 的调研 Prompt
+
+下面这段可以直接复制到 Claude Code 的新会话中执行：
+
+```text
+你现在运行在 Claude Code 原生环境里。请帮我调研 Claude Code 的“会话管理能力”，不要调研编码能力或模型能力。
+
+背景：
+我正在设计 StarWork 的 multiagent / Agent Lanes 功能。StarWork 会把多个 AI 会话登记为不同职责位 lane，并需要知道宿主工具是否支持会话识别、命名、恢复、历史读取、导出、归档等能力。
+
+请你在当前 Claude Code 环境中尽量实测，而不是只凭公开文档回答。可以使用 Claude Code CLI、slash commands、help、配置文件、可安全读取的本地 transcript / project state / logs、IDE 集成说明等方式调查。但不要修改私有数据库，不要删除真实历史，不要做不可逆操作。
+
+请按以下能力逐项调研，并给出证据来源：
+
+1. 当前会话识别
+- Claude Code 是否能显示当前会话 / conversation / transcript 的唯一 ID？
+- 是否存在环境变量、CLI 命令、slash command、本地 transcript 文件名或元数据能表示当前会话？
+- 该 ID 是否跨重启稳定？
+- 是否适合作为 StarWork 的 `claude-code:<session-id>`？
+- 如果没有稳定 ID，推荐 StarWork 如何生成人工 session id？
+
+2. 当前会话命名 / 改名
+- Claude Code 当前会话是否支持手动标题或名称？
+- 是否有 slash command、CLI、IDE UI 或配置入口可改名？
+- 改名后是否会影响历史列表、transcript 文件名或 IDE 展示？
+- 是否存在可安全程序化改名的入口？
+- 是否能安全实现类似 Codex `thread/name/set` 的 adapter？
+
+3. 会话列表
+- Claude Code 是否能列出历史会话 / conversations / transcripts？
+- 入口在哪里？例如 CLI 命令、resume picker、slash command、本地 transcript 目录、IDE 面板。
+- 是否支持搜索、筛选、按项目区分、按时间排序？
+- 是否能通过 CLI/API/本地文件程序化列出？
+- 会话列表是否只限当前项目，还是跨项目？
+
+4. 会话读取
+- 历史会话能否完整打开查看？
+- 是否可以读取完整消息、工具调用、文件修改、终端输出、计划、附件或截图？
+- 本地 transcript 是否是 JSON、JSONL、Markdown、纯文本或其他格式？
+- transcript 是否包含时间、cwd、模型、工具调用、用户消息、assistant 消息和文件路径？
+- 是否能通过本地文件安全读取？是否有隐私或稳定性风险？
+
+5. 会话继续 / resume
+- Claude Code 是否支持 resume 历史会话？
+- resume 入口是什么？例如命令、参数、slash command、交互式选择器。
+- resume 后模型是否获得旧会话完整上下文，还是只获得摘要？
+- 是否支持从指定 transcript / session id resume？
+- 是否支持向某个非当前会话发送 follow-up prompt？
+- 该能力是否适合 StarWork 的 `multiagent continue <lane>`？
+
+6. 会话导出
+- 是否支持导出当前或历史会话？
+- 导出入口在哪里？
+- 导出格式是什么？
+- 如果没有官方导出，是否可以安全复制或读取 transcript 文件？
+- 导出内容是否适合放入 StarWork lane workspace，例如 `_系统/协作/lanes/<lane-id>/workspace/`？
+- 是否支持批量导出？
+
+7. 会话删除、归档、置顶
+- 是否支持删除历史会话？是否可恢复？
+- 是否支持归档 archive，而不是删除？
+- 是否支持置顶 pin/favorite/star？
+- 这些能力是否有 UI、CLI、slash command 或可编程入口？
+- 哪些能力适合映射到 StarWork `release` 后的宿主清理动作？
+
+8. 项目上下文与记忆
+- Claude Code 是否有项目级 memory / instructions / CLAUDE.md / settings？
+- 当前会话如何读取项目说明？
+- 项目级记忆和会话历史是什么关系？
+- `CLAUDE.md` 或类似文件是否适合承载 StarWork lane 使用规则？
+- 这些能力能否帮助新会话恢复某个 lane 的工作？
+
+9. 长会话上下文管理
+- Claude Code 是否有 compact / summarize / context compression 能力？
+- 是否有手动触发命令？
+- compact 后旧消息是否仍可查看？
+- resume 后是否使用 compact summary？
+- StarWork 是否仍需要 worklog 来做显式交接？
+
+10. 多会话并行
+- Claude Code 是否支持多个终端 / IDE 会话同时打开同一项目？
+- 多会话是否有独立 transcript？
+- 是否能区分每个会话的职责或标题？
+- 多会话同时编辑同一文件时，Claude Code 如何避免或提示冲突？
+- 这对 StarWork lane write_scope 有什么补充或限制？
+
+11. 权限、工具和工作目录状态
+- Claude Code 会话是否记录工具权限、approval mode、sandbox、cwd、git branch 等状态？
+- resume 后这些状态是否恢复？
+- StarWork 绑定 lane 时是否需要记录这些宿主状态？
+- 哪些状态应只作为 adapter cache，不应进入 Core 必填事实源？
+
+12. Claude Code CLI / API / 本地存储
+- Claude Code 是否提供 CLI 管理 session/history/transcript？
+- 是否有官方 API 管理普通会话？
+- 本地会话存储路径是什么？
+- 读取这些文件是否安全？是否可能破坏 Claude Code 状态？
+- StarWork adapter 是否应该依赖这些内部存储？请给出风险判断。
+
+请最终输出：
+
+A. 一张能力矩阵，列为：
+能力 / UI 或 CLI 支持 / 可编程支持 / 稳定性 / 适配 StarWork 建议 / 证据
+
+B. 一段结论：
+- Claude Code 中哪些能力可直接适配 StarWork？
+- 哪些只能人工操作？
+- 哪些不支持或不建议依赖？
+- StarWork 在 Claude Code 中应该如何生成 `session_id`？
+- `multiagent bind --session-name` 在 Claude Code 中应支持、降级还是跳过？
+- Claude Code 是否适合实现 `multiagent status --host`、`multiagent continue <lane>`、`multiagent release --archive-session`？
+
+C. 一个建议工作流：
+如何在 Claude Code 中把一个当前会话登记为 StarWork lane，并完成后续交接。
+
+请明确标注你的 Claude Code 版本、操作系统、调研日期。
+```
+
+## StarWork 需要的能力矩阵模板
+
+Claude Code 输出时建议使用这个表：
+
+| 能力 | UI 或 CLI 支持 | 可编程支持 | 稳定性 | StarWork 适配建议 | 证据 |
+|---|---|---|---|---|---|
+| 获取当前会话 ID | 待测 | 待测 | 待测 | 待测 | 入口/路径/命令 |
+| 当前会话改名 | 待测 | 待测 | 待测 | 待测 | 入口/路径/命令 |
+| 列出历史会话 | 待测 | 待测 | 待测 | 待测 | 入口/路径/命令 |
+| 读取历史会话 | 待测 | 待测 | 待测 | 待测 | 入口/路径/命令 |
+| resume 历史会话 | 待测 | 待测 | 待测 | 待测 | 入口/路径/命令 |
+| 向非当前会话发送 follow-up | 待测 | 待测 | 待测 | 待测 | 入口/路径/命令 |
+| 导出会话 | 待测 | 待测 | 待测 | 待测 | 入口/路径/命令 |
+| 删除会话 | 待测 | 待测 | 待测 | 待测 | 入口/路径/命令 |
+| 归档会话 | 待测 | 待测 | 待测 | 待测 | 入口/路径/命令 |
+| 置顶会话 | 待测 | 待测 | 待测 | 待测 | 入口/路径/命令 |
+| transcript 本地存储 | 待测 | 待测 | 待测 | 待测 | 入口/路径/命令 |
+| 项目级 memory / CLAUDE.md | 待测 | 待测 | 待测 | 待测 | 入口/路径/命令 |
+| compact / summarize | 待测 | 待测 | 待测 | 待测 | 入口/路径/命令 |
+| 多会话并行 | 待测 | 待测 | 待测 | 待测 | 入口/路径/命令 |
+| 权限和工作目录状态恢复 | 待测 | 待测 | 待测 | 待测 | 入口/路径/命令 |
+
+## StarWork 适配判断标准
+
+### 可直接适配
+
+满足以下任一条件：
+
+- 有稳定官方 CLI / API。
+- 有稳定 UI 或 CLI 操作，且 StarWork 只需要给用户提示，不需要自动化。
+- 有安全 transcript 或导出格式，可以进入 lane workspace。
+
+### 只能降级适配
+
+满足以下任一条件：
+
+- 只有交互式 UI，没有可编程入口。
+- 有本地存储，但不是官方接口。
+- 能手动完成，但无法由 StarWork CLI 稳定执行。
+
+### 不建议适配
+
+满足以下任一条件：
+
+- 需要直接改写 Claude Code 私有数据库或 transcript。
+- 删除不可恢复。
+- 能力依赖不稳定实验 UI。
+- 会破坏用户历史、权限状态或隐私。
+
+## 调研产物落地建议
+
+Claude Code 完成调研后，把结果保存为：
+
+```text
+product/docs/multiagent/claude-code-session-management-research-result.md
+```
+
+如果调研中产生 transcript 样例、导出文件或命令输出，不要放根目录；优先放：
+
+```text
+_系统/协作/lanes/capability-research/workspace/
+```
+
+或经确认后放入：
+
+```text
+product/docs/multiagent/assets/
+```

package/docs/multiagent/05-trae-solo-session-management-research-instructions.md

@@ -0,0 +1,222 @@
+# Trae Solo App 会话管理能力调研指令
+
+## 基本信息
+
+- 日期：2026-06-02
+- 优先级：低
+- 用途：把本文复制或引用给 Trae Solo App，让 Trae Solo 在自己的原生 App 环境中实测会话、项目和历史管理能力。
+- 目标：获得可用于 StarWork `multiagent` / Agent Lanes 适配设计的 Trae Solo App 会话管理能力矩阵。
+
+## 调研前提
+
+这不是调研 Trae IDE，也不是调研 Trae Solo 的产品生成能力、页面生成质量或模型能力。
+
+本次只关心 Trae Solo App 如何管理“会话 / app project / solo project / task / run / history / artifact”：
+
+- 能不能识别当前 Solo 项目或当前聊天会话。
+- 能不能获得稳定项目 ID、会话 ID、任务 ID 或 run ID。
+- 能不能重命名项目或会话。
+- 能不能列出历史项目、历史会话、历史任务。
+- 能不能读取、恢复、继续、导出、删除、归档或置顶项目/会话。
+- Solo 的聊天、需求、计划、生成记录、产物和版本是否属于同一个历史系统。
+- 这些能力是否有 UI、App 内入口、URL、API、本地文件或云端项目标识。
+
+## 给 Trae Solo App 的调研 Prompt
+
+下面这段可以直接复制到 Trae Solo App 的新会话或当前项目中执行：
+
+```text
+你现在运行在 Trae Solo App 原生环境里。请帮我调研 Trae Solo App 的“会话、项目和历史管理能力”，不要调研页面生成能力、编码执行能力或模型能力。
+
+背景：
+我正在设计 StarWork 的 multiagent / Agent Lanes 功能。StarWork 会把多个 AI 会话登记为不同职责位 lane，并需要知道宿主工具是否支持会话识别、命名、恢复、历史读取、导出、归档等能力。Trae Solo App 可能不是 IDE chat，而是围绕 app/project/task/run 管理工作，因此请同时调研“项目级”和“会话级”的标识与历史。
+
+请你在当前 Trae Solo App 环境中尽量实测，而不是只凭公开文档回答。可以使用 Trae Solo UI、项目列表、历史记录、设置、帮助文档、URL、导出入口、可安全读取的本地缓存/日志等方式调查。但不要删除真实项目或历史，不要修改私有数据库，不要做不可逆操作。
+
+请按以下能力逐项调研，并给出证据来源：
+
+1. 当前项目 / 会话识别
+- Trae Solo 是否能显示当前 app project / solo project 的唯一 ID？
+- 是否能显示当前 chat / task / run 的唯一 ID？
+- ID 是否出现在 URL、分享链接、项目设置、导出文件、日志或本地缓存中？
+- 项目 ID、会话 ID、任务 ID、run ID 是否是不同概念？
+- 这些 ID 是否跨重启、跨设备、跨浏览器稳定？
+- 哪个 ID 最适合作为 StarWork 的 `trae-solo:<session-id>`？
+
+2. 当前项目 / 会话命名
+- Trae Solo 是否支持重命名项目？
+- 是否支持重命名单个会话、任务、run 或生成记录？
+- 改名入口在哪里？
+- 改名后项目列表、历史列表、分享页或导出文件是否同步显示新名称？
+- 是否存在 API、URL 参数、本地状态入口或自动化方式可程序化改名？
+- 是否能安全实现类似 Codex `thread/name/set` 的 adapter？
+
+3. 项目列表与历史列表
+- Trae Solo 是否有项目列表、最近项目、历史项目或 dashboard？
+- 是否能列出一个项目下的历史会话、需求、任务、run、版本或生成记录？
+- 是否支持搜索、筛选、按项目/时间/状态排序？
+- 是否能区分草稿、已发布、已完成、失败、归档项目？
+- 是否能通过 URL/API/本地文件程序化列出？
+
+4. 历史读取
+- 是否能打开历史项目或历史会话查看完整内容？
+- 历史中是否包含用户需求、AI 回复、计划、生成步骤、文件/页面改动、预览截图、运行日志、错误修复记录？
+- 是否能看到每一次生成或修改的版本差异？
+- 是否能读取或复制完整历史文本？
+- 是否能通过本地文件、云端 API 或导出文件安全读取？
+
+5. 继续 / 恢复历史项目
+- 打开历史项目后是否可以继续追加需求？
+- 继续时模型是否获得旧项目完整上下文，还是只保留当前产物状态？
+- 是否可以从某个历史 run / version 继续？
+- 是否可以 fork / duplicate 一个历史项目继续？
+- 是否支持向非当前项目或非当前会话发送 follow-up prompt？
+- 该能力是否适合 StarWork 的 `multiagent continue <lane>`？
+
+6. 导出与分享
+- Trae Solo 是否支持导出项目、代码、设计稿、需求记录或聊天记录？
+- 是否支持导出当前或历史会话？
+- 导出入口在哪里？
+- 导出格式是什么？例如 zip、GitHub repo、Markdown、JSON、HTML、图片、链接。
+- 分享链接是否包含稳定项目 ID 或 run ID？
+- 导出内容是否适合放入 StarWork lane workspace，例如 `_系统/协作/lanes/<lane-id>/workspace/`？
+- 是否支持批量导出？
+
+7. 删除、归档、置顶、收藏
+- 是否支持删除项目或会话？是否可恢复？
+- 是否支持归档 archive，而不是删除？
+- 是否支持置顶 pin、收藏 favorite、star 或固定项目？
+- 是否支持隐藏项目或从最近列表移除？
+- 这些能力是否有 UI 或可编程入口？
+- 哪些能力适合映射到 StarWork `release` 后的宿主清理动作？
+
+8. 项目版本、checkpoint 与 rollback
+- Trae Solo 是否保存项目版本或 checkpoint？
+- 是否能恢复到某个历史版本、run 或生成步骤？
+- rollback 是否可撤销？
+- checkpoint 是否跨重启保留？
+- checkpoint 与聊天历史是同一个系统还是两个系统？
+- 版本 ID 是否可被 StarWork 记录为 shared output 或 lane workspace 元数据？
+
+9. 需求、计划、产物和聊天的边界
+- Trae Solo 中“需求描述”“AI 计划”“生成步骤”“产物预览”“聊天记录”是否是同一条会话的一部分？
+- 如果修改需求，旧需求和旧计划是否保留？
+- 项目产物是否能脱离聊天历史单独存在？
+- 新会话继续同一个项目时，是否能读取旧聊天？
+- 这些边界对 StarWork lane worklog 有什么影响？
+
+10. 长会话 / 长项目上下文管理
+- Trae Solo 是否会自动摘要长项目或长聊天？
+- 是否有手动摘要、项目总结、handoff、report 入口？
+- 旧消息是否仍可查看？
+- 继续历史项目时模型依赖完整历史、摘要，还是当前产物状态？
+- StarWork 是否仍需要 worklog 来做显式交接？
+
+11. 多项目 / 多会话并行
+- Trae Solo 是否支持同时打开多个项目或多个会话？
+- 多项目是否有独立历史、独立预览、独立导出？
+- 是否能在同一项目中开多个并行任务？
+- 多个会话同时修改同一项目时，Trae Solo 如何处理冲突？
+- 这对 StarWork lane write_scope 有什么补充或限制？
+
+12. API / URL / 本地存储
+- Trae Solo 是否提供官方 API 管理项目、会话、历史、导出或分享？
+- URL 中是否包含稳定 project/session/run 标识？
+- 本地是否有可读缓存、日志或配置？路径是什么？
+- Trae Solo 是否主要云端存储？离线时历史是否可用？
+- 读取本地或云端数据是否安全？是否可能破坏 Trae Solo 状态？
+- StarWork adapter 是否应该依赖这些内部存储或 URL？请给出风险判断。
+
+请最终输出：
+
+A. 一张能力矩阵，列为：
+能力 / UI 支持 / 可编程支持 / 稳定性 / 适配 StarWork 建议 / 证据
+
+B. 一段结论：
+- Trae Solo App 中哪些能力可直接适配 StarWork？
+- 哪些只能人工操作？
+- 哪些不支持或不建议依赖？
+- StarWork 在 Trae Solo 中应该如何生成 `session_id`？应该用项目 ID、会话 ID、任务 ID 还是人工 ID？
+- `multiagent bind --session-name` 在 Trae Solo 中应支持、降级还是跳过？
+- Trae Solo 是否适合实现 `multiagent status --host`、`multiagent continue <lane>`、`multiagent release --archive-session`？
+
+C. 一个建议工作流：
+如何在 Trae Solo App 中把一个当前项目或当前会话登记为 StarWork lane，并完成后续交接。
+
+请明确标注你的 Trae Solo App 版本、运行环境、调研日期。
+```
+
+## StarWork 需要的能力矩阵模板
+
+Trae Solo App 输出时建议使用这个表：
+
+| 能力 | UI 支持 | 可编程支持 | 稳定性 | StarWork 适配建议 | 证据 |
+|---|---|---|---|---|---|
+| 获取当前项目 ID | 待测 | 待测 | 待测 | 待测 | 入口/URL/截图/路径 |
+| 获取当前会话 / task / run ID | 待测 | 待测 | 待测 | 待测 | 入口/URL/截图/路径 |
+| 项目改名 | 待测 | 待测 | 待测 | 待测 | 入口/URL/截图/路径 |
+| 会话 / run 改名 | 待测 | 待测 | 待测 | 待测 | 入口/URL/截图/路径 |
+| 列出历史项目 | 待测 | 待测 | 待测 | 待测 | 入口/URL/截图/路径 |
+| 列出项目内历史会话 / run | 待测 | 待测 | 待测 | 待测 | 入口/URL/截图/路径 |
+| 读取历史内容 | 待测 | 待测 | 待测 | 待测 | 入口/URL/截图/路径 |
+| 继续历史项目 / 会话 | 待测 | 待测 | 待测 | 待测 | 入口/URL/截图/路径 |
+| fork / duplicate 项目 | 待测 | 待测 | 待测 | 待测 | 入口/URL/截图/路径 |
+| 导出项目 / 代码 / 历史 | 待测 | 待测 | 待测 | 待测 | 入口/URL/截图/路径 |
+| 分享链接 | 待测 | 待测 | 待测 | 待测 | 入口/URL/截图/路径 |
+| 删除项目 / 会话 | 待测 | 待测 | 待测 | 待测 | 入口/URL/截图/路径 |
+| 归档项目 / 会话 | 待测 | 待测 | 待测 | 待测 | 入口/URL/截图/路径 |
+| 置顶 / 收藏项目 | 待测 | 待测 | 待测 | 待测 | 入口/URL/截图/路径 |
+| checkpoint / rollback | 待测 | 待测 | 待测 | 待测 | 入口/URL/截图/路径 |
+| 长项目摘要 / handoff | 待测 | 待测 | 待测 | 待测 | 入口/URL/截图/路径 |
+| API / URL 稳定标识 | 待测 | 待测 | 待测 | 待测 | 入口/URL/截图/路径 |
+| 本地或云端存储 | 待测 | 待测 | 待测 | 待测 | 入口/URL/截图/路径 |
+
+## StarWork 适配判断标准
+
+### 可直接适配
+
+满足以下任一条件：
+
+- 有稳定官方 API、URL 或导出入口。
+- 有稳定 UI 操作，且 StarWork 只需要给用户提示，不需要自动化。
+- 有安全导出格式，可以进入 lane workspace。
+- 项目 ID、会话 ID 或 run ID 跨重启稳定，可作为 `trae-solo:<id>`。
+
+### 只能降级适配
+
+满足以下任一条件：
+
+- 只有 UI，没有可编程入口。
+- 只有分享 URL 或导出文件能间接定位项目。
+- 能手动完成，但无法由 StarWork CLI 稳定执行。
+- 只能用人工 ID，例如 `trae-solo:<project-name>-<date>`。
+
+### 不建议适配
+
+满足以下任一条件：
+
+- 需要直接改写 Trae Solo 私有数据库、云端状态或缓存。
+- 删除不可恢复。
+- URL 或 ID 仅短期有效。
+- 能力依赖不稳定实验 UI。
+- 会破坏用户项目历史、发布状态或隐私。
+
+## 调研产物落地建议
+
+Trae Solo App 完成调研后，把结果保存为：
+
+```text
+product/docs/multiagent/trae-solo-session-management-research-result.md
+```
+
+如果调研中产生截图、分享链接、导出样例或复制出的会话文本，不要放根目录；优先放：
+
+```text
+_系统/协作/lanes/capability-research/workspace/
+```
+
+或经确认后放入：
+
+```text
+product/docs/multiagent/assets/
+```

package/docs/multiagent/claude-code-session-management-research-result.md

@@ -0,0 +1,201 @@
+# Claude Code 会话管理能力调研结果
+
+## 基本信息
+
+- 日期：2026-06-02
+- Claude Code 版本：2.1.153
+- 操作系统：macOS Darwin 25.5.0
+- 调研方式：在当前 Claude Code CLI 环境中实测，基于环境变量、CLI help、本地存储文件、配置目录和 transcript 格式分析
+- 对应指令：`product/docs/multiagent/04-claude-code-session-management-research-instructions.md`
+
+## A. 能力矩阵
+
+| 能力 | UI 或 CLI 支持 | 可编程支持 | 稳定性 | StarWork 适配建议 | 证据 |
+|---|---|---|---|---|---|
+| 获取当前会话 ID | `CLAUDE_CODE_SESSION_ID` 环境变量（UUID），`claude --session-id <uuid>` 可指定 | 环境变量稳定可读，`--session-id` 可主动设置 | 高 | **可直接适配**。StarWork 使用 `$CLAUDE_CODE_SESSION_ID` 作为 `claude-code:<session-id>` 的 session_id | 实测 `env \| grep CLAUDE_CODE_SESSION_ID` → `631c65eb-2e7e-4e62-89ec-e5ba8ca5eb43` |
+| 当前会话改名 | `claude -n/--name <name>` 启动时设置名称；`/rename-conversation`（内置 slash command，来自 tipsHistory `rename-conversation: 222`）；交互式 UI 可改名 | `-n` 参数可程序化传入，无运行时改名 API | 中 | **可直接适配（启动时）**，**降级适配（运行时）**。`multiagent bind --session-name` 在 bind 时若用户是刚启动的新会话可用 `-n` 参数；对于已运行会话，只能提示用户手动 `/rename-conversation` | CLI `--name` 选项已确认；tipsHistory 含 `rename-conversation` 条目 |
+| 列出历史会话 | `/resume` 交互式选择器（按 session ID 或标题搜索）；`claude --resume` 打开 picker；`claude --resume <id\|title>` 直接恢复 | `history.jsonl`（`~/.claude/history.jsonl`）可程序化解析，包含 display/prompt、timestamp、project、sessionId | 中（history.jsonl 无标题字段） | **降级适配**。`history.jsonl` 可按 project 字段筛选当前项目会话，但不含会话标题。可解析后按 sessionId 分组展示 | `history.jsonl` 实测 1707 行，覆盖 33 个项目、262 个唯一 session |
+| 读取历史会话 | Transcript 文件：`~/.claude/projects/<project-path>/<session-id>.jsonl`（JSONL 格式），含完整 user/assistant/tool_use/attachment 消息 | JSONL 文件可程序化读取 | 高（格式稳定，跨版本兼容） | **可直接适配**。StarWork adapter 可安全读取 transcript 用于 worklog 生成、交接摘要、lane 归档 | 实测当前 transcript 340KB、159 行，含 user/assistant/attachment/file-history-snapshot/mode/permission-mode 等类型 |
+| resume 历史会话 | `claude --resume <id\|title>` 或 `claude -r <id\|title>`；`claude --continue` / `claude -c` 恢复最近会话；`claude --from-pr` 恢复 PR 关联会话；`/resume` 内置 slash command | `--resume` 支持 `--print` 非交互模式，可指定 session ID | 高 | **可直接适配**。`multiagent continue <lane>` 可执行 `claude --resume <session-id>` 恢复对应 lane 的会话。resume 后模型获得旧会话完整上下文（transcript 回放） | CLI help 明确列出 `--resume`、`--continue`、`--from-pr`、`--fork-session` |
+| 向非当前会话发送 follow-up | 不支持。无 `send_message_to_session` 等价能力 | 无 | 无 | **不支持**。StarWork 若需此能力，应提示用户手动 `claude --resume <id>` 在新终端中操作 | 未发现任何等价接口 |
+| 导出会话 | 无官方导出命令。Transcript 文件（JSONL）可直接复制作为「导出」 | JSONL 可用标准工具转换（如 `python3` 转 Markdown） | 中（格式无稳定性承诺） | **降级适配**。建议 StarWork adapter 安全复制 transcript JSONL 到 lane workspace，生成 Markdown 摘要作为 worklog | 未发现 `/export` 或官方导出命令；transcript 是本地可读文件 |
+| 删除会话 | `claude project purge [path]` 删除整个项目的所有状态（transcripts、tasks、file history、config）。无单会话删除 | 无单会话删除 API | 低（purge 为不可逆批量操作） | **不建议适配**。项目级 purge 过于粗暴，StarWork 不应自动执行。单会话删除无法程序化实现，只能提示用户手动操作 | `claude project --help` 列出 `purge` 子命令 |
+| 归档会话 | 不支持 | 无 | 无 | **不支持**。StarWork 可通过 lane workspace 自建归档索引，不依赖宿主 | 未发现任何归档接口 |
+| 置顶会话 | 不支持 pin/favorite/star | 无 | 无 | **不支持**。`/resume` picker 按时间排序，无置顶机制 | history.jsonl 无 pin/star 字段 |
+| transcript 本地存储 | `~/.claude/projects/<project-path>/<session-id>.jsonl`（每条消息一行 JSON）；session 元数据在 `~/.claude/sessions/<pid>.json` | JSONL 可读写，但写入可能破坏 Claude Code 状态 | 高（只读安全），低（写入危险） | **可直接适配（只读）**。StarWork adapter 可安全读取 transcript 生成 worklog、摘要、交接文档。**不建议写入** | 实测两个格式：新版 `.jsonl`（当前项目），旧版按 session 分目录（digital-twin 项目含 26 个 session 目录） |
+| 项目级 memory / CLAUDE.md | `CLAUDE.md` 文件（项目根目录）；auto-memory 系统（`~/.claude/projects/<project>/memory/`）；`/memory` 内置 slash command；系统 prompt 中自动注入 CLAUDE.md 内容 | `CLAUDE.md` 可被 StarWork 写入 lane 使用规则 | 高 | **可直接适配**。CLAUDE.md 适合承载 lane 使用规则（职责、write_scope、交接要求）。每个 lane 可在自己的 workspace 有独立 CLAUDE.md | `CLAUDE.md` 已在当前项目 active 使用；memory 目录已存在但本项目当前为空 |
+| compact / summarize | 系统自动执行上下文压缩（context compression），无手动触发 CLI | 自动触发，不可程序化控制 | 中 | **降级适配**。compact 后旧消息不再可查看（被 summary 替代），resume 使用 compact summary。StarWork **仍需要 worklog 做显式交接**，因为 compact summary 对用户不可见且无结构化保证 | 系统提示中描述了上下文压缩机制；未发现手动 `/compact` 命令入口 |
+| 多会话并行 | 支持。多终端/IDE 会话同时打开同一项目；每个会话独立 transcript（按 sessionId 区分）；`--worktree` 创建隔离 git worktree；`--fork-session` 在 resume 时创建新 session ID；`color-when-multi-clauding` tip 确认多会话场景 | `--worktree` + `--session-id` + `--fork-session` 可组合实现 | 高 | **可直接适配**。多 lane 可并行运行（每个 lane 一个终端/IDE 窗口）。worktree 隔离适合不同 lane 的写入边界。建议 StarWork 提示用户不同 lane 用不同终端颜色区分 | CLI `-w/--worktree`、`--fork-session`、`--session-id`；tipsHistory 含 `color-when-multi-clauding` |
+| 权限和工作目录状态恢复 | Transcript 记录 cwd、permissionMode、gitBranch、entrypoint、version。resume 后恢复这些状态 | 无显式 API，resume 行为由 Claude Code 内部处理 | 高 | **可直接适配（读取）**。StarWork adapter 可从 transcript 首行读取 lane 绑定时状态。不应依赖 resume 自动恢复所有状态，应在 bind 时主动记录关键状态到 lane workspace | Transcript 首条 user 消息包含 `cwd`、`permissionMode`、`gitBranch`、`version`、`userType`、`entrypoint` |
+
+## B. 结论
+
+### 可直接适配 StarWork 的能力
+
+1. **session_id 生成**：`$CLAUDE_CODE_SESSION_ID` 是稳定 UUID，直接作为 `claude-code:<uuid>` 格式的 session_id。StarWork `multiagent bind` 自动读取此环境变量。
+
+2. **会话命名**：`claude -n/--name "lane-name"` 在启动时设置。对于新建 lane 场景（`multiagent bind --session-name`），如果是从新终端启动，可传入 `-n` 参数实现自动命名。
+
+3. **resume / continue**：`claude --resume <session-id>` 精确恢复指定 lane 会话；`claude --continue` 恢复最近会话。`multiagent continue <lane>` 可映射为 `claude --resume <session-id>`。
+
+4. **transcript 读取**：`~/.claude/projects/<project>/<session-id>.jsonl` 是标准 JSONL，StarWork adapter 可安全读取用于生成 worklog、交接摘要和 lane 归档内容。
+
+5. **CLAUDE.md**：项目级 CLAUDE.md 适合承载 lane 使用规则。每个 lane 可在其 workspace 有独立 CLAUDE.md，新会话启动时自动加载。
+
+6. **多会话并行**：`--worktree` + `--session-id` 组合支持多 lane 并行，每个 lane 有独立 transcript 和（可选）git 隔离。
+
+### 只能降级适配（人工操作，无法自动化）
+
+1. **会话列表**：`history.jsonl` 可按 project 筛选当前项目会话，但不含会话标题，仅含首条 prompt 摘要。StarWork 可解析后分组展示，但无法获取准确会话名称。
+
+2. **会话改名（运行时）**：`/rename-conversation` 是内置 slash command，但无 CLI 或 API 入口。已运行会话改名只能提示用户手动操作。
+
+3. **会话导出**：无官方导出，只能安全复制 transcript JSONL 文件。StarWork adapter 需自行将 JSONL 转为可读摘要格式。
+
+4. **compact**：系统自动管理，无手动触发入口，compact 内容对用户不透明。StarWork 必须维护独立 worklog 做显式交接。
+
+### 不支持或不建议适配
+
+1. **向非当前会话发送 follow-up**：Claude Code 无此能力。每个 lane 的继续操作需在新终端中 `claude --resume <id>`。
+
+2. **单会话删除**：只有 `claude project purge`（全项目删除），无单会话删除。StarWork 不应执行 purge。
+
+3. **归档/置顶**：无原生支持。StarWork 需在 lane workspace 自建归档索引。
+
+4. **写入 transcript 或私有数据库**：写入 JSONL 或 `.claude.json` 可能破坏 Claude Code 状态，**严禁** StarWork adapter 写入这些文件。
+
+### StarWork 在 Claude Code 中如何生成 session_id
+
+直接使用 `$CLAUDE_CODE_SESSION_ID` 环境变量，格式为 `claude-code:<uuid>`。在 `multiagent bind` 时自动捕获。如果需要预先生成 session_id（如 `--session-id` 启动），StarWork 可生成 UUID 并通过 `claude --session-id <pre-generated-uuid>` 传入。
+
+### multiagent bind --session-name 策略
+
+**启动时可自动化**：如果 `multiagent bind` 触发了新 `claude` 进程启动，传入 `-n "<lane-name>"` 参数。
+
+**已运行会话**：降级为提示用户执行 `/rename-conversation` 手动改名。StarWork CLI 输出明确的改名提示。
+
+### Claude Code 是否适合实现 StarWork 关键命令
+
+| StarWork 命令 | 实现判断 | 说明 |
+|---|---|---|
+| `multiagent status --host` | **可实现** | 读取 `CLAUDE_CODE_SESSION_ID`、transcript cwd、git branch 等元数据 |
+| `multiagent continue <lane>` | **可实现** | 将 lane 绑定的 session_id 传入 `claude --resume <session-id>` |
+| `multiagent release --archive-session` | **降级实现** | 无法归档/删除宿主会话。可安全复制 transcript 到 lane workspace，并提示用户手动清理（/rename-conversation 加 `[done]` 前缀等） |
+
+## C. 建议工作流
+
+### 将当前 Claude Code 会话登记为 StarWork lane
+
+```text
+# 步骤 1：在 Claude Code 新终端中启动一个命名会话（推荐）
+claude -n "后端 API Review" --session-id "starwork-lane-api-review"
+
+# 步骤 2：在 Claude Code 会话内，由 StarWork skill 执行
+starwork multiagent bind api-review \
+  --host claude-code \
+  --session-id "$CLAUDE_CODE_SESSION_ID" \
+  --session-name "后端 API Review" \
+  --write-scope "product/core/,product/cli/src/"
+
+# 步骤 3：StarWork 内部动作
+# - 向 lane registry 写入：lane=api-review, host=claude-code, session=<uuid>
+# - 向 lane workspace 写入 CLAUDE.md（含职责和 write_scope）
+# - 记录 worklog 初始条目
+# - 尝试通过 /rename-conversation 同步会话名（非致命）
+
+# 步骤 4：后续交接
+# 另一个 Claude Code 终端中：
+claude --resume <session-id>
+# 或在 StarWork 中：
+starwork multiagent continue api-review
+# → 自动执行 claude --resume <session-id>
+```
+
+### 在多 lane 并行场景中
+
+```text
+# 终端 1（lane: api-review，工作树隔离）
+claude -n "API Review" -w api-review
+
+# 终端 2（lane: doc-writer，同一项目不同工作树）
+claude -n "文档撰写" -w doc-writer
+
+# 终端 3（lane: test-runner，不隔离）
+claude -n "测试运行" --fork-session
+```
+
+### release 后清理
+
+```text
+# StarWork multiagent release api-review 执行：
+# 1. 安全复制 transcript 到 lane workspace
+# 2. 从 transcript 生成 worklog 摘要
+# 3. 提示用户：可在 Claude Code 中将该会话改名为 "[done] 后端 API Review"
+# 4. 不执行 claude project purge（不可逆批量操作）
+```
+
+## 附加发现
+
+### transcript JSONL 消息类型
+
+当前版本 transcript 包含以下消息类型：
+
+| 类型 | 说明 | StarWork 用途 |
+|---|---|---|
+| `mode` | 会话模式（normal） | 记录 lane 运行模式 |
+| `permission-mode` | 权限模式（bypassPermissions/acceptEdits 等） | 记录 lane 权限状态 |
+| `file-history-snapshot` | 文件变更追踪快照 | 了解 lane 改动了哪些文件 |
+| `user` | 用户消息（含 cwd、gitBranch、version、timestamp） | 提取操作时间线和上下文 |
+| `attachment` | 系统附件（如 skill_listing） | 了解 lane 可用的技能集 |
+| `assistant` | assistant 响应（含 model、usage、content blocks） | 提取决策、工具调用、文件修改 |
+| `last-prompt` | 当前最新 prompt 引用 | 确认当前会话状态 |
+
+### session 元数据文件格式
+
+`~/.claude/sessions/<pid>.json`：
+
+```json
+{
+  "pid": 97538,
+  "sessionId": "631c65eb-2e7e-4e62-89ec-e5ba8ca5eb43",
+  "cwd": "/Users/shuxinding/satellite-starwork",
+  "startedAt": 1780382495442,
+  "procStart": "Tue Jun  2 06:41:30 2026",
+  "version": "2.1.153",
+  "peerProtocol": 1,
+  "kind": "interactive",
+  "entrypoint": "cli",
+  "status": "busy",
+  "updatedAt": 1780382507703
+}
+```
+
+### 两种 transcript 存储格式（版本演进）
+
+- **新版**（当前版本 2.1.153）：`<project>/<session-id>.jsonl` 单文件
+- **旧版**（早期版本）：`<project>/<session-id>/` 目录（含 `subagents/` 子目录）
+- StarWork adapter 应同时兼容两种格式
+
+### 关键局限
+
+1. **session 标题不存储在 transcript 中**：`--name` 设置的名字似乎存储在 `.claude.json` 的项目级配置中（作为交互式 UI 数据），不在 transcript JSONL 中，因此从 transcript 无法恢复会话名称。
+
+2. **history.jsonl 不完整**：只记录用户第一条 prompt，不含完整会话历史、会话名称或状态。仅适合作为「最近活动」索引，不能作为 session registry。
+
+3. **无 API 管理会话**：Claude Code 不提供 HTTP API 或 IPC 接口管理会话。所有管理操作通过 CLI 参数（启动时）或交互式 UI。
+
+4. **compact 不透明**：上下文压缩由系统自动触发，用户无法查看 compact 后的 summary 内容。StarWork 的 worklog 机制是必要的补充。
+
+## 与 Codex 会话能力的对比摘要
+
+| 能力 | Codex | Claude Code | StarWork 统一策略 |
+|---|---|---|---|
+| session ID | thread ID（含 url） | UUID（环境变量 `CLAUDE_CODE_SESSION_ID`） | 统一格式 `<host>:<id>` |
+| 会话命名 | `thread/name/set` API | `-n/--name` CLI + 交互式改名 | 优先用 CLI 参数，降级提示手动 |
+| 会话列表 | `list_threads` 工具 | `/resume` picker + history.jsonl | parse history.jsonl + 提示用户手动选择 |
+| 非当前会话 follow-up | `send_message_to_thread` | 不支持 | StarWork 本身不支持跨宿主 follow-up |
+| 归档 | `set_thread_archived` | 不支持 | StarWork 自建归档索引 |
+| 置顶 | `set_thread_pinned` | 不支持 | StarWork 自建优先级标记 |
+| 单会话删除 | 不支持 | 不支持（仅全项目 purge） | 不做宿主删除，仅做 StarWork 侧清理 |
+| 导出 | 无官方导出 | 无官方导出 | 安全复制 transcript JSONL |
+| 多会话隔离 | worktree | worktree + fork-session | lane write_scope + git worktree |