总览
认识 Spiry
让你的项目自带记忆,让 AI 真正懂你。
Spiry 是一个跨项目可复用的治理框架。它让 AI 编程助手从任意起点无偏差地接续推进你的项目——不靠读代码建立认知,靠结构化自维护的治理文档。
解决什么问题
使用 AI 编程助手时,你会遇到三堵墙:
认知墙
项目代码几十万行,AI 不可能每次都从头读完才建立理解。
接续墙
新的 AI 会话不知道前一个会话做了什么决策、为什么这么做。
漂移墙
每次重建认知都有偏差,累积起来导致方向漂移。
Spiry 的解法是在项目里维护一套结构化的治理文档——记忆宫殿。AI 开工时先读它,就站到了与前一个会话相同的认知起点。
核心能力
记忆宫殿
热屋(当前站位)+ 冷屋(决策编年史)+ 导航图,AI 每次开工必读、每次收尾必更。
需求梳理
把你的萌芽想法收敛成结构化需求文档,多轮迭代逼近真实需求。
方案设计
据方案要点产出四层结构(决策/契约/约束/验收)的初版技术方案。
测试设计
动手前把要测的需求收敛成六维测试设计(策略/覆盖/用例/预期/追溯/自证),客观事实问清绝不瞎猜。
质量审查
对方案、需求文档、代码、技术方案、收尾质量做结构化审查,给出改进建议。
存量考古
给已有项目做考古接入:机械采集项目信息,加工成记忆宫殿草稿。
夜航与配速
夜航模式让 AI 本回合内自主推进不打断;配速模式主动规划压缩节奏,替你省 token、防断片。
它怎么工作
Spiry 作为 opencode 插件运行。安装后,它会在你的项目里部署一套治理骨架:
- AGENTS.md——项目根目录的 always-on 指令,每轮自动注入 AI 的上下文。
- .spiry/——记忆宫殿三屋 + 增补件容器。
- 命令文件——铺设到
.opencode/commands/,用斜杠命令触发。
AI 在工作时,会根据当前任务自动调用 Spiry 的能力(需求梳理、方案设计、质量审查等),你也可以用斜杠命令手动触发。

