sunjunzhao
a10d01a44b
Both TickShield app skills now uniformly follow the app-<action> naming convention (app-dev, app-publish) — the grandfathered-name exception is removed from AGENTS.md, README and skill-forge
2.7 KiB
2.7 KiB
Images Skills
Agent Skills 集合,可安装到 Claude Code、Cursor、Codex 等支持 skill 的 Agent 中。
安装
安装全部 skills(默认项目级,装到当前目录 .agents/skills/,仅在该目录内可用):
npx skills add gitea@livebook:images/skills.git
只安装指定 skill:
npx skills add gitea@livebook:images/skills.git --skill runtime-image
全局安装(-g 装到 ~/.agents/skills/,任意目录可用,服务器上推荐):
npx skills add gitea@livebook:images/skills.git -g
装完换个目录/新开 shell 就找不到?多半是没加
-g:默认装到了当时所在目录的.agents/skills/,换个目录启动 agent 自然看不到。可用npx skills list确认安装位置。
卸载
交互式选择要删除的 skill:
npx skills remove
直接删除指定 skill(-g 删除用户级安装,即 ~/.agents/skills 下的):
npx skills remove runtime-image -g
Skills 列表
| Skill | 说明 |
|---|---|
| runtime-image | 探测项目技术栈,按 runtime-base 镜像矩阵选型并生成/修正 Dockerfile |
| skill-forge | 交互式创建新 Skill 的流水线,一问一答采集触发词/流程/红线,产出可直接使用的 SKILL.md |
| push-and-report | 标准收尾流程:盘点 git 变更 → 英文 conventional commit → 推送远程 → SPMS 日报 |
| gitea-actions | 按统一规范给项目生成/评审优化 Gitea Actions 构建部署工作流(buildx 推 Gitea Packages → 本机重建容器 → 清理旧版本) |
| app-dev | 按 TickShield 平台契约在独立仓库开发/审查/发布生态应用(listingKey 四位一体、四道闸、tenant_id 租户隔离、release-cli 上架部署),含模板组与静态检查脚本 |
| app-publish | 改造/新建 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-dev、app-publish),不带平台前缀(平台归属写进 description)。新增同族 skill 一律 app-<action>。