AGENTS.md@.github · diff

git:20260712.eed08c9 to git:20261025.3c17b73

16 added, 29 removed. Audit A to A.

- # AGENTS.md - GitHub automation

+ # AGENTS.md - 统一目录归属与 GitHub automation

## 目录用途

- `.github/` 存放远端自动 quick gate 和受控发布流程。PR 与 `main` push 自动执行 quick CI；完整 Acceptance、容器发布和 HF 部署仍需显式触发。

- ## 目录结构

- ```text

- .github/

- ├── AGENTS.md

- └── workflows/

- ├── acceptance.yml

- ├── container.yml

- ├── evaluation-nightly.yml

- ├── hf-space-deploy.yml

- └── quick.yml

- ```

+ 本目录统一管理 FateCat 的业务、契约、资料、脚本、测试、平台、基础设施及本机开发/运行目录。根目录文件保持原位；仓库根目录只允许 `.git/` 和 `.github/`，不保留旧路径、重复迁移副本或兼容链接。

- ## 职责边界

+ ## 职责与安全边界

- - `workflows/acceptance.yml`：手动触发 FateCat skill 验收链；不在 push / pull_request 自动执行。

- - `workflows/container.yml`：手动构建 FateCat delivery 容器并运行容器 smoke；只有显式选择 `push_image` 时才推送 GHCR、上传 release artifacts、输出 registry digest、生成 GitHub artifact attestation 并执行 attestation verify。

- - `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。

- - `workflows/quick.yml`：PR、`main` push 和手动触发的自动 quick gate；只调用 `scripts/local-ci.sh --profile quick`，上传短期 summary evidence，不发布制品。

- - 这里不放业务代码、不保存 secret、不生成运行态产物。

+ - 原有 apps、ai、domains、platform、infra、contracts、catalog、governance、shared、tools、docs、references、scripts、tests 保留原名和职责。

+ - `workflows/` 仍是 GitHub Actions 固定入口；不能再嵌套第二层 `.github/workflows/`。

+ - `.venv/`、缓存和 `infra/runtime/local-state/` 仅属 ignored 本机状态，不提交环境、数据库、日志、出生资料或 secret。

+ - 继续遵守各子目录 AGENTS.md 的领域所有权、来源只读、许可证、隐私和行为约束；目录迁移不允许修改业务算法或扩大生产能力。

+ - 所有仓库级路径仍以真实仓库根为基准，源码和资源路径加 `.github/`；根目录的 pyproject.toml、requirements、Makefile、README、SKILL.md 等文件不迁移。

+ - 第三方参考快照、原始数据及现有运行记录不得因迁移被改写或删除；历史证据中的旧路径可作为当时记录保留，不作为当前入口。

- ## 依赖方向

+ ## 远端流程

- - `.github/workflows/* -> scripts/acceptance.sh -> scripts/common.sh runtime root resolution`

- - `.github/workflows/container.yml -> scripts/container-build.sh + scripts/container-smoke.sh + scripts/release-artifacts.sh + actions/attest@v4`

- - `.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`

- - `.github/workflows/quick.yml -> scripts/local-ci.sh --profile quick`

- - CI 只调用仓库脚本；代码质量门禁以 `scripts/local-ci.sh` 和 `scripts/public-release-gate.sh` 为本地真相源，容器发布门禁以 `scripts/container-smoke.sh` 为单一入口。

+ - `workflows/quick.yml`：PR、main push 和手动触发自动 quick gate，只调用 `.github/scripts/local-ci.sh --profile quick`。

+ - `workflows/acceptance.yml`：手动完整验收，不自动发布。

+ - `workflows/container.yml`：手动构建与 smoke；只有显式 push_image 才推送 GHCR、上传 release artifacts、生成并验证 attestation。

+ - `workflows/evaluation-nightly.yml`：手动/定时离线 EvaluationRun，不自动部署或读取真实用户资料。

+ - `workflows/hf-space-deploy.yml`：手动 HF 分发，由部署者显式提供凭据并选择上传与远端清理策略。

+ - 本轮目录迁移不调用真实 HF、Bot、Postgres、交易 API 或远端发布；不运行会清理既有数据的默认整套 CI。验证使用隔离工作区和显式外部输出目录。