关于 session-flow
session-flow 是一项用于在切换会话或上下文压缩后重新定位的技能,通过对话证据整理目标、进展、决策与后续步骤。它提供完整、简短和重置模式,并可管理由自身创建的阶段任务。
主要功能
- 01按对话证据重建阶段
- 02区分完成、待办与放弃路径
- 03提供完整、简短和重置模式
- 04管理带标记的阶段任务
适用场景
- 01切换会话后快速了解进展
- 02上下文压缩后恢复工作脉络
- 03查看仍待用户决定的事项
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ yeachan-heo/ oh-my-claudecode --skill session-flow安装后在 Claude Code 中输入/session-flow确认已加载。
详细介绍
会话流程
构建一份简洁且有证据支持的地图,梳理本次对话实际如何展开,帮助用户在切换会话或压缩上下文后重新定位。这是一份建议性摘要,不是规划器、执行器,也不能替代用户的任务列表。
模式
- 不带参数:呈现完整地图;如果原生 Task 工具可用,则同步更新会话流程 Tasks。
short:仅返回目标、当前阶段,以及用户需要做什么(如有)。只读;不要更改 Tasks。reset:仅查找并删除由此技能管理的 Tasks,然后确认删除了哪些内容。不要呈现新地图。
工作流
- 根据本次对话中的用户消息和工具结果重建流程。不要仅凭仓库状态断定某个阶段已经发生。区分原始目标、明确的目标变更、方向调整、已完成的结果、放弃的路径,以及仍待用户决定的事项。
- 在历史记录支持的情况下,列出 4–8 个有意义的阶段;历史记录稀少时宁可减少阶段,也不要凑数或虚构工作。每个阶段只使用一种结果标记:
✅已完成,且有对话内容支持其结果▶当前尚未完成的阶段○已明确计划但尚未开始的阶段✂已放弃,并注明给出的原因↪方向调整,注明旧方向和有证据支持的新方向
- 为每个阶段提供一个简短的证据指引。对话中出现 URL 或工件路径时使用它们;否则引用一条有辨识度的简短用户原话或工具结果。绝不虚构链接,也不把推断写成事实。对于不确定或压缩前的重建内容,标注为
inferred。 - 完整地图最多 15 行:每个阶段占一行,另加简洁的目标、
Needs you和Next行。将尚未解决的决定列入Needs you;没有时写none。只有对话内容支持时,Next才填写具体的下一步操作。 - 在默认模式和
reset模式下,先调用TaskList,并使用TaskGet检查每个[S<number>]候选项,然后再修改。只有当 Task 的主题以[S<number>]开头,且描述包含精确标记行session-flow: managed stage时,该 Task 才属于此技能。绝不编辑、完成、删除或复用未标记的 Task。 - 在默认模式下,更新仍对应某个阶段的自有 Tasks;使用
TaskCreate为缺失阶段创建 Tasks,主题以[S<number>]开头,描述第一行写入所有权标记,后接阶段证据。状态须与地图对应:已完成(包括已放弃或已调整方向的阶段)为completed,当前阶段为in_progress,已计划阶段为pending。使用TaskUpdate将不再出现在重建地图中的自有 Tasks 状态设为deleted;保留现有阶段编号,避免与非自有 Tasks 冲突。 - OMC 延续钩子会排除同时满足
[S<number>]主题前缀和精确所有权标记的 Tasks,因此这些描述性记录不会被视为未完成工作。每次创建或更新时,都要保留这两个标记。short模式不得调用会修改状态的 Task 工具。 - 对于
reset,使用TaskList和TaskGet查找自有 Tasks,然后仅对确认属于此技能的 Tasks 使用TaskUpdate将状态设为deleted。 - 如果原生 Task 工具不可用,则呈现地图,但不要声称地图已持久化。对于
reset,说明无法检查或删除自有 Tasks;不要猜测哪些 Tasks 属于此技能。
输出
采用稳定、简洁的格式:
🎯 Goal: <goal and any evidenced change>
✅ S1 <stage> → <outcome> — evidence: <source pointer>
↪ S2 <old direction> → <new direction> — evidence: <source pointer>
▶ S3 <current stage> — evidence: <source pointer>
✂ S4 <dropped path> — <reason> — evidence: <source pointer>
⏸ Needs you: <decision or none>
➡ Next: <supported next action or none>
省略不适用的示例行。除非对话提供了需要修正的证据,否则保持阶段顺序稳定;如有修正,同步更新自有 Tasks 以匹配。
评论
支持 Markdown