# sakura-skills

**Repository Path**: SakuraTechy/sakura-skills

## Basic Information

- **Project Name**: sakura-skills
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-10
- **Last Updated**: 2026-06-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Sakura Skills

公司内部 AI Skills 共享仓库，用于沉淀、审核、分发和同步团队常用的 AI Agent 能力包。

本仓库根据《公司内部 AI Skills 共享平台 POC 方案》建立。POC 阶段采用 `skillshare + 公司内部 Git 仓库` 的方式：仓库负责集中管理 `skills/`、`agents/`、`rules/`、`commands/`，员工本地通过 `skillshare` 下载、审计、同步到 Codex、Claude Code、Cursor、OpenCode 等工具。

## 当前 Skill

| Skill | 场景 | 入口 |
| --- | --- | --- |
| `imagemagick-tools` | 图片格式转换、压缩、缩放、缩略图、元数据清理、批处理 | `skills/imagemagick-tools/SKILL.md` |
| `karpathy-guidelines` | 编码代理行为准则，适用于开发、评审、重构和维护 | `skills/karpathy-guidelines/SKILL.md` |

## 推荐使用方式

### 1. 安装 skillshare

按 `skillshare` 官方方式完成安装。

Windows：

```powershell
irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iex
```

macOS / Linux：

```bash
curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh
```

安装完成后确认命令可用：

```powershell
skillshare --version
```

如果公司后续提供统一安装包、软件中心或内部镜像，以公司内部安装方式为准。

### 2. 初始化本地环境

首次使用时初始化全局 skillshare 配置，让它识别本机已安装的 AI Agent：

```powershell
skillshare init --no-copy --all-targets --git --skill
skillshare status
```

如果只想同步到部分工具，可以显式指定 target：

```powershell
skillshare init --no-copy --targets "codex,claude,cursor" --git --skill
```

### 3. 从公司仓库安装 Skills

安装并跟踪本仓库中的全部 skills：

```powershell
skillshare install https://gitee.com/SakuraTechy/sakura-skills.git --all --track
skillshare audit
skillshare sync --all
```

只安装某一个 skill：

```powershell
skillshare install https://gitee.com/SakuraTechy/sakura-skills.git -s imagemagick-tools --track
skillshare sync
```

完成后，skillshare 会把 skills 同步到已配置的本地 Agent target 中。

### 4. 查看本地 Web 控制台

```powershell
skillshare ui
```

Web 控制台可用于查看已安装 skills、同步状态、Agent targets 和本地配置情况。

### 5. 后续更新

团队仓库有新 skill 或已有 skill 更新后，员工本地执行：

```powershell
skillshare check
skillshare update --all
skillshare audit
skillshare sync --all
```

## 仓库结构

```text
sakura-skills/
  skills/      可通过 skillshare 下载和同步的 skill
  agents/      面向 AI Agent 的适配说明
  commands/    skillshare 常用操作命令
  rules/       skill 收录、编写、评审、发布规则
  docs/        POC 方案、背景材料和平台规划文档
```

## 贡献流程

POC 阶段使用 Git PR/MR 代替自研上传平台：

```text
员工新增/修改 Skill
  -> 提交 PR / MR
  -> 负责人 Review
  -> 合并到 main
  -> 其他员工执行 update + sync
```

新增 skill 时：

1. 在 `skills/` 下新增 kebab-case 目录，例如 `skills/sql-optimizer`。
2. 每个 skill 必须包含 `SKILL.md`，并在 front matter 中提供 `name` 和 `description`。
3. 长文档放入 `references/`，脚本放入 `scripts/`，Agent 适配放入 `agents/`。
4. 按 `rules/skill-authoring.md` 自查内容质量、触发条件、依赖、验证方式和安全边界。
5. 更新本 README 的 skill 索引。
6. 提交 PR/MR，并说明适用场景、验证方式、来源许可和安全风险。

## 相关文档

- `docs/公司内部 AI Skills 共享平台 POC 方案.md`
- `commands/README.md`
- `agents/README.md`
- `rules/README.md`