🏗️ Skill Builder | 技能构建器

Overview | 概述

This meta-skill provides systematic capabilities for designing and building VS Code Agent Skills. It helps users create professional, well-structured skill packages that follow the Agent Skills open standard (agentskills.io).

此元技能提供系统化的 VS Code Agent Skills 设计和构建能力。帮助用户创建专业、结构良好的技能包，符合 Agent Skills 开放标准 (agentskills.io)。

Trigger Conditions | 触发条件

Keywords | 关键词: create skill, design skill, build skill, new skill, skill package, convert to skill, skill template, 创建技能, 设计技能, 构建技能, 新技能, 技能包, 转换为技能

Auto-suggestion | 自动建议:

"我看到您需要创建新的 Agent Skill。是否需要我启动技能构建器？我可以帮助您设计技能结构、编写 SKILL.md、创建模板和示例。"

Core Concepts | 核心概念

What is an Agent Skill? | 什么是 Agent Skill？

Agent Skills 是一种开放标准，允许创建可被 AI 代理（如 GitHub Copilot）按需加载的专业能力包：

.github/skills/[skill_name]/
├── SKILL.md              # 主技能定义（必需）
├── README.md             # 技能说明文档
├── templates/            # 模板文件目录
├── tools/                # 工具脚本目录
└── examples/             # 使用示例目录

SKILL.md Structure | SKILL.md 结构

SKILL.md 是技能的核心定义文件，必须包含 YAML frontmatter：

---
name: skill-name           # 技能标识名（kebab-case）
description: 技能描述...    # 触发条件描述（中英文双语推荐）
---

# 技能内容
[详细的技能指令和方法论]

Three-Level Loading | 三级加载机制

1. •Level 1 - Discovery: Copilot 始终知道有哪些技能可用（基于 name 和 description）
2. •Level 2 - Instructions: 匹配请求时加载 SKILL.md 的完整内容
3. •Level 3 - Resources: 按需访问 templates/, tools/, examples/ 中的文件

Skill Design Methodology | 技能设计方法论

IPD-Inspired Design Process | 基于IPD的设计流程

graph LR
    A[需求概念化] --> B[需求分析]
    B --> C[概念设计]
    C --> D[详细设计]
    D --> E[构建实现]
    E --> F[质量验证]

Phase 1: Concept | 需求概念化

Goals | 目标:

• •明确技能要解决的核心问题
• •定义技能的价值主张
• •确定技能的边界范围

Questions to Answer | 需要回答的问题:

1. •这个技能要解决什么问题？
2. •目标用户是谁？
3. •成功的标准是什么？
4. •技能的触发场景有哪些？

Phase 2: Analysis | 需求分析

Goals | 目标:

• •分析技能的复杂度
• •识别核心功能模块
• •评估技术可行性

Analysis Dimensions | 分析维度:

• •功能复杂度: 技能需要多少核心能力？
• •模板需求: 需要哪些标准化模板？
• •工具需求: 需要哪些自动化工具？
• •集成需求: 需要与哪些其他技能协作？

Phase 3: Conceptual Design | 概念设计

Goals | 目标:

• •设计技能的整体架构
• •选择合适的设计模式
• •规划目录结构

Design Patterns for Skills | 技能设计模式:

Phase 4: Detailed Design | 详细设计

Goals | 目标:

• •设计 SKILL.md 的详细内容
• •规划每个模板的结构
• •定义工具的接口

SKILL.md Content Design | SKILL.md 内容设计:

---
name: [skill-name]
description: [触发描述，包含关键词]
---

# 技能标题

## Overview | 概述
[技能的简要说明]

## Trigger Conditions | 触发条件
[关键词列表和自动建议语句]

## Core Methodology | 核心方法论
[技能的核心工作方法]

## Workflow Steps | 工作流步骤
[详细的执行步骤]

## Templates | 模板
[可用模板列表和说明]

## Usage Examples | 使用示例
[典型使用场景]

## Best Practices | 最佳实践
[使用建议和注意事项]

## References | 参考
[相关资源链接]

Phase 5: Build | 构建实现

Goals | 目标:

• •创建目录结构
• •编写 SKILL.md
• •创建模板文件
• •编写示例

Standard Directory Structure | 标准目录结构:

