doc-append-log

Installation
SKILL.md

文档/日志追加历史机制(doc-append-log)

把项目的文档与日志沉淀成只追加、不改写的历史,让任何智能体(CodeBuddy / Claude Code / Codex)读 INDEX.md 就能拼出全貌,且原始记录永不被覆盖。

何时使用

  • 项目里要新增一份设计记录、决策纪要、改造日志、复盘、变更说明。
  • 已有文档需要被"取代"但不想改写原文件,只想加新文件并在索引里标注状态。
  • 智能体需要在多次会话间保持对项目演进的连续理解。

核心约定(只追加,不改写)

  1. 每篇历史/结论文档创建后不再修改其内容,保留原貌作为历史。
  2. 新增内容时新建一个 YYYY-MM-DD_主题.md 文件,并INDEX.md 末尾追加一行索引项;不回改旧文档。
  3. 智能体阅读顺序:先读 INDEX.md → 按"状态"定位需关注的文档 → 按需精读对应 md。
  4. 状态含义:
    • 当前事实:最新且生效
    • 当前参考:仍有效,但属于某专题沉淀
    • 历史背景:已被取代,仅作溯源
Installs
30
Repository
shyxin/skills
GitHub Stars
2
First Seen
Aug 14, 2026
doc-append-log — shyxin/skills