89 lines
2.6 KiB
Markdown
89 lines
2.6 KiB
Markdown
# 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` 仓库内独立提交与推送。
|