# 新窗口开工提示词

## 用途

这份文档提供一组可以直接复制到新窗口里的提示词，目的是让新的 Codex 会话快速接手 `spool` 当前路线，而不需要你每次重新解释背景。

建议配合以下文件一起使用：

- [spool 后续任务拆解 TO DO list.csv](/Users/long/Work/spool/spool%20后续任务拆解%20TO%20DO%20list.csv)
- [TASK_EXECUTION_GUIDE.md](/Users/long/Work/spool/docs/TASK_EXECUTION_GUIDE.md)
- [DESKTOP_PRODUCT_REFOCUS_PLAN.md](/Users/long/Work/spool/docs/DESKTOP_PRODUCT_REFOCUS_PLAN.md)
- [TERMINAL_AI_INTEGRATION.md](/Users/long/Work/spool/docs/TERMINAL_AI_INTEGRATION.md)

## 总接手 Prompt

适用于你新开一个窗口，先让 Codex 恢复上下文并开始当前主线。

```text
请先阅读以下文件并恢复项目上下文：

1. /Users/long/Work/spool/spool 后续任务拆解 TO DO list.csv
2. /Users/long/Work/spool/docs/TASK_EXECUTION_GUIDE.md
3. /Users/long/Work/spool/docs/DESKTOP_PRODUCT_REFOCUS_PLAN.md
4. /Users/long/Work/spool/docs/TERMINAL_AI_INTEGRATION.md
5. /Users/long/Work/spool/docs/SESSION_HANDOFF.md

当前产品方向已经收敛为：
- 桌面端是控制台，不是主要注入工作台
- 核心价值是 spool-mcp 在真实 AI 工作流中完成上下文优化、知识召回与知识提炼
- 会话浏览要接近 cc-switch，支持分页、详情、继续对话、删除对话
- 检索质量要明显强化，优先召回项目规范、边界、约束、决策、偏好
- 一个 MCP 要支持多个 AI 客户端统一接入

请不要重新规划大方向，直接按 TODO CSV 的当前 IN_PROGRESS 项继续实施。

要求：
- 先检查当前 IN_PROGRESS 的任务
- 读取对应入口文件
- 直接改代码，不要只停留在分析
- 每完成一项就同步推进 TODO CSV
- 完成后运行必要验证，并汇报结果与剩余风险
```

## 子任务 1 Prompt

```text
请接手 /Users/long/Work/spool 的当前任务，优先完成：
“收敛会话浏览为分页列表与完整上下文详情”

先阅读：
- /Users/long/Work/spool/spool 后续任务拆解 TO DO list.csv
- /Users/long/Work/spool/docs/TASK_EXECUTION_GUIDE.md
- /Users/long/Work/spool/src/session_sources.rs
- /Users/long/Work/spool/src/desktop.rs
- /Users/long/Work/spool/src/desktop/tauri.rs
- /Users/long/Work/spool/frontend/desktop.js
- /Users/long/Work/spool/frontend/desktop.css

目标：
- 会话列表默认第一页只显示最近 10 条
- 支持稳定的分页与“加载更多”
- 点击会话后可以查看清晰的聊天上下文详情
- 保留当前目录匹配标记
- 优化列表与详情区域比例，避免一屏信息过满

要求：
- 直接实现，不要先给大段方案
- 保持前后端契约一致
- 变更后运行最小必要验证
- 更新 TODO CSV 状态
```

## 子任务 2 Prompt

```text
请继续 /Users/long/Work/spool 的下一项任务：
“完善继续对话、删除会话与选择回退交互”

先阅读：
- /Users/long/Work/spool/spool 后续任务拆解 TO DO list.csv
- /Users/long/Work/spool/docs/TASK_EXECUTION_GUIDE.md
- /Users/long/Work/spool/src/desktop.rs
- /Users/long/Work/spool/src/session_sources.rs
- /Users/long/Work/spool/src-tauri/src/commands.rs
- /Users/long/Work/spool/frontend/desktop.js

目标：
- 点击“继续对话”后，Claude 会话走 claude -r，Codex 会话走 codex resume
- 删除会话前增加确认或保护
- 删除后自动回退到相邻会话
- 失败时给出具体错误信息，不要只显示通用报错

要求：
- 保持行为接近 cc-switch 的会话管理体验
- 直接修改代码并验证
- 完成后推进 TODO CSV
```

## 子任务 3 Prompt

```text
请继续 /Users/long/Work/spool 的下一项任务：
“建立 MCP 运行时增强追踪与状态回显”

先阅读：
- /Users/long/Work/spool/spool 后续任务拆解 TO DO list.csv
- /Users/long/Work/spool/docs/TASK_EXECUTION_GUIDE.md
- /Users/long/Work/spool/src/mcp.rs
- /Users/long/Work/spool/src/desktop_status.rs
- /Users/long/Work/spool/src/desktop.rs
- /Users/long/Work/spool/frontend/desktop.js
- /Users/long/Work/spool/docs/TERMINAL_AI_INTEGRATION.md

目标：
- 区分“已注册 MCP”与“当前会话已实际通过 spool 增强”
- 为 prompt_optimize 增加最近调用记录
- 桌面端展示最近一次真实增强摘要
- 让用户能明确知道 MCP 是否真正参与当前 AI 工作流

要求：
- 先设计最小可落地的数据记录方式
- 优先保证可验证，不要做纯静态状态展示
- 补必要测试
- 完成后推进 TODO CSV
```

