Files

2.6 KiB

Agent Ops 文档仓

agent_ops/ 是 LineUp 项目的文档整理与治理目录。它的目标不是简单收集 Markdown,而是把当前仍有效的项目文档、架构文档、迭代文档、运行记录和历史资料按统一规则沉淀下来,便于后续由 agent 持续维护。

当前整理原则

  • 目录名和文件名统一使用中文;
  • 目录按用途分层,并按阅读/维护顺序增加编号前缀;
  • 迁移以“整合”为主,不做原样搬运;
  • 每类内容只保留一个权威入口;
  • 历史材料保留,但必须和当前有效文档分开。

当前目录结构

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 仓库内独立提交与推送。