skill-lifecycle

Skill Manager

Task Objectives

This Skill is used for full lifecycle management of skills, and all operations follow thethree-step process framework: consult information → execute operations → check acceptance.

Core Capabilities

• Skill lifecycle management: create new skills, modify existing skills, version control
• Documentation standard formulation: provide simple/complex skill documentation writing standards, guide hierarchical document organization
• Skill integration: merge multiple skills into one new skill
• Skill splitting: split a complex skill into multiple independent skills
• Skill optimization: apply design patterns to improve skill quality

Optional Capabilities

• Workflow generation: generate a standardized WORKFLOW.md based on skills (only used when multiple skills need to be orchestrated)

Trigger Conditions

Triggered when skills need to be created, modified, integrated, split, or optimized.

---

Three-Step Process Framework

All skill operations follow a unified three-step process:

┌─────────────────────────────────────────────────────────────┐
│  第一步：查阅信息 (Research)                                  │
│  ├── 检查当前技能结构（如修改/优化现有技能）                  │
│  ├── 阅读 skill-standards.md 了解规范                        │
│  └── 理解技能目标和使用场景                                   │
├─────────────────────────────────────────────────────────────┤
│  第二步：执行操作 (Execute)                                   │
│  ├── 创建/修改/优化 SKILL.md                                 │
│  ├── 完善技能描述和能力定义                                   │
│  └── 编写使用示例和注意事项                                   │
├─────────────────────────────────────────────────────────────┤
│  第三步：检查验收 (Validate)                                  │
│  ├── 执行标准化检验（使用 skill-standards.md）              │
│  ├── 验证前言区字段完整性                                     │
│  └── 确认文档质量和一致性                                     │
└─────────────────────────────────────────────────────────────┘

---

Scenario Operation Guide

Scenario A: Create a New Skill

Lifecycle: design → development → testing → release Reference Documents: scenario-create.md

Scenario B: Modify a Skill

Lifecycle: development → testing → release → maintenance Reference Documents: scenario-modify.md

Scenario C: Optimize a Skill

Lifecycle: design → development → testing → release Reference Documents: scenario-optimize.md

Scenario D: Integrate Skills

Lifecycle: design → development → testing → release Reference Documents: scenario-integrate.md

Scenario E: Split a Skill

Lifecycle: design → development → testing → release Reference Documents: scenario-decompose.md

---

Documentation Writing Standards

Simple Skills vs Complex Skills

Choose the appropriate document organization method based on skill complexity:

Simple skills(single function, simple logic):

• Directly in SKILL.md fully describe all functions
• Applicable to: utility skills, body text < 300 lines, no complex configuration required

Complex skills(multiple modules, complex logic):

• SKILL.md serves only as an overview and index
• Detailed content is split into references/ subfiles
• Applicable to: multi-module collaboration, requiring detailed documentation, supporting multi-person collaboration

Judgment Criteria:

• Number of functions: single function vs multiple sub-functions
• Documentation size: < 300 lines vs ≥ 300 lines
• Configuration complexity: simple vs complex
• Dependencies: no dependencies vs requires orchestration

Detailed Standards: see skill-standards.md

---

Reference Documents

Document	Purpose	When to Use
skill-standards.md	Standardized specifications + inspection guide + documentation writing standards	Consult before all operations
scenario-create.md	Scenario: Create a new skill	When creating a skill
scenario-modify.md	Scenario: Modify a skill	When modifying a skill
scenario-optimize.md	Scenario: Optimize a skill	When optimizing a skill
scenario-integrate.md	Scenario: Consolidate skills	When consolidating skills
scenario-decompose.md	Scenario: Split a skill	When splitting a skill
workflow-generation.md	Workflow generation (optional)	When a workflow needs to be orchestrated

---

Precautions

• Core principles: All skill operations must follow the three-step process of "review - execute - check"
• Standardization first: Be sure to read skill-standards.md before creating/modifying a skill
• Quality assurance: Standardized verification must be performed after each operation is completed
• Version control: Important modifications require updating the version number and recording the changes
• Backward compatibility: Try to maintain backward compatibility when modifying

---

Usage example

Example: Create a new skill (complete three-step process)

Requirement: Create a data cleaning skill

Step 1: Review information

1. 阅读 skill-standards.md
   - 命名规范：使用 data-cleaner
   - 前言区必需字段：name, version, author, description, tags
   - description 长度：100-150 字符

2. 阅读 scenario-create.md
   - 了解创建流程
   - 生命周期：设计→开发→测试→发布

3. 分析需求
   - 核心问题：清洗原始数据
   - 目标用户：数据分析师
   - 触发场景：获得原始数据需要预处理时

Step 2: Execute operations

1. 创建目录：mkdir data-cleaner

2. 编写 SKILL.md（包含完整元信息）：
   ---
   name: data-cleaner
   version: v1.0.0
   author: skill-lifecycle
   description: 数据清洗技能，支持缺失值处理、去重和格式标准化
   tags: [data-cleaning, preprocessing, validation]
   ---

3. 编写正文内容（任务目标、操作步骤、示例、注意事项）

4. 创建版本标签：git tag -a v1.0.0

Step 3: Check and accept

□ 元信息完整性检查
  - name: data-cleaner（符合规范）
  - version: v1.0.0（格式正确）
  - author: skill-lifecycle（存在）
  - description: 符合长度要求（100-150字符）
  - tags: 至少3个标签

□ 内容质量检查
  - 正文体量 < 500行
  - 包含所有必需章节
  - 示例完整可复制

检验结果: ✅ 通过