## 子任务 4 Prompt

```text
请继续 /Users/long/Work/spool 的下一项任务：
“抽离注入编排服务并统一 prompt_optimize 流程”

先阅读：
- /Users/long/Work/spool/spool 后续任务拆解 TO DO list.csv
- /Users/long/Work/spool/docs/TASK_EXECUTION_GUIDE.md
- /Users/long/Work/spool/src/mcp.rs
- /Users/long/Work/spool/src/memory_gateway.rs
- /Users/long/Work/spool/src/app.rs
- /Users/long/Work/spool/src/output/prompt.rs

目标：
- 不再让 mcp.rs 同时负责协议处理和注入编排
- 抽离统一的 orchestration/service 层
- 让桌面端与 MCP 共用同一套 context+wakeup+combined prompt 流程

要求：
- 直接做结构调整和实现
- 不要引入新的重复逻辑
- 增加单元测试覆盖编排行为
- 完成后推进 TODO CSV
```

## 子任务 5 Prompt

```text
请继续 /Users/long/Work/spool 的下一项任务：
“重构检索排序以强化约束、决策、规范与偏好召回”

先阅读：
- /Users/long/Work/spool/spool 后续任务拆解 TO DO list.csv
- /Users/long/Work/spool/docs/TASK_EXECUTION_GUIDE.md
- /Users/long/Work/spool/src/engine/scorer.rs
- /Users/long/Work/spool/src/engine/selector.rs
- /Users/long/Work/spool/src/domain/note.rs
- /Users/long/Work/spool/src/output/json.rs

目标：
- 提升 constraint、decision、preference、workflow、pattern 的召回优先级
- 让项目级规范优先于泛化知识
- 丰富 score reasons，提高检索可解释性
- 改善 excerpt 选取，让返回内容更适合直接提供给 AI

要求：
- 直接调整排序与输出，不要只讨论方向
- 增加回归测试
- 完成后推进 TODO CSV
```

## 子任务 6 Prompt

```text
请继续 /Users/long/Work/spool 的下一项任务：
“实现项目级知识提炼、回写与二次召回闭环”

先阅读：
- /Users/long/Work/spool/spool 后续任务拆解 TO DO list.csv
- /Users/long/Work/spool/docs/TASK_EXECUTION_GUIDE.md
- /Users/long/Work/spool/src/lifecycle_service.rs
- /Users/long/Work/spool/src/lifecycle_store.rs
- /Users/long/Work/spool/src/domain/memory_lifecycle.rs
- /Users/long/Work/spool/src/session_sources.rs
- /Users/long/Work/spool/docs/OBSIDIAN_SCHEMA.md

目标：
- 从会话或增强结果中提炼项目约束、规范、架构决策
- 区分 raw memory、候选知识、已确认知识
- 建立可用于后续召回的结构化字段
- 保留证据来源，不直接污染最终知识库

要求：
- 先实现最小闭环
- 强调可审阅和可追溯
- 完成后推进 TODO CSV
```

## 子任务 7 Prompt

```text
请继续 /Users/long/Work/spool 的下一项任务：
“扩展多 AI 客户端适配与统一 MCP 管理能力”

先阅读：
- /Users/long/Work/spool/spool 后续任务拆解 TO DO list.csv
- /Users/long/Work/spool/docs/TASK_EXECUTION_GUIDE.md
- /Users/long/Work/spool/src/desktop_status.rs
- /Users/long/Work/spool/src/session_sources.rs
- /Users/long/Work/spool/docs/TERMINAL_AI_INTEGRATION.md
- /Users/long/Work/spool/docs/DESKTOP_PRODUCT_REFOCUS_PLAN.md

目标：
- 保持一个 MCP 统一服务多个 AI 客户端
- 优先稳固 Claude、Codex 的适配层
- 为 Cursor、Kiro、Antigravity 等后续接入预留清晰扩展点
- 桌面端更多承担配置与管理职责，而不是直接注入工作台

要求：
- 重点做接口抽象，不要把 provider 分支继续散落
- 同步更新接入文档
- 完成后推进 TODO CSV
```

## 子任务 8 Prompt

```text
请继续 /Users/long/Work/spool 的下一项任务：
“补齐验证基线、运行文档与调试手册”

先阅读：
- /Users/long/Work/spool/spool 后续任务拆解 TO DO list.csv
- /Users/long/Work/spool/docs/TASK_EXECUTION_GUIDE.md
- /Users/long/Work/spool/docs/DESKTOP_RUNBOOK.md
- /Users/long/Work/spool/docs/TERMINAL_AI_INTEGRATION.md
- /Users/long/Work/spool/docs/README.md

目标：
- 写清楚怎么运行桌面端、怎么运行 MCP、怎么验证 prompt_optimize 生效
- 补齐常见故障定位步骤
- 确保新窗口开发者不看聊天记录也能跑通当前实现

要求：
- 文档全部使用中文
- 文档内容要和当前代码一致
- 必要时顺手修正文档引用和索引
- 完成后推进 TODO CSV
```

## 使用建议

- 如果是第一次在新窗口接手，先用“总接手 Prompt”
- 如果是明确推进某一项，直接复制对应“子任务 Prompt”
- 如果上一窗口已经推进了一半，先用 TODO CSV 确认当前 `IN_PROGRESS` 项，再选择对应 prompt
