session-managing

SKILL.md

Session Lifecycle Skill

核心理念: 会话生命周期 = 继承 → 工作 → 沉淀 → 闭环升级


自动触发协议

本 Skill 无需手动调用,AI 会在适当时机自动激活。

INHERIT 模式 (继承)

触发时机:

  • 新对话开始 (对话历史为空)
  • 用户发出首个任务型请求
  • 用户明确说 "开始"、"入职"、"onboarding"

执行动作:

1. view_file doc/memory.md (读取 TL;DR 10 条核心认知)
2. view_file .agent/rules/rule-one.md
3. (复杂任务) view_file doc/explanation/architecture.md
4. 静默继承,不打断用户工作流

输出: 无 (静默执行) 或简短确认


DEPOSIT 模式 (沉淀)

触发时机 (满足任一条):

  • 产生了新的设计决策或架构选择
  • 发现并解决了隐藏的技术问题
  • 形成了可复用的编程模式或最佳实践
  • 产生了"这个想法太妙了"的闪光洞察
  • 对话即将结束且有沉淀价值

执行动作:

1. 提炼本次对话精华 (CORE/PATTERN/DECISION/TIP)
2. view_file doc/memory.md
3. 融合更新 doc/memory.md (去重升维)
4. 如为技术规范 → 写入 doc/specs/
5. 通知用户完成

输出:

## 📦 沉淀完成

**本次新增**:
- `[PATTERN]` {模式名}
- `[DECISION]` {决策名}

✅ memory.md 已更新 (累计 N 条)

手动覆盖

用户可随时说:

  • "跳过 onboarding" → 禁用 INHERIT
  • "沉淀本次对话" → 强制 DEPOSIT
  • "不需要沉淀" → 禁用 DEPOSIT

Doc 系统集成 (Diátaxis)

INHERIT 读取链 (优先级从高到低)

层级 文件 策略 说明
L1 必读 doc/memory.md (TL;DR) 始终 核心认知与原则
L1 必读 .agent/rules/rule-one.md 始终 项目宪章与禁忌
L2 按需 doc/explanation/README.md 架构与全貌 系统索引
L3 上下文 doc/explanation/subsystems/{xxx}.md 特定 Feature 深度理解子系统
L3 上下文 doc/specs/{xxx}.md 特定 Feature 查阅具体规范
L4 入门 doc/tutorials/quick-start.md 新手/重置 环境搭建与启动

DEPOSIT 写入链

根据知识类型选择写入位置:

知识类型 (Diátaxis) 写入目标 示例
Core Wisdom (智慧/决策) doc/memory.md 设计哲学、架构决策、踩坑教训
Understanding (原理/架构) doc/explanation/subsystems/ 模块架构图、核心机制解析
Reference (规范/规则) doc/specs/ API 定义、业务规则、边界情况
How-To (指南/测试) doc/how-to/ 测试策略、调试指南、操作手册
Archive (历史/草稿) doc/archive/ 过时的设计文档、被取代的方案

记忆格式规范

详见 memory-schema.md

类型标签

标签 含义
[CORE] 核心原则,永恒不变
[PATTERN] 可复用模式
[DECISION] 时间点决策
[TIP] 实用技巧

禁止事项

  • ❌ 在 memory.md 中放置代码块
  • ❌ 添加废话或显而易见的内容
  • ❌ TL;DR 超过 10 条

质量门禁

INHERIT

  • 读取了 memory.md TL;DR
  • 读取了 rule-one.md
  • 理解项目核心规则

DEPOSIT

  • 新增内容真正有价值
  • 表述足够精炼
  • 已标注类型标签
  • 已移除代码示例
Weekly Installs
2
GitHub Stars
7
First Seen
Feb 4, 2026
Installed on
cline2
cursor2
openclaw2
mcpjam1
openhands1
zencoder1