# AGENTS.md

## Skill 命名规范

针对 TickShield app 的 skill 以 `app-<action>` 命名、不带 `tickshield-` 平台前缀（平台归属由 SKILL.md 的 description 表达）：

- `app-dev` — 按平台契约开发/审查/手工发布生态应用
- `app-publish` — 改造/新建 Gitea Actions 工作流，把部署 job 改为发布上架到应用市场

新增同族 skill 一律 `app-<action>`（如 app-review、app-test），并在 README.md 的 Skills 列表登记。

## 仓库与安装副本

本仓库是分发源（用户经 `npx skills add gitea@livebook:images/skills.git` 安装，默认项目级）。

- `app-dev`、`app-publish`：**只装项目级**（目标项目的 `.agents/skills/`），不在 `~/.agents/skills/` 维护全局副本
- 其余 skill（gitea-actions、push-and-report、runtime-image、skill-forge 等）：本机 `~/.agents/skills/<name>/` 有用户级副本，改动后两处同步