deep-session-learner

name	deep-session-learner
description	Khai thác và học hỏi kinh nghiệm từ session chat hiện tại. Đóng gói thành markdown và ghi vào knowledge base của dự án. Trigger: "học từ session", "trích xuất kiến thức", "lưu vào knowledge".
category	meta
version	2.0.0
pipeline	{"stage_order":"standalone","input_contract":[{"type":"env","name":"CURRENT_SESSION","description":"Session context hiện tại","required":false}],"output_contract":[{"type":"file","path":"{knowledge_path}/{category}/{filename}.md","format":"markdown"}],"dependencies":[]}
progressive_disclosure	{"tier1":[{"path":"SKILL.md","base":"skill_dir"}],"tier2":[{"path":"knowledge/session-extraction.md","base":"skill_dir","load_when":"Auto-loaded at start"},{"path":"templates/knowledge-entry.template","base":"skill_dir","load_when":"Step WRITE"}]}
author	Steve Void Team
license	private
metadata	{"hermes":{"tags":["session-learning","knowledge-base","meta","documentation"],"related_skills":[]}}

🚨 MỆNH LỆNH BẮT BUỘC TỪ HỆ THỐNG Bạn CHỈ MỚI ĐỌC file SKILL.md này. Hệ thống KHÔNG tự động nạp các file khác. Tier 1 = SKILL.md (mandatory). Tier 2 = Auto-loaded at start.

---

Session Learner v2.0

Mission

Act as a Knowledge Harvester. Scan the current session chat, extract valuable insights, lessons learned, patterns, and knowledge, then package them into well-structured markdown files and save to the project's knowledge base.

Tối ưu hóa: Thay vì nhiều bước riêng biệt với interaction gates, skill này chạy 1-PASS — scan → extract → write → verify trong 1 lần chạy duy nhất. Không hỏi user trừ khi cần xác nhận overwrite.

Hardcoded Configuration

Knowledge Base Path: /home/steve/Work-space/deep_work_by_steve/knowledge/
Allowed Categories: experience, projects, notes, programming, resources
Session Date Format: YYYY-MM-DD

1-PASS Workflow

┌─────────────────────────────────────────────────────────────────────┐
│                     1-PASS KNOWLEDGE EXTRACTION                     │
├─────────────────────────────────────────────────────────────────────┤
│  SCAN → EXTRACT → WRITE → VERIFY → DELIVER (không dừng giữa các bước) │
└─────────────────────────────────────────────────────────────────────┘

Step 1: SCAN (scan toàn bộ session)

Scan messages từ đầu session, collect tất cả candidates:

• 🔍 Problem-solving exchanges
• 💡 Lightbulb moments ("aha!", "tôi hiểu rồi", "phát hiện")
• ⚠️ Warnings or cautions
• ✅ Confirmations of approach
• 🔧 Tool or command usage
• 📚 Explanations or teaching moments
• 🔄 Workflow improvements discovered
• 🎯 Decisions made with reasoning

Step 2: EXTRACT (categorize và structure)

Đọc knowledge/session-extraction.md để apply extraction guidelines. Tự động detect category và generate filename.

Category Detection:

- experience/  — Personal lessons, mistakes, discoveries
- projects/    — Project-specific knowledge, ADRs, architecture
- notes/       — Quick notes, ideas, reminders, TODOs
- programming/ — Technical patterns, commands, tool usage
- resources/   — URLs, docs, references

Filename Generation (Session-Specific Naming):

Format: YYYY-MM-DD.{session-name}.md
Example: 2026-05-09.skill-suite-v3-upgrade.md

session_name = sanitize(topic/keyword từ session)
                → lowercase
                → hyphenated
                → unique trong category folder