Qoder CLI Skills 实战指南及常用 Skills 分享

但是对于一些重复性、特定领域的任务，我们每次执行任务时都需要对AI进行重复的调教。

┌─────────────────────────────────────────────────────────────┐│                                                             ││    AI 是一个"超级通才"                                        ││                                                             ││    它什么都会，但什么都不精                                     ││                                                             ││    它不记得你上次是怎么要求的                                   ││                                                             ││    它不知道你们团队的规范和偏好                                 ││                                                             │└─────────────────────────────────────────────────────────────┘

我们需要的是：

一种方式，让 AI 记住"怎么做某件事"，下次只需说一句话，它就能按照我们定义的方式执行。

这就是 Skill。

Skill = 可复用的专家知识包

就这么简单：一个目录 + 一个 SKILL.md 文件。

没错，但是并没有体现Skill厉害之处。

Prompt告诉AI来做什么，而Skills则告诉AI如何判断以及整个流程如何进行。

Skills让我们能把自己的判断逻辑、处理流程写成一个Qoder可以反复执行的模块。

┌─────────────────────────────────────────────────────────────┐│  Layer 1: 元数据│  ├── name: skill 的名字                                      ││  └── description: 什么时候该用这个 skill（触发条件）             │├─────────────────────────────────────────────────────────────┤│  Layer 2: 核心指令（触发时才加载）                              ││  └── SKILL.md 正文：具体怎么做                                │├─────────────────────────────────────────────────────────────┤│  Layer 3: 附加资源（按需加载）                                 ││  ├── scripts/    → 可执行脚本（Python/Bash）                  ││  ├── references/ → 参考文档（API 文档、规范说明）               ││  └── assets/     → 资源文件（模板、图片）                      │└─────────────────────────────────────────────────────────────┘

为什么要分层？

全局 Skill（所有项目可用）~/.qoder/skills/├── pdf-processing/│   └── SKILL.md├── code-reviewer/│   └── SKILL.md└── ...
项目 Skill（仅当前项目可用）your-project/└── .qoder/    └── skills/        └── project-specific-skill/            └── SKILL.md

/skills

> /skills                                                                                                   ------------------------------------------------------------------------------------------------------------Skill Commands:  [User]  Project                                                                            
Skill list:→ code-reviewer      : [user] 审查代码并提供改进建议。当需要代码审查、查找潜...- pdf-processing     : [user] -Extract text, fill forms, merge PDFs. Use when working with PDF files,...
Press Enter to select · Esc to exit · Tab to cycle tabs · ↑↓ to navigate

方式一：自动触发

帮我查看这个xxx.pdf的内容

方式二：手动调用

/pdf-processing

使用 pdf-processing skill 帮我查看这个xxx.pdf的内容

场景

在 K8s 集群中部署了一套微服务应用，某天突然发现接口报错 500。需要快速定位是哪个服务出了问题。

传统方式：登录各个 Pod → 翻日志 → 分析调用链 → 定位问题

使用 Skill：进入 Pod → 跟 Qoder CLI 说一句"帮我排查问题" → 自动完成排查

核心思路

Skill 内容

---name: microservice-troubleshooterdescription: |  微服务问题排查专家。自动诊断 A、B、C 三个服务组成的微服务架构中的问题，生成排查报告和修复建议。  触发场景：用户请求 "排查微服务问题"、"诊断错误"、"分析日志"、"查找异常"等直接触发这个SKILL进行排查---
# 微服务问题排查
## 项目架构
本项目由 3 个 Spring Boot 微服务组成，通过 HTTP (RestTemplate) 进行链式调用：

### 服务说明
| 服务 | 端口    | 职责 | 下游依赖 ||------|-------|------|----------|| A | 20001 | 入口服务，接收用户请求 | 调用 B 服务 || B | 20002 | 中间层服务 | 调用 C 服务 || C | 20003 | 末端服务，返回最终结果 | 无 |
### 注册中心说明
/root/nacos/naming/目录是微服务注册中心的缓存，当前已用【直接】依赖的服务，订阅的微服务实例的地址会缓存到这个目录下，其中包含所有订阅服务的实例列表
因此可以在/root/nacos/naming/目录下查找阅读依赖服务的相关信息
### 调用链路

