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)。

FileKindSize
SKILL.mdskill md4.6 KB
workspace-map.template.mdmarkdown2.9 KB

workspace-map.template.md

View on GitHub
# 工作区地图(会话路由索引)

`kk-session-route` 按本表决定新会话的产物目录、侧栏分区和标题。各 Agent 共用这一份;改分区或目录只改这里。

> 模板:`kk-session-setup` 生成地图时替换「分区」表和其后的说明,删掉本行,其余各节原样保留。

## 分区

| 分区(侧栏名) | 产物目录 | 放什么 | 判定线索 |
| --- | --- | --- | --- |
| <颜色emoji> <分区名> | `<根目录>\<主题>\` | <这个领域放什么> | <用户自己的说法、常见关键词> |
| 📦 杂项 | `<杂项目录>\` | 一次性问答、电脑设置 | 快速提问、系统设置、安装 |

- <按需补充:调研目录、试用目录、某类内容转正式时怎么移动文件夹。>
- 新主题在路由时就建目录和 `README.md`(是什么、状态:想法、下一步);子目录用到时再建。
- 和所有分区都对不上时,`kk-session-route` 会提议新分区和根目录,用户同意才建,并补进本表;不同意就归 📦 杂项。

## 标题

格式 `<类型emoji> <主题>|<这次做什么>`,emoji 之后不超过 20 个字,例如 `🎬 新品测评|口播精剪`。分区 emoji 表示领域,标题 emoji 表示这次做哪类事。

| emoji | 类型 | 什么时候用 |
| --- | --- | --- |
| ✍️ | 策划 | 选题、方案、脚本、文案、策略 |
| 🔍 | 调研 | 分析、评估、拆解、诊断 |
| 🧪 | 测试 | 试效果、模型对比、样片 |
| 🎬 | 制作 | 剪辑、动画、渲染、成片 |
| 📤 | 发布 | 平台上架、分发、提交、开源分享 |
| 🛠️ | 开发 | 写代码、做工具、Skill、配置 |
| 🐛 | 排查 | 报错、变慢、效果不对 |
| 💬 | 问答 | 一次性咨询、电脑设置 |

只用这 8 个,不新增;拿不准时选最贴近这次产出的那个。

**标题锁定**:主题第一次命名后锁定不变。emoji 和|后半段默认也不自动改;只有 `kk-session-tidy` 会对很长、阶段明显变化的会话提出改名建议,用户确认才改。末尾 ` ⏳` 是唯一由 Agent 按「跟进」自动增减的部分。

## 嵌套会话

- fork 或从会话里分出的子会话,沿用父会话的 `<主题>`,只换 emoji 和"这次做什么"。
- 子会话主题已经和父会话不同,在侧栏右键 **Detach to top level** 拆成顶层会话,再归到对应分区。

## 跟进

- **⏳ 待推进**:回复结尾留下只有用户能做、做完才能继续的事(验收、选方案、提交或发布)时,在标题**末尾**加 ` ⏳`。只是给出可选的后续建议时不加。用户回到会话继续推进时去掉。
- 用户觉得事已办完,直接在侧栏把 ⏳ 删掉即可。
- 置顶完全由用户手动决定。
- 加减 ⏳ 之外,Agent 不改已有标题;阶段改名由 `kk-session-tidy` 提建议、用户确认。
- 主题进度写在主题目录的 `README.md`(状态:想法 / 测试 / 制作 / 已发布,下一步)。
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: 472kUpdated 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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated 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: 322kUpdated Claude CodeCodexVerifiedInstall