# Agent 工作说明（Agent-System-Releases）

本仓开发遵循 Development-Guidelines（见 Dev 仓 `development/guidelines`，gitlink 固定版本）：
核心规则与术语见其 `core/`，按任务触发阅读 `standards/` 专题；日常交付走 `workflows/delivery.md`。

仓内规则：
- 模块边界、公开契约与隔离档位见 `policy/modules/`（如有）与 PROJECT.md。
- 提交信息用英文祈使句一行；跨仓 gitlink 变更须经组合验证后在 Dev 仓推进。
- 验证命令见 PROJECT.md「验证」节；完成声明须附实际命令输出证据。

## Gitea 与 Git 访问事实（2026-09-30 实测）

历史文档与旧链接里的 `git-panel.u1680832.nyat.app:30319` 已失效（TLS 握手失败），
见到一律按过期处理，不要再试。当前权威通道：

- **Web / API（HTTPS）**：`https://git-home.u1680832.nyat.app:30319`（Gitea 1.27.3，
  API 前缀 `/api/v1`；偶发 broken pipe / 超时，重试即可）。
- **Git over SSH**：`ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/<Repo>.git`
  （各仓 origin 与 gitlink 均为此格式）。
- **API token**：`~/.secrets/gitea`，两行键值 `URL_PREFIX=…` 与
  `ACCESS_TOKEN=<40 位 hex>`；取值 `grep ACCESS_TOKEN ~/.secrets/gitea | cut -d= -f2-`，
  用作 `Authorization: token <值>` 请求头。**token 值不入仓、不回显、不写进产出物**
  （baseline 硬边界 2：只记录来源、字段与可用状态）。
- **SSH key**：`~/.ssh/home_gitea`（ED25519，公钥指纹
  `SHA256:GYXaOXIMeloQ1fKSfdJ/ndgPQzs/Ix7Hk62ekfkfQ20`，Gitea 侧密钥名 GMKtec）；
  `~/.ssh/config` 已有 `git-ssh.u1680832.nyat.app` 主机条目，克隆/推送直接可用。

## Agent 执行与新项目准入（强制）

AI 实施单元只通过 `scripts/agent-exec run` 运行（见 [AGENT-EXECUTION.md](AGENT-EXECUTION.md)），并由 `scripts/agent-exec apply` 集成。

1. 缺 Guidelines 固定版本（`deps/development-guidelines` gitlink 未就绪或 HEAD 不符）时，Agent 只能只读分析，不得实施。
2. 缺有效 `AGENT-EXECUTION.md`（`scripts/dm governance check` 未通过）时禁止 AI 实施。
3. 缺共享执行器（`scripts/agent-exec` 或 `deps/development-manager` 不可用）时，状态为 `blocked/unavailable`，不得改由 host 替代。
4. 不允许 host 代写实施单元；实施、修复与测试必须经 `AGENT-EXECUTION.md` 登记的候选执行。
5. 人类直接开发按其自身授权与项目规则进行，不受本条款约束。
6. 分支保护与规范 tag 由用户负责设置与维护，Agent 不得代为设置。

入口：

- 需求分流：`scripts/task triage discover|decide|verify`
- 任务启动：`scripts/task start …`
- PR 检查：`scripts/task pr-check …`
- Agent 执行：`scripts/agent-exec run|apply|admit|validate`