---

name: skill-builder description: 系统化 Agent Skill 设计和构建。当用户需要创建新的 Agent Skill、设计技能包、转换工作流为技能格式时激活。Systematic Agent Skill design and building. Activates when user needs to create new Agent Skills, design skill packages, or convert workflows to skill format.

🏗️ 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/