# rainbond-skills

**Repository Path**: yangkaa/rainbond-skills

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-04-07
- **Last Updated**: 2026-04-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Rainbond Skills

一组面向 Rainbond 日常交付、排障和初始化流程的自定义技能，支持安装到 Claude Code 和 Codex。

## 包含的 Skill

- `rainbond-app-assistant`
- `rainbond-delivery-verifier`
- `rainbond-env-sync`
- `rainbond-fullstack-bootstrap`
- `rainbond-fullstack-troubleshooter`
- `rainbond-project-init`
- `rainbond-template-installer`

## 适用场景

这些 skill 适合以下场景：

- 将本地项目首次接入 Rainbond
- 为已绑定项目同步环境信息
- 基于镜像或模板在 Rainbond 中完成初始化部署
- 对 Rainbond 全栈应用进行低风险排障
- 在部署结束后做交付验收

## 安装方式

### 1. 克隆仓库

```bash
git clone <your-repo-url>
cd rainbond-skills
```

### 2. 安装到 Claude Code 和 Codex

默认会同时安装到：

- `~/.claude/skills`
- `~/.codex/skills`

执行：

```bash
./install.sh
```

### 3. 只安装到单个平台

只安装到 Claude Code：

```bash
./install.sh claude
```

只安装到 Codex：

```bash
./install.sh codex
```

同时安装到两个平台：

```bash
./install.sh all
```

### 4. 覆盖已安装版本

如果目标目录里已经存在同名 skill，默认会跳过，避免覆盖本地修改。

需要强制覆盖时：

```bash
./install.sh --force
./install.sh codex --force
```

### 5. 安装到自定义目录

```bash
./install.sh --dest ~/.claude/skills
./install.sh --dest ~/.codex/skills --force
```

`--dest` 适合：

- 调试安装过程
- 安装到非标准目录
- 在 CI 或临时目录中做验证

## 更新方式

进入仓库后拉取最新内容，再重新执行安装脚本：

```bash
git pull
./install.sh --force
```

如果只想更新某一个平台：

```bash
./install.sh claude --force
./install.sh codex --force
```

## 目录结构

```text
rainbond-skills/
  README.md
  install.sh
  .gitignore
  rainbond-app-assistant/
    SKILL.md
  rainbond-delivery-verifier/
    SKILL.md
  ...
```

## 仓库维护约定

- 每个 skill 使用单独目录，目录名和 skill 名保持一致
- 每个 skill 至少包含一个 `SKILL.md`
- 如果后续需要补充 `scripts/`、`references/`、`assets/`，请放在对应 skill 目录下
- 安装脚本默认复制所有 `rainbond-*` 目录

## 常见问题

### 1. 安装后没有生效

请重启 Claude Code 或 Codex，或者开启一个新的会话。

### 2. 为什么默认不覆盖已有 skill

因为有些使用者会在本地做二次调整。默认跳过更安全，`--force` 才会覆盖。

### 3. 如何确认安装到了哪里

脚本会输出每个目标目录和每个 skill 的安装结果。

## 开发者说明

如果你要新增或修改 skill，建议流程如下：

1. 在仓库里直接修改对应 skill 目录
2. 执行 `./install.sh --dest /tmp/rainbond-skills-test --force` 做一次本地验证
3. 确认无误后再提交到 Git 仓库