Session managing

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

• 新增内容真正有价值
• 表述足够精炼
• 已标注类型标签
• 已移除代码示例