skills/README.md

# Images Skills

[Agent Skills](https://skills.sh) 集合,可安装到 Claude Code、Cursor、Codex 等支持 skill 的 Agent 中。

## 安装

安装全部 skills(默认**项目级**,装到当前目录 `.agents/skills/`,仅在该目录内可用):

```bash
npx skills add gitea@livebook:images/skills.git
```

只安装指定 skill:

```bash
npx skills add gitea@livebook:images/skills.git --skill runtime-image
```

全局安装(`-g` 装到 `~/.agents/skills/`,任意目录可用,服务器上推荐):

```bash
npx skills add gitea@livebook:images/skills.git -g
```

> 装完换个目录/新开 shell 就找不到?多半是没加 `-g`:默认装到了当时所在目录的 `.agents/skills/`,换个目录启动 agent 自然看不到。可用 `npx skills list` 确认安装位置。

## 卸载

交互式选择要删除的 skill:

```bash
npx skills remove
```

直接删除指定 skill(`-g` 删除用户级安装,即 `~/.agents/skills` 下的):

```bash
npx skills remove runtime-image -g
```

## Skills 列表

| Skill | 说明 |
| --- | --- |
| [runtime-image](skills/runtime-image/SKILL.md) | 探测项目技术栈,按 runtime-base 镜像矩阵选型并生成/修正 Dockerfile |
| [skill-forge](skills/skill-forge/SKILL.md) | 交互式创建新 Skill 的流水线,一问一答采集触发词/流程/红线,产出可直接使用的 SKILL.md |
| [push-and-report](skills/push-and-report/SKILL.md) | 标准收尾流程:盘点 git 变更 → 英文 conventional commit → 推送远程 → SPMS 日报 |
| [gitea-actions](skills/gitea-actions/SKILL.md) | 按统一规范给项目生成/评审优化 Gitea Actions 构建部署工作流(buildx 推 Gitea Packages → 本机重建容器 → 清理旧版本) |
| [dev-app](skills/dev-app/SKILL.md) | 按 TickShield 平台契约在独立仓库开发/审查/发布生态应用(listingKey 四位一体、四道闸、tenant_id 租户隔离、release-cli 上架部署),含模板组与静态检查脚本 |
| [app-publish](skills/app-publish/SKILL.md) | 改造/新建 Gitea Actions 工作流,把部署 job 改为 aigrego-release 发布上架到 TickShield 应用市场(--store 自动上架 + --wait 审核门禁),含工作流模板与自检脚本 |

## 目录结构

每个 skill 位于 `skills/<name>/` 目录下,包含一个带 `name` 与 `description` frontmatter 的 `SKILL.md`:

```
skills/
├── runtime-image/
│   ├── SKILL.md          # skill 主体(必需)
│   ├── references/       # 补充参考文档
│   └── scripts/          # 辅助脚本
└── skill-forge/
    └── ...
```

命名规范:针对 TickShield app 的 skill 以 `app-<action>` 命名(如 `app-publish`),不带平台前缀(平台归属写进 description);`dev-app` 为既有保留名。新增同族 skill 一律 `app-<action>`。

## License

[MIT](LICENSE)