Files

3.5 KiB
Raw Permalink Blame History

Agent 工作说明(Agent-System-Frontend)

本仓开发遵循 Development-Guidelines(Dev 仓 deps/development-guidelines,gitlink 固定版本): 核心规则见其 core/,按任务触发阅读 standards/ 专题;日常交付走 workflows/delivery.md。

任务启动门禁

  • 任务启动或恢复后,第一次写操作前在 Dev 仓运行 make precheck 并附完整输出(本仓作为子仓随父仓编排); 本仓独立开发时核对工作树 clean、与权威 origin/main 同步,并按任务触发读对应专题。
  • 从权威 origin/main 固定共同起点 R0,建 feature|fix|hotfix/ 分支(Dev 仓 make task-start 自动化); 任务中途不重复 precheck。
  • 验收、请求审核、合入前各同步一次最新目标分支并附证据;合入后回收任务工作区与已合入分支。
  • 提交主题行:英文祈使句一行(≤100 列,不以句点结尾);body 写 Why: / Evidence: / Impact: / Refs:。

仓内规则

  • 模块边界、公开契约与隔离档位见 policy/modules/(如有)与 PROJECT.md。
  • 跨仓 gitlink 变更须经组合验证后在 Dev 仓推进;受保护分支经 PR 合入。
  • 验证命令见 PROJECT.md「验证」节;完成声明须附实际命令输出证据。
  • 异步状态只有一个所有者。事件按 seq 处理,过期事件丢弃。

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 执行与新项目准入(强制)

  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

AI 实施单元仅通过 scripts/agent-exec run 运行(依据 AGENT-EXECUTION.md),并经 scripts/agent-exec apply 集成。