openloglisted

# OpenLog —— 模块化开发工作流 OpenLog 是一个轻量的"模块开发档案"机制。它把每个模块的**架构说明、开发轨迹、当前断点**沉淀到 `OpenLog/<Module>/` 下的三个固定文件里，让接手者（人或 agent）能在 1k token 以内重建上下文。 **核心目标**：稳定、可复读、低 token。 > **工具图例（跨 agent 可移植）**：本文出现的工具名是 Claude Code 的叫法,在别的 agent（Codex 等）里用等价能力替代—— > - `AskUserQuestion` = 任何"给选项让用户选"的能力；**没有就直接文本提问** > - `Read ... limit: N` = 读文件的"只读前 N 行"能力；**不支持就 `head -N <file>`** > - `test -f` / `stat` / `wc` / `date` 等 = 标准 shell 命令,任何能跑 Bash 的 agent 通用 --- ## 数据布局（项目根目录） ``` OpenLog/ ├── INDEX.md # 模块清单 + 跨模块协作约定（极简表格） ├── CONVENTIONS.md # 可选：工程横切规范（asmdef / 测试样板 / 命名约定等项目专属做法） ├── <ModuleA>/ │ ├── ARCHITECTURE.md # 模块架构（结构化、保持最新；契约所有者声明） │ ├── DEV_LOG.md # 开发日志（倒序，最新在最上）—— 已完成动作的历史 │ ├── DEV_LOG.archive/ # 自动归档（仅在 DEV_LOG > 500 行时出现） │ │ └── YYYY-MM.md │ ├── CURRENT.md # 当前阶段断点（< 30 行；含「外部需求 (inbox)」）—— 长期阶段总览 │ └── HANDOFF.md # 可选,一次性：会话末「现场快照」（未完成 / 验证状态 / 待审核） └── <ModuleB>/... ``` **语义分工**（不要混淆）： - **三类时间视角**：DEV_LOG = 历史（持久累计） / CURRENT = 长期阶段（持续） / HANDOFF = 会话末现场（一次性,接手后删） - **两套约定**：INDEX 顶部「跨模块协作约定」管模块间契约 / CONVENTIONS 管模块内技术做法（可选） `OpenLog/` 跟随项目 git 仓库提交，团队 / 多 worktree / 不同 agent 共享同一份档案。 --- ## 启动阶段（最省 token 的入口） 按顺序执行： ### 步骤 1：确保 `OpenLog/INDEX.md` 存在 - 若项目根目录没有 `OpenLog/`，创建之 - 若没有 `INDEX.md`，写入下面这个空模板： ```markdown # OpenLog 模块索引 > 工程约定（横切规范）见 [CONVENTIONS.md](CONVENTIONS.md)（可选,不存在则忽略此行）。 ## 跨模块协作约定 1. 边界 =