Files

2.8 KiB
Raw Permalink Blame History

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),并由 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