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](resources/memory-schema.md)
类型标签
| 标签 | 含义 |
|---|---|
[CORE] |
核心原则，永恒不变 |
[PATTERN] |
可复用模式 |
[DECISION] |
时间点决策 |
[TIP] |
实用技巧 |
禁止事项
- ❌ 在 memory.md 中放置代码块
- ❌ 添加废话或显而易见的内容
- ❌ TL;DR 超过 10 条
质量门禁
INHERIT
- 读取了 memory.md TL;DR
- 读取了 rule-one.md
- 理解项目核心规则
DEPOSIT
- 新增内容真正有价值
- 表述足够精炼
- 已标注类型标签
- 已移除代码示例