mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-13 02:41:50 +08:00
15bf9cdbed
- Updated command invocation for SKILL memory generator to use session ID instead of incremental mode. - Enhanced documentation on the processing of archived sessions and intelligent aggregation by the agent. - Added templates for generating conflict patterns, lessons learned, SKILL index, and sessions timeline. - Established clear update strategies for incremental and full modes across all new templates. - Improved structure and formatting rules for better clarity and usability in generated documents.
126 lines
4.0 KiB
Plaintext
126 lines
4.0 KiB
Plaintext
Template for generating SKILL.md (index file)
|
|
|
|
## Purpose
|
|
Create main SKILL package index with progressive loading structure and session references.
|
|
|
|
## File Location
|
|
`.claude/skills/workflow-progress/SKILL.md`
|
|
|
|
## Update Strategy
|
|
- **Always regenerated**: This file is always updated with latest session count, domains, dates
|
|
|
|
## Structure
|
|
|
|
```yaml
|
|
---
|
|
name: workflow-progress
|
|
description: Progressive workflow development history (located at {project_root}). Load this SKILL when continuing development, analyzing past implementations, or learning from workflow history, especially when no relevant context exists in memory.
|
|
version: {semantic_version}
|
|
---
|
|
# Workflow Progress SKILL Package
|
|
|
|
## Documentation: `../../../.workflow/.archives/`
|
|
|
|
**Total Sessions**: {session_count}
|
|
**Functional Domains**: {domain_list}
|
|
**Date Range**: {earliest_date} - {latest_date}
|
|
|
|
## Progressive Loading
|
|
|
|
### Level 0: Quick Overview (~2K tokens)
|
|
- [Sessions Timeline](sessions-timeline.md#recent-sessions-last-5) - Recent 5 sessions
|
|
- [Top Conflict Patterns](conflict-patterns.md#top-patterns) - Top 3 recurring conflicts
|
|
- Quick reference for last completed work
|
|
|
|
**Use Case**: Quick context refresh before starting new task
|
|
|
|
### Level 1: Core History (~8K tokens)
|
|
- [Sessions Timeline](sessions-timeline.md) - Recent 10 sessions with details
|
|
- [Lessons Learned](lessons-learned.md#best-practices) - Success patterns by category
|
|
- [Conflict Patterns](conflict-patterns.md) - Known conflict types and resolutions
|
|
- Context package references (metadata only)
|
|
|
|
**Use Case**: Understanding recent development patterns and avoiding known pitfalls
|
|
|
|
### Level 2: Complete History (~25K tokens)
|
|
- All archived sessions with metadata
|
|
- Full lessons learned (successes, challenges, watch patterns)
|
|
- Complete conflict analysis with resolutions
|
|
- IMPL_PLAN summaries from all sessions
|
|
- Context package paths for on-demand loading
|
|
|
|
**Use Case**: Comprehensive review before major refactoring or architecture changes
|
|
|
|
### Level 3: Deep Dive (~40K tokens)
|
|
- Full IMPL_PLAN.md and TODO_LIST.md from all sessions
|
|
- Detailed task completion summaries
|
|
- Cross-session dependency analysis
|
|
- Direct context package file references
|
|
|
|
**Use Case**: Investigating specific implementation details or debugging historical decisions
|
|
|
|
---
|
|
|
|
## Quick Access
|
|
|
|
### Recent Sessions
|
|
{list of 5 most recent sessions with one-line descriptions}
|
|
|
|
### By Domain
|
|
- **{Domain_1}**: {count} sessions
|
|
- **{Domain_2}**: {count} sessions
|
|
- **{Domain_3}**: {count} sessions
|
|
|
|
### Top Watch Patterns
|
|
1. {most_frequent_watch_pattern}
|
|
2. {second_most_frequent}
|
|
3. {third_most_frequent}
|
|
|
|
---
|
|
|
|
## Session Index
|
|
|
|
### {Domain_Category} Sessions
|
|
- [{session_id}](../../../.workflow/.archives/{session_id}/) - {one_line_description} ({date})
|
|
- Context: [context-package.json](../../../.workflow/.archives/{session_id}/.process/context-package.json)
|
|
- Plan: [IMPL_PLAN.md](../../../.workflow/.archives/{session_id}/IMPL_PLAN.md)
|
|
- Tags: {tag1}, {tag2}, {tag3}
|
|
|
|
---
|
|
|
|
## Usage Examples
|
|
|
|
### Loading Quick Context
|
|
```markdown
|
|
Load Level 0 from workflow-progress SKILL for overview of recent work
|
|
```
|
|
|
|
### Investigating {Domain} History
|
|
```markdown
|
|
Load Level 2 from workflow-progress SKILL, filter by "{domain}" tag
|
|
```
|
|
|
|
### Full Historical Analysis
|
|
```markdown
|
|
Load Level 3 from workflow-progress SKILL for complete development history
|
|
```
|
|
```
|
|
|
|
## Data Sources
|
|
- Manifest: `.workflow/.archives/manifest.json`
|
|
- All session metadata from manifest entries
|
|
|
|
## Generation Rules
|
|
- Version format: `{major}.{minor}.{patch}` (increment patch for each update)
|
|
- Domain list: Extract unique tags from all sessions, sort by frequency
|
|
- Date range: Find earliest and latest archived_at timestamps
|
|
- Token estimates: Approximate based on content length
|
|
- Use relative paths (../../../.workflow/.archives/) for session references
|
|
|
|
## Formatting Rules
|
|
- Keep descriptions concise
|
|
- Sort sessions by date (newest first)
|
|
- Group sessions by primary tag
|
|
- Include only top 5 recent sessions in Quick Access
|
|
- Include top 3 watch patterns
|