kkfor30/kk-sessions / skills/kk-session-setup
kk-session-setup
Verified首次使用 kk-sessions 时生成工作区地图:读现有会话的标题和工作目录,推测分区和对应目录,和用户确认后写入 ~/.agent-rules/workspace-map.md,在侧栏建好分区,再问要不要整理旧会话。用户说"初始化会话分区""生成工作区地图""kk-session-setup",或 kk-session-route 发现还没有地图时使用;用户要重新规划分区时也用。支持 Claude Code 桌面端和 Codex 桌面端。不用于单个会话归位(kk-session-route)或批量改名(kk-session-tidy)。
kk-session-setup
输入
- 本目录的
workspace-map.template.md:地图模板。「标题」「嵌套会话」「跟进」三节是通用规则,原样保留;「分区」表和其后的说明是示例,要换成用户自己的。 - 六个动作的做法见 kk-session-route 的「六个动作」「适配」两节,这里用列出全部会话、列出和新建分区。
流程
- 检查现状:
~/.agent-rules/workspace-map.md已存在时,先列出其中的分区,问用户选哪种:- 沿用地图(地图是在另一个 Agent 里生成的,这个 Agent 第一次用):不改地图,直接跳到第 6 步,在当前 Agent 的侧栏建好同名分区。
- 补几个分区:在原文件上改,不重写,然后第 6 步。
- 重新规划:从第 2 步开始。另一个 Agent 也在用这张地图时,提醒用户:那边的侧栏还是旧分区,写完新地图后在那边也说一次「初始化会话分区」并选「沿用地图」,第 6 步会把侧栏对齐。
- 收集线索(只看元数据,不读聊天记录):
- 列出全部会话(含已归档),取标题、工作目录、已有分区。会话超过 100 个时,只取最近 90 天活动过的,够推出分区即可。
- 把工作目录按上级目录归并,统计每个目录下有多少会话;对出现较多的根目录,列一层子目录。
- 拟分区:按"领域"而不是"做哪类事"分,通常 4 到 7 个;每个分区一个颜色 emoji(🔴🟠🟡🟢🔵🟣🟤⚫⚪ 等)加 2 到 4 个字的名字,名字用用户会话里自己的叫法。分区只从这一步收集到的线索推出来,不照搬模板或其他文档里现成的分区表。每个分区写清:
- 产物目录:优先用会话里已经在用的目录;需要按主题再分的写成
<根目录>\<主题>\。 - 放什么、判定线索:从会话标题里提炼用户自己的说法。
- 固定加一个
📦 杂项兜底(一次性问答、电脑设置),目录选一个已有的杂项目录或建议新建一个。 - 用户常试用开源项目时,加一个试用目录
<项目根>\_试用\<名称>-<YYYYMMDD>\。
- 产物目录:优先用会话里已经在用的目录;需要按主题再分的写成
- 和用户确认:用一张表给出分区、产物目录、放什么、判定线索,并说明每个分区大约覆盖了哪些现有会话。用户改完明确确认后再写。
- 写地图:以模板为底,替换「分区」表和其后的说明,删掉模板说明那一行,用文件写入工具直接写到
~/.agent-rules/workspace-map.md,不要用 shell 或脚本拼接内容(Windows 路径里的\b、\n会被当成转义符);写完读回分区表,核对路径一字不差。目录不存在就建。表里没出现的目录不建,等 kk-session-route 用到时再建。 - 对齐侧栏分区:先按 kk-session-restore 的「快照」一节存快照(已有就跳过),再把侧栏现有分区和地图逐个对照:
- 名字完全相同:跳过。
- 名字去掉开头 emoji 和空格后相同,或明显是同一个领域(如侧栏「⚫ Skill 工具」对地图「🔴 Skill工具」、「🟡 商单」对「🟠 商务」):拟把侧栏分区改名成地图里的名字,里面的会话原样保留。不要另建一个新分区,否则侧栏会出现两个同领域的分区。
- 地图有、侧栏没有:新建。
- 侧栏有、地图里对不上的(如地图里没有的「🟢 工作」):不动,列出来问用户是补进地图、并入某个分区,还是保留不管。 改名和新建列成一张表,用户确认后执行;当前 Agent 不能改分区名时,标「需手动」。
- 收尾:报告建了几个分区、地图写在哪;问用户要不要现在整理旧会话,要就转 kk-session-tidy。
边界
- 只写地图、建分区、按第 6 步给分区改名,不移动会话、不改会话标题、不删除分区、不移动或删除用户的文件夹。
- 会话很少(少于 5 个)时线索不够,按用户磁盘上已有的顶层目录拟几个起步分区让用户改,并说明以后可以再运行一次。
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: 468k | 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: 321k | 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: 321k | 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: 321k | Updated | Claude CodeCodex | Verified | Install |