AGENTS.md@.github · git:20260617.582e706 · 2026-06-17 · sha256 bc5fdc79d8646f56

AGENTS.md@.github git:20260617.582e706A

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

# AGENTS.md - GitHub automation

## 目录用途

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

## 目录结构

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

## 职责边界

- `workflows/acceptance.yml`:手动触发 FateCat skill 验收链;不在 push / pull_request 自动执行。
- `workflows/container.yml`:手动构建 FateCat delivery 容器并运行容器 smoke;只有显式选择 `push_image` 时才推送 GHCR。
- `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/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` 为单一入口。