AgentSkillsCN

storage-templates

在设计存储与文档系统时,请参考此技能。适用于整理知识存储、管理配置生命周期、创建结构化文档、确立命名规范时使用。切勿在仅需简单存储、无需生命周期或结构化设计时使用此技能。

SKILL.md
--- frontmatter
name: storage-templates
description: Consult this skill when designing storage and documentation systems.
  Use when organizing knowledge storage, managing configuration lifecycle, creating
  structured documentation, establishing naming conventions. Do not use when simple
  storage without lifecycle or structure needs.
category: infrastructure
tags:
- templates
- storage
- lifecycle
- maturity
- organization
- patterns
dependencies: []
provides:
  infrastructure:
  - templates
  - lifecycle-management
  - naming-conventions
  patterns:
  - maturity-stages
  - template-structures
  - file-organization
usage_patterns:
- knowledge-management
- documentation-systems
- configuration-management
complexity: beginner
estimated_tokens: 600
progressive_loading: true
modules:
- modules/template-patterns.md
- modules/lifecycle-stages.md
version: 1.4.0

Table of Contents

Storage Templates

Overview

Generic template patterns and lifecycle management for structured content storage. Provides reusable templates, maturity progression models, and file naming conventions that work across different storage domains.

When To Use

  • Building knowledge management systems
  • Organizing documentation with maturity stages
  • Need consistent file naming patterns
  • Want template-driven content creation
  • Implementing lifecycle-based workflows

When NOT To Use

  • Simple storage without lifecycle or structure needs

Core Concepts

Template Types

TypePurposeMaturityLifetime
EvergreenStable, proven knowledgeHighPermanent
GrowingActive developmentMedium1-3 months
SeedlingEarly ideasLow1-2 weeks
ReferenceTool/version-specificN/AUntil deprecated

Maturity Lifecycle

code
seedling → growing → evergreen → archive
    ↓         ↓          ↓           ↓
 1-2 weeks  1-3 months  permanent  deprecated

Verification: Run the command with --help flag to verify availability.

Quick Start

Basic Template Structure

yaml
---
title: [Content Title]
created: [YYYY-MM-DD]
maturity: seedling|growing|evergreen|reference
tags: [relevant, tags]
---

# [Title]

## Core Content
[Main information]

## Metadata
[Context and attribution]

Verification: Run the command with --help flag to verify availability.

File Naming Conventions

TypePatternExample
Evergreentopic-name.mdfunctional-core-pattern.md
Growingtopic-name.mdasync-patterns.md
SeedlingYYYY-MM-DD-topic.md2025-12-05-template-idea.md
Referencetool-version.mdpython-3.12-features.md

Domain Applications

Add domain-specific fields to templates:

  • memory-palace: palace, district for knowledge organization
  • sanctum: scope, version for commit templates
  • spec-kit: phase, status for specifications

See modules/template-patterns.md for detailed examples.

Common Patterns

Promotion Workflow

Seedling → Growing:

  • Accessed more than once
  • Connected to other entries
  • Expanded with new insights

Growing → Evergreen:

  • Proven useful over 3+ months
  • Stable, not frequently edited
  • Well-connected in system

Evergreen → Archive:

  • Superseded by newer knowledge
  • Technology/approach deprecated
  • No longer applicable

Template Selection Guide

StabilityPurposeTemplate
ProvenLong-termEvergreen
EvolvingActive developmentGrowing
ExperimentalExplorationSeedling
VersionedExternal referenceReference

Integration Pattern

yaml
# In your skill's frontmatter
dependencies: [leyline:storage-templates]

Verification: Run the command with --help flag to verify availability.

Detailed Resources

  • Templates: See modules/template-patterns.md for detailed structures
  • Lifecycle: See modules/lifecycle-stages.md for maturity progression

Exit Criteria

  • Template selected for use case
  • File naming convention applied
  • Maturity stage assigned
  • Promotion criteria understood

Troubleshooting

Common Issues

Command not found Ensure all dependencies are installed and in PATH

Permission errors Check file permissions and run with appropriate privileges

Unexpected behavior Enable verbose logging with --verbose flag