## 排查流程
### Step 1: 在当前 Pod 测试本地接口
通过 curl 调用本地接口，观察返回结果或错误信息：
**A 服务接口** (在 A Pod 中执行)```bashcurl localhost:20001/a          # HTTP 全链路调用 A→B→Ccurl localhost:20001/a-zone     # 同城多活链路curl localhost:20001/actuator/health  # 健康检查

curl localhost:20002/b          # 调用 C 服务curl localhost:20002/b-zone     # 同城多活curl localhost:20002/actuator/health  # 健康检查

curl localhost:20003/c          # 返回 C 服务信息 (末端，不依赖其他服务)curl localhost:20003/c-zone     # 同城多活curl localhost:20003/actuator/health  # 健康检查

Step 2: 查看当前服务日志中的错误

# 搜索日志中的异常信息grep -i "exception\|error\|失败" *.log | tail -50

Step 3: 分析调用链

注意

curl localhost:20001/dubbo      # Dubbo 全链路调用

**Skill 扩展脚本**
```markdown### 优先批量检查B服务实例
通过 `/b` 接口批量检测多个B服务实例的状态：
```bash# 用法: ./check_b_instances.sh <ip1> <ip2> ....qoder/skills/microservice-troubleshooter/scripts/check_b_instances.sh 10.192.168.34 10.192.168.35
# 实例IP可从 /root/nacos/naming/ 目录获取

>存储到<project-path>/.qoder/skills/microservice-troubleshooter/scripts/check_b_instances.sh>
```markdown#!/bin/bash## B服务多实例健康检查脚本# 通过 /b 接口判断服务状态# 用法: ./check_b_instances.sh <ip1> <ip2> <ip3> ...# 示例: ./check_b_instances.sh 10.192.168.34 10.192.168.35 10.192.168.36#
PORT=20002TIMEOUT=3
# 颜色定义RED='\033[0;31m'GREEN='\033[0;32m'YELLOW='\033[1;33m'NC='\033[0m' # No Color
if [ $# -eq 0 ]; then    echo "用法: $0 <ip1> <ip2> <ip3> ..."    echo "示例: $0 10.192.168.34 10.192.168.35"    exit 1fi
echo "========================================"echo "  B服务多实例健康检查 (/b接口)"echo "========================================"echo ""
total=0alive=0dead=0has_error=0
for ip in "$@"; do    total=$((total + 1))    echo -n "检查 B实例 [$ip:$PORT] ... "        # 通过 /b 接口检查    response=$(curl -s -w "\n%{http_code}" --connect-timeout $TIMEOUT "http://$ip:$PORT/b" 2>/dev/null)    curl_status=$?        if [ $curl_status -ne 0 ]; then        # curl失败，服务不可达        echo -e "${RED}[不可达]${NC}"        echo "  └─ 原因: 连接超时或拒绝"        dead=$((dead + 1))    else        # 解析响应体和状态码        http_code=$(echo "$response" | tail -1)        body=$(echo "$response" | sed '$d')                if [ "$http_code" -ge 200 ] && [ "$http_code" -lt 300 ]; then            # 2xx 正常            echo -e "${GREEN}[存活-正常]${NC}"            alive=$((alive + 1))        elif [ "$http_code" -ge 500 ]; then            # 5xx 服务存活但有错误            echo -e "${YELLOW}[存活-有错误]${NC}"            echo "  └─ HTTP $http_code: $body"            alive=$((alive + 1))            has_error=$((has_error + 1))        else            # 其他状态码            echo -e "${YELLOW}[存活-HTTP $http_code]${NC}"            alive=$((alive + 1))        fi    fi    echo ""done
echo "========================================"echo "  检查结果汇总"echo "========================================"echo "总实例数:   $total"echo -e "存活实例:   ${GREEN}$alive${NC}"echo -e "不可达:     ${RED}$dead${NC}"echo -e "业务错误:   ${YELLOW}$has_error${NC}"echo ""
if [ $dead -gt 0 ]; then    echo -e "${RED}警告: 存在 $dead 个不可达的实例${NC}"    exit 2elif [ $has_error -gt 0 ]; then    echo -e "${YELLOW}警告: 存在 $has_error 个有业务错误的实例${NC}"    exit 1else    echo -e "${GREEN}所有实例正常${NC}"    exit 0fi

Web应用页面优化

做一个 SaaS 产品落地页，暗色科技风。需要元素丰富（导航、卡片、按钮）

使用frontend-design skill优化这个页面

---name: frontend-designdescription: Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.license: Complete terms in LICENSE.txt---
This skill guides creation of distinctive, production-grade frontend interfaces that avoid generic "AI slop" aesthetics. Implement real working code with exceptional attention to aesthetic details and creative choices.
The user provides frontend requirements: a component, page, application, or interface to build. They may include context about the purpose, audience, or technical constraints.
## Design Thinking
Before coding, understand the context and commit to a BOLD aesthetic direction:- **Purpose**: What problem does this interface solve? Who uses it?- **Tone**: Pick an extreme: brutally minimal, maximalist chaos, retro-futuristic, organic/natural, luxury/refined, playful/toy-like, editorial/magazine, brutalist/raw, art deco/geometric, soft/pastel, industrial/utilitarian, etc. There are so many flavors to choose from. Use these for inspiration but design one that is true to the aesthetic direction.- **Constraints**: Technical requirements (framework, performance, accessibility).- **Differentiation**: What makes this UNFORGETTABLE? What's the one thing someone will remember?
**CRITICAL**: Choose a clear conceptual direction and execute it with precision. Bold maximalism and refined minimalism both work - the key is intentionality, not intensity.
Then implement working code (HTML/CSS/JS, React, Vue, etc.) that is:- Production-grade and functional- Visually striking and memorable- Cohesive with a clear aesthetic point-of-view- Meticulously refined in every detail
## Frontend Aesthetics Guidelines
Focus on:- **Typography**: Choose fonts that are beautiful, unique, and interesting. Avoid generic fonts like Arial and Inter; opt instead for distinctive choices that elevate the frontend's aesthetics; unexpected, characterful font choices. Pair a distinctive display font with a refined body font.- **Color & Theme**: Commit to a cohesive aesthetic. Use CSS variables for consistency. Dominant colors with sharp accents outperform timid, evenly-distributed palettes.- **Motion**: Use animations for effects and micro-interactions. Prioritize CSS-only solutions for HTML. Use Motion library for React when available. Focus on high-impact moments: one well-orchestrated page load with staggered reveals (animation-delay) creates more delight than scattered micro-interactions. Use scroll-triggering and hover states that surprise.- **Spatial Composition**: Unexpected layouts. Asymmetry. Overlap. Diagonal flow. Grid-breaking elements. Generous negative space OR controlled density.- **Backgrounds & Visual Details**: Create atmosphere and depth rather than defaulting to solid colors. Add contextual effects and textures that match the overall aesthetic. Apply creative forms like gradient meshes, noise textures, geometric patterns, layered transparencies, dramatic shadows, decorative borders, custom cursors, and grain overlays.
NEVER use generic AI-generated aesthetics like overused font families (Inter, Roboto, Arial, system fonts), cliched color schemes (particularly purple gradients on white backgrounds), predictable layouts and component patterns, and cookie-cutter design that lacks context-specific character.
Interpret creatively and make unexpected choices that feel genuinely designed for the context. No design should be the same. Vary between light and dark themes, different fonts, different aesthetics. NEVER converge on common choices (Space Grotesk, for example) across generations.
**IMPORTANT**: Match implementation complexity to the aesthetic vision. Maximalist designs need elaborate code with extensive animations and effects. Minimalist or refined designs need restraint, precision, and careful attention to spacing, typography, and subtle details. Elegance comes from executing the vision well.
Remember: Claude is capable of extraordinary creative work. Don't hold back, show what can truly be created when thinking outside the box and committing fully to a distinctive vision.

官方 skill-creator 遵循这些原则：

1. 简洁至上

Layer 1: name + description     → 始终存在（~100词）Layer 2: SKILL.md 正文          → 触发时加载（<5000词）Layer 3: scripts/references/    → 按需加载（无限制）

帮我调研和梳理一套现在通用、完整且详细的微服务问题排查流程，将这个调研内容落到markdown文件中

skill-creator 根据调研文档帮我生成对应的微服务排查SKILL