06c - Kiro Skills 创建教程

my-skill/
├── SKILL.md           # 核心文件（必需）：YAML 元数据 + Markdown 指令
├── templates/
│   └── component.md   # 可选：模板文件
├── scripts/
│   └── validate.sh    # 可选：可执行脚本
├── examples/
│   └── sample.md      # 可选：示例输出
└── reference.md       # 可选：详细参考文档

.kiro/
├── steering/          # Steering 文件（始终加载的行为规则）
│   ├── code-style.md
│   └── security.md
├── skills/            # Skills 文件（按需加载的能力扩展）
│   ├── code-reviewer/
│   │   └── SKILL.md
│   └── api-generator/
│       ├── SKILL.md
│       └── templates/
└── specs/             # Spec 文件（需求/设计/任务）
    └── my-feature/

---
name: my-skill
description: What this skill does and when to use it
---

---
name: react-patterns
description: React component patterns and best practices for our project. Use when creating or refactoring React components.
---

---
name: api-security-review
description: Security review checklist for API endpoints. Use when reviewing or creating API routes, middleware, or authentication logic.
license: MIT
metadata:
  author: team-security
  version: "2.0"
---

---
name: project-conventions
description: Project coding conventions and architecture decisions
---
 
# 项目编码约定
 
## 技术栈
- Next.js 14 App Router + TypeScript
- Prisma ORM + PostgreSQL
- Tailwind CSS + shadcn/ui
 
## 命名规范
- 组件使用 PascalCase
- hooks 使用 camelCase，以 use 开头
- API 路由使用 kebab-case

---
name: db-migration
description: Create and run database migrations safely
---
 
# 数据库迁移流程
 
1. 修改 prisma/schema.prisma
2. 运行 `npx prisma migrate dev --name <migration-name>`
3. 检查生成的 SQL 文件
4. 运行 `npx prisma generate` 更新客户端
5. 更新相关的 seed 数据

## 附加资源
 
- 组件模板见 [templates/component.md](templates/component.md)
- API 文档见 [reference.md](reference.md)
- 验证脚本：`scripts/validate.sh`

第 1 级：元数据（~100 tokens）
  └── name + description → Kiro 判断是否与当前任务相关
第 2 级：完整指令（SKILL.md 正文）
  └── 相关时加载详细指令到上下文
第 3 级：辅助资源（按需）
  └── 模板、脚本、参考文档等

# ❌ 太模糊
description: 帮助处理代码
 
# ✅ 具体明确
description: Review TypeScript API routes for security vulnerabilities, input validation, and authentication. Use when creating or modifying files in src/app/api/.

文件保存事件 → Hook 触发 → Ask Kiro prompt →
  Kiro 自动加载相关 Skill → 执行 Skill 中的指令

---
inclusion: always
---
 
# 编码规范
 
- 使用 TypeScript strict mode
- 所有函数必须有类型注解
- 禁止使用 any 类型

---
inclusion: always
---
# 安全规则
- 所有 API 输入必须使用 Zod 验证
- 禁止在日志中输出敏感信息
- 错误响应不泄露内部实现细节

---
name: api-generator
description: Generate RESTful API routes with validation and error handling
---
# API 路由生成器
1. 创建路由文件在 src/app/api/
2. 添加 Zod schema 验证（遵循安全规则）
3. 实现错误处理中间件
4. 生成对应的测试文件

.kiro/skills/ts-code-reviewer/
├── SKILL.md
├── checklist.md
└── report-template.md

---
name: ts-code-reviewer
description: Review TypeScript code for type safety, security vulnerabilities, performance issues, and test coverage in Next.js + Prisma projects. Use when reviewing PRs, analyzing code quality, or before merging.
---
 
# TypeScript 代码审查指令
 
## 技术栈上下文
- Next.js 14 App Router
- TypeScript strict mode
- Prisma ORM + PostgreSQL
- Tailwind CSS + shadcn/ui
- Vitest + Playwright
 
## 审查流程
 
