总览

认识 Spiry

让你的项目自带记忆,让 AI 真正懂你。

Spiry 是一个跨项目可复用的治理框架。它让 AI 编程助手从任意起点无偏差地接续推进你的项目——不靠读代码建立认知,靠结构化自维护的治理文档。

解决什么问题

使用 AI 编程助手时,你会遇到三堵墙:

认知墙

项目代码几十万行,AI 不可能每次都从头读完才建立理解。

接续墙

新的 AI 会话不知道前一个会话做了什么决策、为什么这么做。

漂移墙

每次重建认知都有偏差,累积起来导致方向漂移。

Spiry 的解法是在项目里维护一套结构化的治理文档——记忆宫殿。AI 开工时先读它,就站到了与前一个会话相同的认知起点。

核心能力

记忆宫殿

热屋(当前站位)+ 冷屋(决策编年史)+ 导航图,AI 每次开工必读、每次收尾必更。

需求梳理

把你的萌芽想法收敛成结构化需求文档,多轮迭代逼近真实需求。

方案设计

据方案要点产出四层结构(决策/契约/约束/验收)的初版技术方案。

测试设计

动手前把要测的需求收敛成六维测试设计(策略/覆盖/用例/预期/追溯/自证),客观事实问清绝不瞎猜。

质量审查

对方案、需求文档、代码、技术方案、收尾质量做结构化审查,给出改进建议。

存量考古

给已有项目做考古接入:机械采集项目信息,加工成记忆宫殿草稿。

夜航与配速

夜航模式让 AI 本回合内自主推进不打断;配速模式主动规划压缩节奏,替你省 token、防断片。

它怎么工作

Spiry 作为 opencode 插件运行。安装后,它会在你的项目里部署一套治理骨架:

  1. AGENTS.md——项目根目录的 always-on 指令,每轮自动注入 AI 的上下文。
  2. .spiry/——记忆宫殿三屋 + 增补件容器。
  3. 命令文件——铺设到 .opencode/commands/,用斜杠命令触发。

AI 在工作时,会根据当前任务自动调用 Spiry 的能力(需求梳理、方案设计、质量审查等),你也可以用斜杠命令手动触发。

下一步