docs: add v0.1 lane specs

This commit is contained in:
Codex
2026-05-29 08:59:54 +08:00
parent 7be1d9b6c3
commit 8b09ecd7e4
5 changed files with 293 additions and 8 deletions
+10 -6
View File
@@ -10,15 +10,16 @@ AgentRun 是面向 UniDesk 与 HWLAB 的共享 Agent 执行基础设施。本仓
## Critical Source Workspace Rule
- P0: 唯一长期 source workspace 是 `G14:/root/agentrun`,固定使用 `master` 分支,`origin` 固定为 `git@github.com:pikasTech/agentrun.git`
- P0: 每次开发、部署、恢复中断或上下文压缩后,都必须先从 UniDesk 执行 `tran G14:/root/agentrun script -- 'pwd; git status --short --branch; git remote -v'`,确认路径、分支、remote 和 clean 状态。
- P0: 固定 workspace 只用于预检、fetch、worktree 管理和最终同步。常规修改必须在 `/root/agentrun/.worktree/{pr_branch}` 中完成,并从最新 `origin/master` 创建。
- P0: `v0.1` 长期 source workspace 是 `G14:/root/agentrun-v01`,固定使用 `v0.1` 分支,`origin` 固定为 `git@github.com:pikasTech/agentrun.git`
- P0: 每次开发、部署、恢复中断或上下文压缩后,都必须先从 UniDesk 执行 `tran G14:/root/agentrun-v01 script -- 'pwd; git status --short --branch; git remote -v'`,确认路径、分支、remote 和 clean 状态。
- P0: 固定 workspace 只用于预检、fetch、worktree 管理和最终同步。常规修改必须在 `/root/agentrun-v01/.worktree/{pr_branch}` 中完成,并从最新 `origin/v0.1` 创建。
- P0: 不得把 UniDesk、HWLAB、D601 workspace、临时 clone、pod 内副本或 runner checkout 当作 AgentRun source truth。
## Critical Runtime Target Rule
## Critical Versioned Lane Rule
- P0: 默认部署目标是 G14 原生 k3s namespace`agentrun_dev``agentrun_prod`
- P0: Kubernetes 操作必须使用 UniDesk route 语法 `G14:k3s`,例如 `tran G14:k3s kubectl get pods -n agentrun_dev`
- P0: AgentRun 废弃 `dev/prod` 管理口径,后续按 `v0.1``v0.2``v0.3` 这种版本 lane 滚动;每条 lane 拥有独立 branch、workspace、namespace、GitOps desired state 和发布验收
- P0: `v0.1` 固定部署目标是 G14 原生 k3s namespace `agentrun-v01`;不得继续把 `agentrun_dev``agentrun_prod` 当作当前规格、验收或发布目标
- P0: Kubernetes 操作必须使用 UniDesk route 语法 `G14:k3s`,例如 `tran G14:k3s kubectl get pods -n agentrun-v01`
- P0: 不得通过临时 NodePort、host port、pod IP、一次性 port-forward 或 provider-gateway 业务 HTTP proxy 固化 AgentRun 暴露路径。公网或跨服务入口必须通过本仓库审查后的变更引入。
## Critical MVP Rule
@@ -40,6 +41,9 @@ AgentRun 是面向 UniDesk 与 HWLAB 的共享 Agent 执行基础设施。本仓
## 长期参考文档
- `docs/reference/spec-v01-documentation-governance.md`:v0.1 文档治理、唯一入口、spec 权威和过程材料承载规则。
- `docs/reference/spec-v01-services.md`:v0.1 服务总览、保留对象、deferred 对象和单服务规格索引。
- `docs/reference/spec-v01-cicd.md`v0.1 分支、workspace、namespace、GitOps、registry、CI/CD 和发布验收规格。
- `docs/reference/architecture.md`:AgentRun 产品边界、服务架构、MVP 阶段、RESTful API 模型和数据模型。
- `docs/reference/cli.md`:按 `cli-spec` 固化的 CLI 与服务 API 约束。
- `TEST.md`:随实现逐步补齐的人工验收场景。