# snail-skills

**Repository Path**: Gianttrees/snail-skills

## Basic Information

- **Project Name**: snail-skills
- **Description**: Snail Skills 是一个轻量级开源技能库项目，专注于收集和沉淀编程及 AI应用开发场景中的实用技能（Skill）。项目以"小而精、稳而快"为核心理念，按日常编程、AI 开发、数据处理、DevOps等领域对技能进行分类整理，提供标准化的接口与文档，帮助开发者即拿即用、减少重复造轮子，让每一份经验都能高效复用。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2026-09-05
- **Last Updated**: 2026-09-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Snail Skills

<p align="center">
  <em>轻量 · 高效 · 即插即用</em>
</p>

<p align="center">
  <img src="https://img.shields.io/badge/status-active-brightgreen" alt="status">
  <img src="https://img.shields.io/badge/license-MIT-blue" alt="license">
</p>

---

## 项目简介

**Snail Skills** 是一套面向 AI 辅助编程（VibeCoding）的结构化工作流技能库。将在实际项目中验证过的高效编程模式沉淀为可复用的 Skill，覆盖从「项目初始化 → 摸清项目结构 → 分析业务 → 定位 Bug → 需求开发 → 编码实现 → Code Review → 功能优化」的完整开发链路。

> 像蜗牛一样，每一步都走得扎实——小而精，稳而快。

## 技能总览

| 技能 | 分类 | 说明 |
|------|------|------|
| [完整链路手册](VibeCoding%20Skills/Vibe%20Coding完整链路.md) | 工作流手册 | VibeCoding 全流程操作手册，开发者可直接作为 Prompt 输入 AI 助手 |
| [project-init](VibeCoding%20Skills/project-init/SKILL.md) | 项目初始化 | 生成项目概要说明书（含项目信息和技术栈信息） |
| [backend-code-analysis](VibeCoding%20Skills/backend-code-analysis/SKILL.md) | 代码分析 | 分析后端指定模块的全部代码，输出结构化分析文档 |
| [frontend-code-analysis](VibeCoding%20Skills/frontend-code-analysis/SKILL.md) | 代码分析 | 分析前端指定模块/页面的全部代码，输出结构化分析文档 |
| [fullstack-code-analysis](VibeCoding%20Skills/fullstack-code-analysis/SKILL.md) | 代码分析 | 打通前后端完整业务链路，输出全栈分析文档 |
| [bug-fix](VibeCoding%20Skills/bug-fix/SKILL.md) | 问题修复 | 定位系统 Bug 并编写修复方案 |
| [feature-development](VibeCoding%20Skills/feature-development/SKILL.md) | 需求开发 | 根据新功能需求，输出可直接编码的技术方案文档 |
| [code-writing](VibeCoding%20Skills/code-writing/SKILL.md) | 编码实现 | 严格按技术方案编写代码，完成后进入 Code Review |
| [plan-code-review](VibeCoding%20Skills/plan-code-review/SKILL.md) | 代码审核 | 基于技术方案和代码变更，系统性审核代码实现的完整性和质量 |
| [feature-optimization](VibeCoding%20Skills/feature-optimization/SKILL.md) | 功能优化 | 现有功能的性能优化、体验改进、代码质量提升全流程 |

## 工作流

本项目定义了一套完整的 VibeCoding 工作流，各 Skill 之间存在严格的上下游依赖关系：

```
project-init ──→ code-analysis ──→ bug-fix / feature-development ──→ code-writing ──→ plan-code-review
                     │                                                     │
                     ├── backend-code-analysis                              └── feature-optimization
                     ├── frontend-code-analysis
                     └── fullstack-code-analysis
```

### 核心工作流

1. **项目初始化** — 使用 `project-init` 生成项目概要说明书，快速建立项目上下文
2. **代码分析** — 按需选择后端/前端/全栈分析，摸清项目结构与业务链路
3. **问题定位 / 需求开发** — 产出修复方案或技术方案文档
4. **编码实现** — `code-writing` 严格按方案编码
5. **代码审核** — `plan-code-review` 系统性审核代码质量
6. **功能优化** — 对现有功能进行性能与体验提升

### Skill 上下游关系

```
feature-development  ──→  code-writing  ──→  plan-code-review
  (技术方案)               (编码实现)            (代码审核)

bug-fix  ──→  code-writing  ──→  plan-code-review
(修复方案)      (编码实现)            (代码审核)

feature-optimization  ──→  code-writing  ──→  plan-code-review
  (分析+方案)               (编码实现)            (代码审核)
```

## 文件结构

```
snail-skills/
├── README.md
├── VibeCoding Skills/
│   ├── CLAUDE.md                              # Claude Code 项目配置
│   ├── Vibe Coding完整链路.md                  # VibeCoding 全流程手册
│   ├── project-init/SKILL.md                  # 项目初始化
│   ├── backend-code-analysis/SKILL.md          # 后端代码分析
│   ├── frontend-code-analysis/SKILL.md         # 前端代码分析
│   ├── fullstack-code-analysis/SKILL.md        # 全栈代码分析
│   ├── bug-fix/SKILL.md                        # Bug 定位与修复
│   ├── feature-development/SKILL.md            # 功能开发 - 技术方案
│   ├── code-writing/SKILL.md                   # 编码实现
│   ├── plan-code-review/SKILL.md               # 代码审核
│   └── feature-optimization/SKILL.md           # 功能优化
└── .idea/                                      # IDE 配置
```

## 使用方式

每个 SKILL.md 文件包含完整的 **角色设定、触发条件、处理流程、编码规范、禁止行为**。开发者可将这些文件作为 Prompt 模板，在 AI 编程会话中直接引用，以实现：

- **标准化** — 每个任务按统一流程执行，不遗漏关键环节
- **可审计** — 每个步骤有明确输出物和卡点规则
- **可复用** — 同一个 Skill 可在不同项目中重复使用
- **可组合** — 多个 Skill 可串联形成完整开发流水线

## 开源协议

本项目基于 [MIT License](./LICENSE) 开源。

---

<p align="center">
  <sub>Built by Snail & Contributors</sub>
</p>