Skill Manager

任务目标

本 Skill 用于技能全生命周期管理，所有操作遵循三步流程框架：查阅信息 → 执行操作 → 检查验收。

核心能力

• 技能生命周期管理: 创建新技能、修改现有技能、版本控制
• 文档规范制定: 提供简单/复杂技能文档编写标准，指导文档分层组织
• 技能整合: 将多个技能合并为一个新技能
• 技能拆分: 将复杂技能拆分为多个独立技能
• 技能优化: 应用设计模式提升技能质量

可选能力

• 工作流生成: 根据技能生成标准化 WORKFLOW.md（仅在需要编排多个技能时使用）

触发条件

当需要创建、修改、整合、拆分或优化技能时触发。

---

三步流程框架

所有技能操作遵循统一的三步流程：

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

---

场景操作指南

场景 A: 创建新技能

生命周期: 设计 → 开发 → 测试 → 发布 参考文档: scenario-create.md

场景 B: 修改技能

生命周期: 开发 → 测试 → 发布 → 维护 参考文档: scenario-modify.md

场景 C: 优化技能

生命周期: 设计 → 开发 → 测试 → 发布 参考文档: scenario-optimize.md

场景 D: 整合技能

生命周期: 设计 → 开发 → 测试 → 发布 参考文档: scenario-integrate.md

场景 E: 拆分技能

生命周期: 设计 → 开发 → 测试 → 发布 参考文档: scenario-decompose.md

---

文档编写规范

简单技能 vs 复杂技能

根据技能复杂度选择合适的文档组织方式：

简单技能（功能单一、逻辑简单）:

• 直接在 SKILL.md 中完整描述所有功能
• 适用于：工具类技能、正文 < 300 行、无需复杂配置

复杂技能（多模块、逻辑复杂）:

• SKILL.md 仅作为概览和索引
• 详细内容拆分到 references/ 子文件
• 适用于：多模块协作、需要详细文档、支持多人协作

判断标准:

• 功能数量：单一功能 vs 多个子功能
• 文档体量：< 300 行 vs ≥ 300 行
• 配置复杂度：简单 vs 复杂
• 依赖关系：无依赖 vs 需要编排

详细规范: 见 skill-standards.md

---

参考文档

文档	用途	何时使用
skill-standards.md	标准化规范 + 检验指南 + 文档编写规范	所有操作前查阅
scenario-create.md	场景：创建新技能	创建技能时
scenario-modify.md	场景：修改技能	修改技能时
scenario-optimize.md	场景：优化技能	优化技能时
scenario-integrate.md	场景：整合技能	整合技能时
scenario-decompose.md	场景：拆分技能	拆分技能时
workflow-generation.md	工作流生成（可选）	需要编排工作流时

---

注意事项

• 核心原则: 所有技能操作必须遵循"查阅-执行-检查"三步流程
• 标准化优先: 创建/修改技能前务必阅读 skill-standards.md
• 质量保障: 每个操作完成后必须执行标准化检验
• 版本控制: 重要修改需更新版本号并记录变更
• 向后兼容: 修改时尽量保持向后兼容

---

使用示例

示例: 创建新技能（完整三步流程）

需求: 创建数据清洗技能

第一步：查阅信息

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

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

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

第二步：执行操作

1. 创建目录：mkdir data-cleaner

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

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

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

第三步：检查验收

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

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

检验结果: ✅ 通过