记忆宫殿

当你用 /spiry-init 初始化一个项目后，Spiry 会在项目里部署一套治理文件。这些文件构成了 AI 的记忆宫殿——它让 AI 不必每次从头理解项目，而是站在前人的认知起点上开始工作。

文件结构总览

your-project/
├── AGENTS.md              ← always-on 根指令（每轮自动注入）
└── .spiry/
    ├── handoff.md         ← 热屋（当前站位）
    ├── chronicle.md       ← 冷屋（决策编年史）
    ├── navigation.md      ← 文档地图
    └── *.project.md       ← 增补件（项目特化规则）

AGENTS.md——根指令

AGENTS.md 是项目根目录的 always-on 指令。AI 每一轮对话都会自动读取它。

它包含：

• 开工强制入口——告诉 AI 开工时先读哪些文件
• 工作铁律——不脑补、唯一权威是原文、意图必须留痕等
• 触发指针——什么场景该用什么能力
• 文档地图——项目有哪些文件、各是什么

热屋（handoff.md）——当前站位

热屋是 AI 的接力棒。它记录此刻项目精确站在哪里：

• 当前站位游标——最新进度的一句话概括
• 下一步——接下来该做什么
• 待办——还没做完的事情
• 精简身份——项目是什么、技术栈是什么

热屋是极简纯态的——每次收尾时整体覆盖重写，保持最精简的当前态。

冷屋（chronicle.md）——决策编年史

冷屋是 AI 的决策记忆。每个关键决策都追加一条记录：

• 为什么这么定——决策的动机
• 否了什么备选——为什么没选另一条路
• 落点文件——改动涉及哪些文件

冷屋是只追加的——永远不删、不改旧记录。它就像项目的决策日记，越积越厚、越来越有价值。

导航图（navigation.md）

导航图是项目的文件地图。它记录：

• 项目有哪些权威文档
• 每个文档是什么、装什么
• 什么时候该读它、什么时候该写它

新增或重命名任何权威文档时，须同步更新导航图。

增补件（*.project.md）

增补件是项目特化规则的容器。Spiry 初始部署 7 个空的增补件骨架：

随着你使用 Spiry，当某条项目特有规矩值得沉淀为规则时，Spiry 会主动建议你把它写进对应的增补件——你确认后才落笔。

AI 如何使用这些文件

1. 开工时：AI 先读热屋（知道此刻站在哪）→ 读冷屋（知道为什么走到这）→ 读导航图（知道有哪些资料）
2. 工作中：AI 按 AGENTS.md 的触发指针，在合适场景自动调用 Spiry 能力
3. 收尾时：AI 覆盖热屋（更新站位）→ 追加冷屋（记录决策）→ git commit

这套机制保证了：即使 AI 会话中断、上下文被压缩，下一次开工时 AI 也能精确接续。