1. **确定变更范围**：识别变更的文件和影响范围
2. **逐文件审查**：按 [checklist.md](checklist.md) 逐项检查
3. **生成报告**：按 [report-template.md](report-template.md) 格式输出
 
## 审查重点
 
### 类型安全
- 禁止 `any` 类型（除非有充分理由并注释）
- 所有函数参数和返回值必须有类型注解
- 使用 Zod 进行运行时验证
 
### API 路由安全
- 所有 API 路由必须有输入验证
- 检查认证和授权中间件
- 错误响应不泄露内部信息
 
### 数据库查询
- 检查 N+1 查询（使用 `include` 而非循环查询）
- 事务操作使用 `$transaction`
- 大数据量查询使用分页
 
### 测试覆盖
- 新功能必须有对应单元测试
- API 路由必须有集成测试
- 关键路径必须有 E2E 测试
 
## 输出格式
 
按严重程度分类：
- 🔴 **必须修复**：安全漏洞、数据丢失风险、类型错误
- 🟡 **建议修复**：性能问题、代码规范违反
- 🟢 **可选优化**：代码风格、可读性改进
- ✅ **做得好的地方**：值得肯定的实践

# 代码审查清单
 
## 必查项
- [ ] 无 `any` 类型
- [ ] API 路由有输入验证
- [ ] 敏感操作有认证检查
- [ ] 无硬编码密钥或凭证
- [ ] 错误处理完整
 
## 性能项
- [ ] 无 N+1 数据库查询
- [ ] 大列表使用分页
- [ ] 图片使用 next/image 优化
 
## 测试项
- [ ] 新功能有单元测试
- [ ] API 变更有集成测试
- [ ] 测试覆盖率不低于现有水平

# 代码审查报告
 
## 概要
- 审查范围：[文件数量] 个文件，[行数] 行变更
- 总体评价：[优秀/良好/需改进/需重写]
 
## 🔴 必须修复
1. [文件:行号] 问题描述 → 建议修复方案
 
## 🟡 建议修复
1. [文件:行号] 问题描述 → 建议修复方案
 
## 🟢 可选优化
1. [文件:行号] 优化建议
 
## ✅ 做得好的地方
1. [具体描述]

---
inclusion: always
---
 
# 代码质量规则
 
- 所有 PR 必须通过代码审查
- TypeScript strict mode 不可关闭
- 新代码必须有对应测试
- 禁止提交 console.log 调试代码

# Kiro 在你请求代码审查时自动加载此 Skill
> 审查一下最近的代码变更

# 或在对话中提及相关关键词时自动触发
> 这个 API 路由有没有安全问题？

---
inclusion: always
---
 
# 教学模式规则
 
## 核心原则
这是一个互动式教学计划。AI 是老师，用户是学生。
 
## 行为约束
- 所有讲解使用中文
- 禁止直接给出练习答案代码
- 每个知识点必须包含：讲解 → 出题 → 等待学生完成 → 审查 → 验收
- 讲解时与学生已知的语言（如 TypeScript）进行对比
- 出题后必须停下来等待学生回复
 
## 评估标准
- 掌握度 ≥ 80%：通过，进入下一个知识点
- 掌握度 < 80%：提供补充练习，继续巩固

---
name: rust-teaching
description: Rust programming language teaching materials and exercises. Use when the user is learning Rust, asking about Rust concepts, or working on Rust exercises.
---
 
# Rust 教学知识库
 
## 教学方法
1. 概念讲解：用中文解释 Rust 概念，与 TypeScript 对比
2. 代码示例：展示 Rust 代码和等价的 TypeScript 代码
3. 练习设计：给出需求描述，不给答案
4. 代码审查：检查学生代码的正确性和 Rust 惯用写法
 
## 核心知识点映射
 
### 所有权（Ownership）
- TypeScript：垃圾回收，无需手动管理
- Rust：所有权系统，编译时内存安全
- 关键概念：move、borrow、lifetime
 
