mcpField
S
session-flow

session-flow

github.com/yeachan-heoAgent 工作流40.4k61 次安装1 天前更新
代码仓库

关于 session-flow

session-flow 是一项用于在切换会话或上下文压缩后重新定位的技能,通过对话证据整理目标、进展、决策与后续步骤。它提供完整、简短和重置模式,并可管理由自身创建的阶段任务。

主要功能

  1. 01按对话证据重建阶段
  2. 02区分完成、待办与放弃路径
  3. 03提供完整、简短和重置模式
  4. 04管理带标记的阶段任务

适用场景

  1. 01切换会话后快速了解进展
  2. 02上下文压缩后恢复工作脉络
  3. 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,然后确认删除了哪些内容。不要呈现新地图。

工作流

  1. 根据本次对话中的用户消息和工具结果重建流程。不要仅凭仓库状态断定某个阶段已经发生。区分原始目标、明确的目标变更、方向调整、已完成的结果、放弃的路径,以及仍待用户决定的事项。
  2. 在历史记录支持的情况下,列出 4–8 个有意义的阶段;历史记录稀少时宁可减少阶段,也不要凑数或虚构工作。每个阶段只使用一种结果标记:
    • ✅ 已完成,且有对话内容支持其结果
    • ▶ 当前尚未完成的阶段
    • ○ 已明确计划但尚未开始的阶段
    • ✂ 已放弃,并注明给出的原因
    • ↪ 方向调整,注明旧方向和有证据支持的新方向
  3. 为每个阶段提供一个简短的证据指引。对话中出现 URL 或工件路径时使用它们;否则引用一条有辨识度的简短用户原话或工具结果。绝不虚构链接,也不把推断写成事实。对于不确定或压缩前的重建内容,标注为 inferred。
  4. 完整地图最多 15 行:每个阶段占一行,另加简洁的目标、Needs you 和 Next 行。将尚未解决的决定列入 Needs you;没有时写 none。只有对话内容支持时,Next 才填写具体的下一步操作。
  5. 在默认模式和 reset 模式下,先调用 TaskList,并使用 TaskGet 检查每个 [S<number>] 候选项,然后再修改。只有当 Task 的主题以 [S<number>] 开头,且描述包含精确标记行 session-flow: managed stage 时,该 Task 才属于此技能。绝不编辑、完成、删除或复用未标记的 Task。
  6. 在默认模式下,更新仍对应某个阶段的自有 Tasks;使用 TaskCreate 为缺失阶段创建 Tasks,主题以 [S<number>] 开头,描述第一行写入所有权标记,后接阶段证据。状态须与地图对应:已完成(包括已放弃或已调整方向的阶段)为 completed,当前阶段为 in_progress,已计划阶段为 pending。使用 TaskUpdate 将不再出现在重建地图中的自有 Tasks 状态设为 deleted;保留现有阶段编号,避免与非自有 Tasks 冲突。
  7. OMC 延续钩子会排除同时满足 [S<number>] 主题前缀和精确所有权标记的 Tasks,因此这些描述性记录不会被视为未完成工作。每次创建或更新时,都要保留这两个标记。short 模式不得调用会修改状态的 Task 工具。
  8. 对于 reset,使用 TaskList 和 TaskGet 查找自有 Tasks,然后仅对确认属于此技能的 Tasks 使用 TaskUpdate 将状态设为 deleted。
  9. 如果原生 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