# 项目维护人员文档

本目录存放维护人员与自动化代理相关资料，主要用于项目运维，不属于对外公开的用户文档。

- `docs/plans/`：实施方案与阶段记录。当前主线 `MCP化改造方案-2026-10-19.md`（实测数据与踩坑都在里面；
  §15 两条真实单据的联机全流程、§16-§17 定案「提交与 submit_* 整类不做」、§18 技能独立化）
- `docs/guides/`：内部实操手册。`项目架构全景图.md` 写的是**改造前**架构（顶部有过时标注），现状看 `src/README.md`；
  `工程实践指南.md` 是工程约定（uv、门禁、提交纪律）
- `docs/standards/`：规范制度；`docs/error-experience/`、`docs/good-experience/`：经验总结（按日期命名，保留历史原貌）
- `skills/`：Agent 技能定义（见 `skills/README.md`）

对外用户文档统一放 `docs/`（工具契约是 `docs/MCP.md`）。

> 已作废并删除：`docs/guides/系统事件流全景图.md`（SSE 与 file_events/agent_events 通道已随 Web/Agent 一起移除，
> 现在没有任何长连接事件流；需要看历史内容用 git 提交 `2f08bbd^`）。