初始化 agent_ops 文档治理体系
This commit is contained in:
@@ -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` 仓库内独立提交与推送。
|
||||
Reference in New Issue
Block a user