skills

Skills 通过 Markdown 文件向 System Prompt 注入额外的上下文和指令。

设计理念

问题

不同项目有不同的需求：

• 编码规范

• 领域知识

• 最佳实践

• 工作流程

硬编码在 System Prompt 中不灵活。

解决方案

通过 Markdown 文件动态加载：

<!-- .kiro/skills/my-skill.md -->
# My Skill

Additional instructions for the AI...

Skill 格式

基本结构

---
name: frontend-design
description: Frontend design guidelines
keywords: ui, design, react, css
inclusion: auto
---

# Frontend Design Skill

When building UI components, follow these guidelines:

## Styling
- Use Tailwind CSS for styling
- Follow mobile-first approach
- Ensure accessibility (ARIA labels, keyboard navigation)

## Components
- Keep components small and focused
- Use composition over inheritance
- Implement proper error boundaries

## Examples

```tsx
// Good component structure
export function Button({ children, onClick, variant = 'primary' }) {
  return (
    <button
      className={`btn btn-${variant}`}
      onClick={onClick}
      aria-label={children}
    >
      {children}
    </button>
  );
}
```

Front Matter

---
name: skill-name           # 唯一标识符
description: Description   # 简短描述
keywords: key1, key2       # 关键词（用于匹配）
inclusion: auto            # 加载方式: auto, manual, fileMatch
fileMatchPattern: "*.tsx"  # 文件匹配模式（inclusion: fileMatch 时）
priority: 10               # 优先级（数字越大越优先）
---

加载方式

Auto Inclusion

自动加载到所有会话：

---
inclusion: auto
---

# Always Active Skill

This skill is always loaded...

Manual Inclusion

用户手动激活：

---
inclusion: manual
---

# Manual Skill

Use #skill-name in chat to activate...

使用：

# 在聊天中使用 #frontend-design 激活
User: #frontend-design 创建一个按钮组件

File Match Inclusion

当读取匹配的文件时自动加载：

---
inclusion: fileMatch
fileMatchPattern: "*.tsx"
---

# React Skill

This skill activates when reading .tsx files...

文件引用

引用其他文件

Skills 可以引用其他文件：

# API Design Skill

Follow the API specification:

#[[file:docs/api-spec.yaml]]

When implementing endpoints, ensure...

引用会被替换为文件内容。

引用代码示例

# Testing Skill

Example test structure:

#[[file:tests/example.test.ts]]

Follow this pattern for all tests.

Skill 管理

列出 Skills

async function listSkills(): Promise<Skill[]> {
  const skillsDir = path.join(context.cwd, '.kiro', 'skills');
  const files = await fs.readdir(skillsDir);
  
  const skills = [];
  
  for (const file of files) {
    if (file.endsWith('.md')) {
      const content = await fs.readFile(
        path.join(skillsDir, file),
        'utf-8'
      );
      const skill = parseSkill(content);
      skills.push(skill);
    }
  }
  
  return skills;
}

激活 Skill

async function activateSkill(
  skillName: string
): Promise<void> {
  const skill = await loadSkill(skillName);
  
  // 添加到 System Prompt
  appendToSystemPrompt(skill.content);
  
  // 标记为已激活
  activeSkills.add(skillName);
}

停用 Skill

function deactivateSkill(skillName: string): void {
  activeSkills.delete(skillName);
  
  // 下次构建 System Prompt 时不包含
}

内置 Skills

Claude Code 包含多个内置 Skills：

• frontend-design - 前端设计指南

• react-best-practices - React 最佳实践

• pdf - PDF 处理

• xlsx - Excel 处理

• canvas-design - 设计创作

• shadcn-ui - shadcn/ui 组件库

创建 Skill

步骤

1. 创建 Markdown 文件

2. 添加 front matter

3. 编写内容

4. 保存到 .kiro/skills/

示例

---
name: database-design
description: Database design guidelines
keywords: database, sql, schema
inclusion: auto
---

# Database Design Skill

When designing database schemas:

## Naming Conventions
- Use snake_case for table and column names
- Plural for table names (users, posts)
- Singular for column names (user_id, post_title)

## Relationships
- Always define foreign keys
- Use ON DELETE CASCADE carefully
- Index foreign key columns

## Best Practices
- Normalize to 3NF
- Use UUIDs for primary keys
- Add created_at and updated_at timestamps

下一步

• 探索 Plugins 系统 的开发

• 了解 MCP 集成 的配置

• 查看 Hooks 系统 的创建