初始化 agent_ops 文档治理体系

This commit is contained in:
2026-08-07 16:56:51 +08:00
commit 10840909ab
75 changed files with 15750 additions and 0 deletions
+88
View File
@@ -0,0 +1,88 @@
# Agent Ops 文档仓
`agent_ops/` 是 LineUp 项目的文档整理与治理目录。它的目标不是简单收集 Markdown,而是把当前仍有效的项目文档、架构文档、迭代文档、运行记录和历史资料按统一规则沉淀下来,便于后续由 agent 持续维护。
## 当前整理原则
- 目录名和文件名统一使用中文;
- 目录按用途分层,并按阅读/维护顺序增加编号前缀;
- 迁移以“整合”为主,不做原样搬运;
- 每类内容只保留一个权威入口;
- 历史材料保留,但必须和当前有效文档分开。
## 当前目录结构
```text
agent_ops/
├── README.md
├── 00.目录治理/
├── 01.项目总览/
├── 02.架构设计/
├── 03.迭代规划/
├── 04.程序清单/
├── 05.运行运维/
├── 90.历史归档/
└── 设计/ # 迁移前的旧设计目录,后续分步收口
```
## 各目录职责
### `00.目录治理/`
放文档治理本身需要的资料:
- 目录规划;
- 迁移计划;
- 迁移记录;
- 权威文档清单;
- 命名与维护规范。
### `01.项目总览/`
放项目级入口文档,服务于第一次进入项目的人或 agent:
- 项目总览;
- 当前状态;
- 仓库边界;
- 阶段判断。
### `02.架构设计/`
放仍然有效的设计和架构文档;原 `lineup-app/设计/` 与原 `agent_ops/设计/` 已迁入这里。
### `03.迭代规划/`
放计划、阶段目标、设计评审、技术实施规范和验收评审。后续从 `lineup-app/迭代/` 分步整合。
### `04.程序清单/`
放跨仓程序清单、模块说明和目录职责文档,用作代码地图层。
### `05.运行运维/`
放运行事实、部署说明、联调记录和验证记录。这里承接比“项目状态总览”更细的证据型材料。
### `90.历史归档/`
放已退役、仅用于追溯、或不再作为当前实现依据的历史资料。
## 本轮进度
本轮已完成:
- 建立 `agent_ops` 的中文编号目录规划;
- 开始整合迁移工作区根目录文档;
- 将“项目总览、状态结论、协作边界、跨仓程序清单”沉淀为新的目标文档。
后续两步将按用户要求继续推进:
1. 继续维护 `02.架构设计/`
2. 继续维护 `03.迭代规划/`
## Git 说明
用户计划将 `agent_ops/` 单独初始化为 Git 仓库,并推送到:
`ssh://git@100.121.118.116:2222/lineup/agent_ops.git`
截至 2026-08-07,本目录内尚未检测到独立 Git 仓库元数据,因此本轮先完成目录规划与本地文档整合;待仓库初始化后,后续修改应在 `agent_ops` 仓库内独立提交与推送。