.github/skills/[skill_name]/
├── SKILL.md                    # 主技能定义
├── README.md                   # 技能说明（可选但推荐）
├── templates/                  # 模板目录
│   ├── [template-1].md
│   ├── [template-2].md
│   └── ...
├── tools/                      # 工具目录（可选）
│   ├── [tool-1].py
│   └── [tool-1]-README.md
└── examples/                   # 示例目录
    └── README.md               # 使用示例

Phase 6: Quality Assurance | 质量验证

Quality Checklist | 质量检查清单:

• •

  SKILL.md 完整性

  • • YAML frontmatter 正确（name, description）
  • • 触发关键词覆盖主要使用场景
  • • 方法论清晰可执行
  • • 步骤描述详细
• •

  模板质量

  • • 模板结构清晰
  • • 占位符易于理解
  • • 示例内容有帮助
• •

  文档质量

  • • README 说明完整
  • • 示例覆盖典型场景
  • • 双语支持（推荐）
• •

  可用性验证

  • • 技能可被正确触发
  • • 流程可顺利执行
  • • 输出符合预期

Skill Conversion Guide | 技能转换指南

Converting Workflow to Skill | 将工作流转换为技能

When converting an existing workflow system to an Agent Skill:

1. •

   分析原工作流

   • •识别核心方法论和流程
   • •提取关键模板
   • •理解触发场景
2. •

   设计触发条件

   • •提取关键词（中英文）
   • •编写 description 以覆盖触发场景
   • •设计自动建议语句
3. •

   重构内容结构

   • •将工作流模板转换为 SKILL.md 格式
   • •精简冗余内容
   • •保留核心方法论
4. •

   创建支持文件

   • •转换原模板为技能模板
   • •编写使用示例
   • •创建 README

Conversion Checklist | 转换检查清单

• • 核心方法论已提取
• • 触发关键词已覆盖原工作流的使用场景
• • 模板已适配技能格式
• • 示例已创建
• • README 已编写

Templates | 模板

SKILL.md Template | SKILL.md 模板

参见 templates/skill-md-template.md

README Template | README 模板

参见 templates/readme-template.md

Example Template | 示例模板

参见 templates/examples-template.md

Usage Examples | 使用示例

Example 1: Create New Skill | 创建新技能

请帮我创建一个新的 Agent Skill，用于自动化代码审查。

需求：
- 检查代码规范
- 识别潜在问题
- 生成审查报告

Example 2: Convert Workflow | 转换工作流

请将 my-workflow-system 转换为 Agent Skill 格式。

原工作流位于：workflow-system/
特点：三阶段流程、模板驱动、用户确认

Example 3: Enhance Existing Skill | 增强现有技能

请为 analysis_code 技能添加新的模板和工具。

新增需求：
- 安全漏洞检测模板
- 性能分析工具

Best Practices | 最佳实践

Naming Conventions | 命名约定

• •skill_name: 使用 snake_case（如 code_review）
• •YAML name: 使用 kebab-case（如 code-review）
• •Templates: 使用 kebab-case（如 review-report.md）

Description Writing | 描述编写

好的 description 应该：

1. •包含主要触发关键词
2. •中英文双语
3. •简洁但覆盖核心场景

# ✅ 好的例子
description: 系统化代码审查和质量检测。当用户需要代码审查、质量检查、代码规范验证时激活。Systematic code review and quality detection. Activates when user needs code review, quality check, or code standard validation.

# ❌ 不好的例子
description: A skill for code review.  # 太简单，缺少关键词

Content Organization | 内容组织

1. •Overview 放在最前面 - 让用户快速理解技能用途
2. •Trigger Conditions 要明确 - 确保技能被正确触发
3. •Core Methodology 是核心 - 这是技能的主要价值
4. •Examples 要实用 - 真实可用的示例

Bilingual Support | 双语支持

推荐模式：

## Section Title | 章节标题

English content...

中文内容...

Integration with Other Skills | 与其他技能集成

skill_builder 可以与以下技能协作：

• •analysis_code: 分析现有工作流，提取可复用模式
• •refactor_code: 重构和优化技能代码
• •file_organize: 组织技能的目录结构

References | 参考

• •Agent Skills Open Standard
• •VS Code Agent Skills Documentation
• •Original workflow: workflow-builder-system/