AGENTS.md@.github git:20260702.3a187dfA

Immutable. This exact content never changes and is served at /api/v1/blob/b29a29d24fa7fa5b.

# AGENTS.md - GitHub automation

## 目录用途

`.github/` 存放远端手动自动化配置，使维护者需要时能复现本地交付门禁；默认发布验收以本地脚本为主，push 不自动触发 Acceptance 或容器发布。

## 目录结构

```text
.github/
├── AGENTS.md
└── workflows/
    ├── acceptance.yml
    ├── container.yml
    ├── evaluation-nightly.yml
    └── hf-space-deploy.yml
```

## 职责边界

- `workflows/acceptance.yml`：手动触发 FateCat skill 验收链；不在 push / pull_request 自动执行。
- `workflows/container.yml`：手动构建 FateCat delivery 容器并运行容器 smoke；只有显式选择 `push_image` 时才推送 GHCR。
- `workflows/evaluation-nightly.yml`：手动或定时触发 EvaluationRun nightly；只调用 `scripts/evaluation-nightly.sh`，上传 summary/diff/dashboard artifact，不保存 secret、不自动部署。
- `workflows/hf-space-deploy.yml`：手动触发 Hugging Face Space 部署；fork 用户设置 `HF_TOKEN` 后可从 GitHub 网页部署到自己的 Space。
- 这里不放业务代码、不保存 secret、不生成运行态产物。

## 依赖方向

- `.github/workflows/* -> scripts/acceptance.sh -> scripts/common.sh runtime root resolution`
- `.github/workflows/container.yml -> scripts/container-build.sh + scripts/container-smoke.sh`
- `.github/workflows/evaluation-nightly.yml -> scripts/evaluation-nightly.sh -> scripts/run-evaluations.sh + scripts/compare-evaluations.sh + scripts/evaluation-dashboard.sh`
- `.github/workflows/hf-space-deploy.yml -> scripts/hf-space-deploy.sh + infra/huggingface-space`
- CI 只调用仓库脚本；代码质量门禁以 `scripts/local-ci.sh` 和 `scripts/public-release-gate.sh` 为本地真相源，容器发布门禁以 `scripts/container-smoke.sh` 为单一入口。