### 模式匹配（Pattern Matching）
- TypeScript：switch/case，有限的解构
- Rust：match 表达式，穷尽性检查，解构绑定
- 关键概念：match、if let、while let
 
### 错误处理
- TypeScript：try/catch，异常机制
- Rust：Result<T, E>、Option<T>，无异常
- 关键概念：?运算符、unwrap、expect
 
### Trait 系统
- TypeScript：interface，鸭子类型
- Rust：trait，静态分发，trait bound
- 关键概念：impl、dyn、泛型约束
 
## 练习模板
 
每个练习应包含：
1. 知识点说明
2. 需求描述（中文）
3. 输入/输出示例
4. 提示（不是答案）
5. 验收标准

问自己：
1. 这个知识/能力是否需要始终加载？
   → 是：用 Steering 文件
   → 否：用 Skill
2. 这个 Skill 是个人使用还是团队共享？
   → 个人：放 ~/.kiro/skills/
   → 团队：放 .kiro/skills/，提交到 Git
3. 需要辅助文件吗？
   → 模板、脚本、参考文档 → 创建子目录

# 项目级 Skill
mkdir -p .kiro/skills/my-skill
touch .kiro/skills/my-skill/SKILL.md
 
# 个人级 Skill
mkdir -p ~/.kiro/skills/my-skill
touch ~/.kiro/skills/my-skill/SKILL.md

cat > .kiro/skills/my-skill/SKILL.md << 'EOF'
---
name: my-skill
description: Clear description of what this skill does and when to use it
---
 
# Skill 指令
 
## 上下文
[技术栈、项目背景等]
 
## 执行步骤
1. [步骤一]
2. [步骤二]
3. [步骤三]
 
## 输出格式
[期望的输出格式说明]
EOF

> 有哪些可用的 skills？

请帮我创建一个 Kiro Skill：
- 用途：[具体任务描述]
- 技术栈：[相关技术]
- 触发场景：[什么时候应该加载这个 Skill]
- 是否需要辅助文件：[模板/脚本/参考文档]
- 是否需要配套 Hook：[是/否，什么事件触发]
- 是否需要配套 Steering：[是/否，什么规则始终生效]

请生成完整的 SKILL.md 和所有辅助文件。

.kiro/
├── steering/                    # 始终生效的规则
│   ├── code-style.md           # 编码风格（inclusion: always）
│   ├── security.md             # 安全规则（inclusion: always）
│   └── git-conventions.md      # Git 约定（inclusion: always）
├── skills/                      # 按需加载的能力
│   ├── ts-code-reviewer/       # 代码审查（自动触发）
│   │   ├── SKILL.md
│   │   ├── checklist.md
│   │   └── report-template.md
│   ├── api-generator/          # API 生成（自动触发）
│   │   ├── SKILL.md
│   │   └── templates/
│   ├── db-migration/           # 数据库迁移（自动触发）
│   │   └── SKILL.md
│   └── project-context/        # 项目上下文（自动触发）
│       └── SKILL.md
└── specs/                       # Spec 驱动开发
    └── ...

---
inclusion: always
---
 
# 编码风格
 
- TypeScript strict mode，禁止 any
- 函数式组件 + hooks
- Server Actions 处理服务端操作
- Zod 验证所有外部输入
- 自定义 AppError 类处理错误

---
name: project-context
description: Project architecture, tech stack, and directory conventions. Use when working on any part of this project.
---
 
# 项目上下文
 
## 技术栈
- Next.js 14 App Router + TypeScript 5.x
- Prisma ORM + PostgreSQL 16
- NextAuth.js v5 认证
- Tailwind CSS + shadcn/ui
- Vitest 单元测试 + Playwright E2E
 
## 目录结构
- `src/app/` — 页面和 API 路由
- `src/components/` — React 组件
- `src/lib/` — 工具函数和配置
- `prisma/` — 数据库 schema 和迁移
- `tests/` — E2E 测试

git add .kiro/steering/ .kiro/skills/
git commit -m "chore: add team steering rules, skills, and hooks"
git push