Skip to content

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 的「六个动作」「适配」两节,这里用列出全部会话、列出和新建分区。

流程

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

边界

  • 只写地图、建分区、按第 6 步给分区改名,不移动会话、不改会话标题、不删除分区、不移动或删除用户的文件夹。
  • 会话很少(少于 5 个)时线索不够,按用户磁盘上已有的顶层目录拟几个起步分区让用户改,并说明以后可以再运行一次。
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: 468kUpdated Claude CodeCodexVerifiedInstall
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: 321kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 321kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 321kUpdated Claude CodeCodexVerifiedInstall