diff --git a/AGENTS.md b/AGENTS.md index a2df3f96..4947736c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -51,7 +51,8 @@ UniDesk 是一个以主 server 为统一入口的分布式工作平台;本文 ## Critical AgentRun Workspace Rule - P0: `pikasTech/agentrun` 是新的共享 Agent 执行基础设施仓库,不是现有 Code Queue 的就地替换;默认 source truth 是 G14 节点 `/root/agentrun`,固定使用 `master` 分支和 `origin git@github.com:pikasTech/agentrun.git`。 -- P0: AgentRun 开发必须先预检 `G14:/root/agentrun` 的路径、分支、remote 和 clean 状态,再在 `/root/agentrun/.worktree/{pr_branch}` 创建独立 worktree 修改;不要把固定 repo、UniDesk、HWLAB、D601 或临时 clone 当作 AgentRun scratch 区。 +- P0: AgentRun `v0.1` 固定工作区是 `G14:/root/agentrun-v01`,固定使用 `v0.1` 分支和 `origin git@github.com:pikasTech/agentrun.git`;明确面向 UniDesk/HWLAB 基础 Code Agent 调用服务 `v0.1` 的任务必须使用该工作区。 +- P0: AgentRun 开发必须按目标分支先预检对应固定工作区的路径、分支、remote 和 clean 状态,再在对应 `.worktree/{pr_branch}` 创建独立 worktree 修改;不要把固定 repo、UniDesk、HWLAB、D601 或临时 clone 当作 AgentRun scratch 区。 - P0: AgentRun 默认部署目标是 `G14:k3s` 上的 `agentrun_dev` 与 `agentrun_prod` namespace;所有 k3s 操作必须使用 route 语法 `G14:k3s`,UniDesk 侧只维护 AgentRun 的开发和部署运维约束,细则见 `docs/reference/agentrun.md`。 - P0: AgentRun 的文档、issue、PR、review 和交付说明一律中文;代码标识符、API path、配置键、命令和必要英文专有名词可保留英文,解释性文字必须中文。 diff --git a/docs/reference/agentrun.md b/docs/reference/agentrun.md index f37da5c0..312797e6 100644 --- a/docs/reference/agentrun.md +++ b/docs/reference/agentrun.md @@ -10,13 +10,13 @@ AgentRun 唯一长期仓库是: git@github.com:pikasTech/agentrun.git ``` -G14 固定 workspace 是: +G14 主线固定 workspace 是: ```text G14:/root/agentrun ``` -该目录必须固定使用 `master` 分支,`origin` 必须是 `git@github.com:pikasTech/agentrun.git`,并保持 clean。每次开始 AgentRun 开发、部署、文档修改、恢复中断或上下文压缩后,先通过 UniDesk SSH 透传执行: +该目录必须固定使用 `master` 分支,`origin` 必须是 `git@github.com:pikasTech/agentrun.git`,并保持 clean。每次开始 AgentRun 主线开发、部署、文档修改、恢复中断或上下文压缩后,先通过 UniDesk SSH 透传执行: ```bash tran G14:/root/agentrun script -- 'pwd; git status --short --branch; git remote -v' @@ -29,7 +29,26 @@ tran G14:/root/agentrun script -- 'pwd; git status --short --branch; git remote - `origin` 是 `git@github.com:pikasTech/agentrun.git`; - 固定 workspace clean。 -如果 workspace 缺失、dirty、分支不对或 remote 不对,必须先修正,再继续工作。不得把 `/root/unidesk`、`/root/hwlab`、D601 workspace、临时 clone、runner checkout、pod 内副本或 master-server 副本当作 AgentRun source truth。 +G14 `v0.1` 固定 workspace 是: + +```text +G14:/root/agentrun-v01 +``` + +该目录必须固定使用 `v0.1` 分支,`origin` 必须是 `git@github.com:pikasTech/agentrun.git`,并保持 clean。任何明确面向 `v0.1` 的 UniDesk/HWLAB 基础 Code Agent 调用服务开发、文档修改、部署观察或恢复中断后,先通过 UniDesk SSH 透传执行: + +```bash +tran G14:/root/agentrun-v01 script -- 'pwd; git status --short --branch; git remote -v' +``` + +期望状态: + +- 当前路径是 `/root/agentrun-v01`; +- 首次推送后分支是 `v0.1...origin/v0.1`; +- `origin` 是 `git@github.com:pikasTech/agentrun.git`; +- 固定 workspace clean。 + +如果 workspace 缺失、dirty、分支不对或 remote 不对,必须先修正,再继续工作。不得把 `/root/unidesk`、`/root/hwlab`、D601 workspace、临时 clone、runner checkout、pod 内副本或 master-server 副本当作 AgentRun source truth。不得把 `master` 主线 workspace 和 `v0.1` workspace 混用;任务明确指向 `v0.1` 时只能以 `G14:/root/agentrun-v01` 为固定 workspace。 ## Worktree 规则 @@ -37,9 +56,10 @@ tran G14:/root/agentrun script -- 'pwd; git status --short --branch; git remote ```text G14:/root/agentrun/.worktree/{pr_branch} +G14:/root/agentrun-v01/.worktree/{pr_branch} ``` -Worktree 必须从最新 `origin/master` 创建,任务分支只覆盖当前变更,提交时只提交当前任务相关文件。不要把 `/root/agentrun` 根目录当作并行任务 scratch 区。 +主线 worktree 必须从最新 `origin/master` 创建,`v0.1` worktree 必须从最新 `origin/v0.1` 创建。任务分支只覆盖当前变更,提交时只提交当前任务相关文件。不要把 `/root/agentrun` 或 `/root/agentrun-v01` 根目录当作并行任务 scratch 区。 ## 部署目标