knowledge-consolidation

Consolidate and persist knowledge from AI conversations into structured documents. Use when user asks to summarize, consolidate, save knowledge, document insights, or preserve learnings. Triggers on: '总结一下', '记录下来', 'save this knowledge', 'document this', 'we figured it out', 'that was hard to solve'. Saves to .trae/knowledges/, .claude/knowledges/, or .cursor/knowledges/ based on AI IDE.

Knowledge Consolidation

Persist valuable knowledge from AI conversations into structured documents.

Workflow

1. DETECT AI IDE → Check for .trae/, .claude/, .cursor/
2. IDENTIFY CANDIDATES → Scan for knowledge worth preserving
3. CLASSIFY TYPE → Select appropriate knowledge type
4. GENERATE PATH → Run get-knowledge-path.sh
5. WRITE DOCUMENT → Use template format

Step 1: Detect AI IDE

Indicator	AI Type	Storage Path
`.trae/` dir	trae	`.trae/knowledges/`
`.claude/` dir	claude-code	`.claude/knowledges/`
`.cursor/` dir	cursor	`.cursor/knowledges/`

Step 2: Knowledge Types

Type	When to Use
`debug`	Bug fixes, crash analysis, error resolution
`architecture`	System design, module structure
`pattern`	Reusable code patterns, best practices
`config`	Build settings, environment setup
`api`	API design, integration details
`workflow`	Development processes
`lesson`	Post-mortems, retrospectives

Step 3: Generate Path

{skill_root}/scripts/get-knowledge-path.sh -r <project_root> -a <ai_type> -t <type> -n <filename>

Output: {project_root}/{ai_path}/knowledges/{YYYYMMDD}_{seq}_{type}_{filename}.md

Step 4: Write Document

Use template:

# {Title}

> **Type:** {type}
> **Date:** {YYYY-MM-DD}
> **Context:** {Brief context}

## Summary

{2-3 sentence summary}

## Background

{Situation/problem/context}

## Details

{Technical content, code snippets, analysis}

## Key Takeaways

{Bullet points of actionable insights}

Resources

Resource	Purpose
`scripts/get-knowledge-path.sh`	Generate file path
`references/knowledge-types.md`	Type selection guide
`assets/knowledge.md.template`	Document template