doc-append-log
Installation
SKILL.md
文档/日志追加历史机制(doc-append-log)
把项目的文档与日志沉淀成只追加、不改写的历史,让任何智能体(CodeBuddy / Claude Code / Codex)读 INDEX.md 就能拼出全貌,且原始记录永不被覆盖。
何时使用
- 项目里要新增一份设计记录、决策纪要、改造日志、复盘、变更说明。
- 已有文档需要被"取代"但不想改写原文件,只想加新文件并在索引里标注状态。
- 智能体需要在多次会话间保持对项目演进的连续理解。
核心约定(只追加,不改写)
- 每篇历史/结论文档创建后不再修改其内容,保留原貌作为历史。
- 新增内容时新建一个
YYYY-MM-DD_主题.md文件,并在INDEX.md末尾追加一行索引项;不回改旧文档。 - 智能体阅读顺序:先读
INDEX.md→ 按"状态"定位需关注的文档 → 按需精读对应 md。 - 状态含义:
当前事实:最新且生效当前参考:仍有效,但属于某专题沉淀历史背景:已被取代,仅作溯源