kkfor30/kk-sessions / skills/kk-session-route
kk-session-route
Verified新会话第一轮做会话归位:按工作区地图判断这次内容属于哪个分区和目录,建主题目录、切目录、按统一格式命名、归入侧栏分区。Claude Code 由启动钩子触发,先处理用户的请求、本轮结束前完成归位;Codex 的标题和分区由后台钩子自动完成,会话本身只负责把产物写到目标目录;用户说"路由一下""这个会话归到哪""重新归类"时也使用。支持 Claude Code 桌面端和 Codex 桌面端。不用于中途换话题时自动迁移;批量整理旧会话用 kk-session-tidy,首次生成地图用 kk-session-setup。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 9.0 KB |
| scripts/codex_route.py | script | 28.3 KB |
| scripts/kit.py | script | 979 B |
| scripts/restore.py | script | 7.2 KB |
| scripts/session_start.py | script | 1.8 KB |
| scripts/stop_check.py | script | 2.8 KB |
| scripts/turn_hint.py | script | 5.8 KB |
SKILL.md
View on GitHub---
name: kk-session-route
description: 新会话第一轮做会话归位:按工作区地图判断这次内容属于哪个分区和目录,建主题目录、切目录、按统一格式命名、归入侧栏分区。Claude Code 由启动钩子触发,先处理用户的请求、本轮结束前完成归位;Codex 的标题和分区由后台钩子自动完成,会话本身只负责把产物写到目标目录;用户说"路由一下""这个会话归到哪""重新归类"时也使用。支持 Claude Code 桌面端和 Codex 桌面端。不用于中途换话题时自动迁移;批量整理旧会话用 kk-session-tidy,首次生成地图用 kk-session-setup。
---
# kk-session-route
## 输入
工作区地图:`~/.agent-rules/workspace-map.md`(分区、目录、判定线索、标题格式)。什么时候读见下面「流程」。
地图不存在时不归位:照常处理用户的请求,在回复最后用一句话说明还没初始化,问用户要不要运行 `kk-session-setup`。
## 六个动作
流程只用这 6 个动作,每个 Agent 怎么完成见下面「适配」:
| 动作 | 含义 |
| --- | --- |
| 取会话 ID | 拿到当前会话的 ID |
| 改标题 | 把当前会话标题设成指定文本 |
| 列出和新建分区 | 找到地图里的同名侧栏分区,没有就新建 |
| 移入分区 | 把当前会话放进该分区 |
| 切目录 | 把会话的工作目录换到目标目录 |
| 列出全部会话 | 取所有会话的标题、分区、目录、最后活动时间(kk-session-setup、kk-session-tidy 用) |
某个动作在当前 Agent 做不到时,统一降级:在回复里给出建议值(分区名、标题、目录),由用户手动操作。
## 流程
原则:**先处理用户的请求,归位放在本轮回复结束前完成**,不让归位挡在回答前面。按第一条消息分三种情况:
| 情况 | 回答前 | 回答后(本轮结束前) |
| --- | --- | --- |
| A. 一两句能答完的问题(问答、查东西、电脑设置) | 什么都不做,直接回答 | 改标题、归 📦 杂项;不建目录、不切目录 |
| B. 要产出文件的任务(方案、脚本、工具、剪辑) | 读地图、定目录、建目录和 README(一轮,和读其他文件并行) | 改标题、归区、切目录,放在同一轮发出 |
| C. 归属拿不准,或和地图里所有分区都对不上 | 不等用户,先按首选目录处理请求 | 末尾问一句归哪里(给出首选);用户回答后的下一轮再完成归位,文件需要就整个移过去 |
### 回答前(只有 B、C 需要)
1. **读地图,定目录**:对照地图选分区和产物目录。需要具体主题的分区,列出该目录下已有子目录,能对上就用已有的;对不上再定一个新主题名。调研转正式选题、试用转正式项目时,整个文件夹移过去。读地图和列目录在同一条消息里并行发出。
2. **建主题目录和 README**:新主题当场建目录和 `README.md`(是什么、状态:想法、下一步),子目录用到时再建。
3. 之后本会话的产物一律写到目标目录的绝对路径(切目录要到下一轮才生效)。
### 回答后(本轮结束前,全部情况)
情况 A 此时才读地图;地图已经读过就不再读。侧栏工具是延迟加载的,用 ToolSearch 一次性加载。
1. **第一条消息**,并行发出:
- **改标题**:`<类型emoji> <主题>|<这次做什么>`,emoji 后 20 字以内;类型 emoji 只从地图「标题」表的 8 个里选。这轮结尾留下只有用户能做的事时,直接带上 ` ⏳`。
- **列出分区**;快照目录里没有当前 Agent 的快照时,同时列出全部会话(含已归档),用于存快照(格式见 kk-session-restore 的「快照」一节)。
- **切目录**(只有 B):工作目录不在目标目录内时切过去。
2. **第二条消息**:需要时先写快照,再按需新建分区,最后移入分区。
3. **一句话说明**放在回复最后:"已归到 🟣 内容制作,标题 `🔍 新品测评|竞品拆解`"。做不到的动作在同一句里给出建议。
### 补漏
本轮被打断或出错导致没归位时,下一轮开头检查:标题还不是 `<类型emoji> <主题>|…` 格式,就按上面「回答后」补做一次,只补一次。
### 新分区
和地图里所有分区都对不上(新的领域、新的长期项目)时,按情况 C 处理:末尾提议一个新分区,写明名称(颜色 emoji 加 2 到 4 个字)、产物根目录、判定线索。用户同意就把这一行加进地图「分区」表、在磁盘建根目录、在侧栏建分区,再完成归位;不同意就归到 📦 杂项。不要不问就建顶层目录。用户在哪个目录开的会话都可以,归位以地图为准。
## 标题锁定
- 主题第一次命名后锁定,之后不改。
- emoji 和|后半段默认也不自动改。只有 kk-session-tidy 会对很长、阶段明显变化的会话提出改名建议,用户确认才改。
- 末尾 ` ⏳` 按地图「跟进」一节增减,这是唯一允许 Agent 自动改的部分。首次归位之后,每轮开头的 UserPromptSubmit 钩子 `scripts/turn_hint.py` 会按当前标题给出一句 [kk-sessions] 提醒,照提醒在本轮结束时加或去掉。
- 置顶只由用户手动操作。
## 适配
有环境变量 `CODEX_THREAD_ID` 是 Codex;有 `mcp__ccd_*` 工具是 Claude Code 桌面端。都不是(如 Claude Code 命令行),六个动作全部降级为建议。
### Claude Code 桌面端
| 动作 | 做法 |
| --- | --- |
| 取会话 ID | 不需要,工具都接受 `"self"` |
| 改标题 | `mcp__ccd_session_mgmt__set_session_title`,`session_id: "self"` |
| 列出和新建分区 | `mcp__ccd_sidebar__list_sections` 找同名,没有就 `create_section` |
| 移入分区 | `mcp__ccd_sidebar__move_sessions`,`session_ids: ["self"]`;当前会话嵌在父会话下时会被拒绝,此时跳过,跟随父会话 |
| 切目录 | `mcp__ccd_directory__change_directory`(用户在卡片上批准一次;本轮结束后生效,本轮写文件用绝对路径) |
| 列出全部会话 | `mcp__ccd_session_mgmt__list_sessions` |
这些工具是延迟加载的,先用 ToolSearch 一次性加载再调用。
### Codex 桌面端
新会话的改标题、建分区、移入分区由 Stop 钩子 `scripts/codex_route.py` 在后台完成:新会话前 3 轮内每轮结束后,对标题还不是规定格式的会话,调一次独立模型(默认 `gpt-6-luna`、low,可在 `~/.agent-rules/kk-sessions/config.json` 的 `codex_model`、`codex_effort` 改),再通过桌面端自己的工具通道写回(侧栏立即刷新;桌面端没开时退回 app-server),结果记在 `~/.agent-rules/kk-sessions/codex/log.jsonl`。后台只处理用户自己开的会话(定时任务、子 Agent、`codex exec` 派发的跳过),出错时一分钟后在后台再试一次。地图外的长期新领域先归兜底分区,并留一条待提议记录,用户下一次发消息时由 `scripts/turn_hint.py` 提醒会话模型提议新分区。SessionStart 钩子 `scripts/session_start.py` 在新会话开头把这些分工交给会话模型。所以新会话第一轮里:
- 情况 A:什么都不做。
- 情况 B、C:只做「回答前」那几步(定目录、建目录、产物写到目标目录),不改标题、不动分区;切目录按下表降级;C 的末尾提问照常。
用户说"路由一下""重新归类",或 kk-session-setup、kk-session-tidy、kk-session-restore 需要时,才用下表的工具手动操作:
| 动作 | 做法 |
| --- | --- |
| 取会话 ID | 环境变量 `CODEX_THREAD_ID` |
| 改标题 | `mcp__codex_app__set_thread_title`(省略 `threadId` 即作用于当前会话) |
| 列出和新建分区 | `list_threads` 返回的 `sections[]` 找同名,没有就 `create_sidebar_section` |
| 移入分区 | `move_thread_to_sidebar_section({threadId, hostId: "local", sectionId})`,然后用 `list_threads` 回读:正式键 `codex:thread:local:<threadId>` 出现在目标分区的 `itemKeys` 里才算成功。首轮常只移进一个 `client-new-thread` 别名,没成功就在下一轮开头补做一次并再回读 |
| 切目录 | 不支持:`move_thread_to_project` 遇到会话原文件夹不在目标项目里时直接返回 `confirmation_required`,不弹确认卡,只能由用户在侧栏拖动。不要调用;产物写到目标目录的绝对路径,回复最后一句告诉用户产物位置,需要时可在侧栏把会话拖到对应项目 |
| 列出全部会话 | `list_threads`(`mode: "history"` 分页),归档用 `list_archived_threads` |
## 边界
- 只在会话第一轮归位一次。之后话题变化不自动迁移,用户要求时再重新归位。
- 已由用户手动命名或手动放入分区的会话,不覆盖用户的选择。
- fork 或旁支会话:沿用父会话的主题,只换 emoji 和这次做什么,例如 `🐛 新品测评|导出变慢排查`。主题已和父会话不同时,提醒用户在侧栏拆成顶层会话后再归区(Agent 只能拆自己启动的会话)。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |