# anolis-skills

**Repository Path**: vantler/anolis-skills

## Basic Information

- **Project Name**: anolis-skills
- **Description**: Anolis skills 开发仓库，Skills 托管于: https://skillhub.openanolis.cn
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 18
- **Created**: 2026-07-24
- **Last Updated**: 2026-07-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[English](README.en.md) | 中文

# 龙蜥社区 SkillHub

龙蜥社区 AI Skill 开源仓库 —— 收录社区贡献的 AI 技能，供 Agent 客户端加载使用。

一个 Skill 就是一个 `SKILL.md` 文件 —— 用 Markdown 写的 Prompt，告诉 AI Agent 如何解决某个特定的 Infra 问题。本仓库与 [SkillHub](https://skillhub.openanolis.cn) 平台打通，经审核合并的 Skill 会同步上架到官网。

## 快速开始

### 使用 Skill

访问 [skillhub.openanolis.cn](https://skillhub.openanolis.cn) 浏览、搜索、下载。找到想用的 Skill 后，将 `SKILL.md` 复制到对应 Agent 客户端的配置目录即可加载。

兼容的 Agent 客户端：Claude Code · Qwen Code · Cursor · Gemini CLI · Windsurf · Trae · Cline · Continue

### 贡献 Skill

三种提交方式，选择最适合你的：

| 方式 | 流程 | 适合谁 |
|------|------|--------|
| **方式一：龙蜥代码仓 PR**（推荐） | Fork [anolis-skills](https://gitee.com/anolis/anolis-skills) → 在 `skills/` 下创建 SKILL.md + README.md → 提交 PR → 合并后自动同步上线 | 有 Git 经验的开发者 |
| **方式二：提交仓库链接** | GitHub / Gitee 上已有仓库？在 [SkillHub 首页](https://skillhub.openanolis.cn) 粘贴链接 → 自动解析 → 审核上架 | 已有现成仓库的开发者 |
| **方式三：本地压缩包上传** | 将 Skill 文件夹打包成 zip → 通过 [SkillHub](https://skillhub.openanolis.cn) 提交入口上传 | 没有仓库、不会 Git 的用户 |

详细步骤见 [贡献指南](CONTRIBUTING.md) · 完整合作共建指南见 [官网 Guide](https://skillhub.openanolis.cn/guide)。

## Skill 文件结构

```
skills/
└── my-skill-name/
    ├── SKILL.md              # 必需：技能主文件（YAML 元信息 + Markdown 指令）
    └── 可选资源/
        ├── scripts/          # 可执行脚本（检测、部署、调优）
        ├── references/       # 参考文档（兼容矩阵、已知问题）
        └── assets/           # 资源文件（图片、模板、配置）
```

SKILL.md 的三层加载机制：

- **L1 元信息**：`name` + `description`，始终在 Agent 上下文中（约 100 词）
- **L2 正文**：技能触发时加载（建议 < 500 行）
- **L3 附属资源**：`scripts/`、`references/` 等，Agent 按需读取

### SKILL.md 最小示例

```markdown
---
name: docker-debug
description: 诊断与修复 Docker 容器常见运行时问题。当用户报告容器启动失败、网络不通、资源占用异常时使用此技能。
---

# Docker Debug

（工作流程、命令示例、输出格式、注意事项...）
```

完整字段规范见 [docs/spec.md](docs/spec.md)。

## 仓库结构

```
anolis-skills/
├── skills/                  # 所有已合并的 Skill
├── templates/               # Skill 模板（创建新 Skill 时参考）
├── docs/
│   └── spec.md              # Skill 规范（字段 / 命名 / 审核标准）
├── CONTRIBUTING.md          # 贡献指南
├── LICENSE                  # 木兰宽松许可证 v2
└── README.md                # 本文件
```

## 相关链接

| 项目 | 链接 |
|------|------|
| SkillHub 官网 | https://skillhub.openanolis.cn |
| Skill 仓库（本仓库） | https://gitee.com/anolis/anolis-skills |
| 龙蜥社区 | https://openanolis.cn |
| 问题反馈 | https://gitee.com/anolis/anolis-skills/issues |

## 许可证

[木兰宽松许可证 v2 (Mulan PSL v2)](LICENSE)