命令手册
全部命令
Spiry 的全部斜杠命令，按功能分组。
Spiry 的命令铺设在 .opencode/commands/ 目录下，命名统一为 spiry-* 前缀。在 opencode 对话中输入 / 即可看到自动补全列表。
项目接入
/spiry-init
为当前项目部署 Spiry 治理骨架。缺才建、已有 AGENTS.md 原文保留。部署后引导下一步（全新项目→初始化记忆宫殿；存量项目→考古接入）。
语法：
/spiry-init/spiry-intake
对当前项目做存量考古接入。机械采集 git/技术栈/目录/README → 加工成记忆宫殿草稿 + 追问清单。一次性动作，支持多轮迭代。
语法：
/spiry-intake [源码根目录]示例：
/spiry-intake （缺省＝考古当前目录）
/spiry-intake apps/web （指定源码根目录）/spiry-root-build
把源码降为子目录、git 仓根上移一级（治理文件留根并被 git 追踪）。七项预检＋自动备份＋原子搬移＋登记 commit，零历史重写。适合「仓根＝源码根」的存量项目。
语法：
/spiry-root-build [子目录名]示例：
/spiry-root-build （子目录缺省 source）
/spiry-root-build src需求、方案与测试
/spiry-requirement
把萌芽需求收敛成结构化 PRD 草稿 + 追问清单。支持多轮迭代（回答追问 → 精化 PRD → 再追问，直到收敛）。
语法：
/spiry-requirement <萌芽需求描述>示例：
/spiry-requirement 我想做一个团队日程投票工具/spiry-inspect
定稿 PRD 质量体检（验收责任人视角）：一份材料＝首检，出总体裁决（通过/驳回）＋稳定编号意见（必改/提示）；两份材料（PRD＋首检报告）＝复审，仅逐项判定已解决/未解决/部分解决、绝不新增意见。首检报告会自动落盘供复审比对。
语法：
/spiry-inspect <PRD 路径> [首检报告路径]示例：
/spiry-inspect docs/PRD.md （首检）
/spiry-inspect docs/PRD.md docs/PRD体检报告-2026-08-28.md （复审）/spiry-design
据方案要点产出四层结构（决策/契约/约束/验收）的初版方案 + 维度覆盖自证表。当初稿、不当终稿。
语法：
/spiry-design <方案要点描述>示例：
/spiry-design 给购物车设计一套满减规则/spiry-testdesign
把要测的需求收敛成六维测试设计草稿（测试策略/覆盖思路/用例清单/预期结果/追溯矩阵/覆盖自证表）+ 追问清单。支持多轮迭代，可链式吃上游 PRD 与方案。客观事实推不出就问、绝不瞎猜。
语法：
/spiry-testdesign <需求描述 | 承载需求的文件路径>示例：
/spiry-testdesign 购物车满减金额的计算逻辑 （一句话描述）
/spiry-testdesign docs/需求-购物车满减.md （直接给承载需求的文件）审查
/spiry-review
对指定对象做一次质检。可选类型：方案自审 / PRD 需求审查 / 代码审查 / 维度覆盖审查 / 收尾质量审查。返回结构化发现（严重度/位置/问题/修法）。
语法：
/spiry-review <对象路径或全文>示例：
/spiry-review src/payment/ （代码·按对象性质选类型）
/spiry-review docs/技术方案.md （方案自审）收尾
/spiry-close
收尾四态写协议：① work-complete（实质工作完成）→ ② governance-close（覆盖热屋 + 追加冷屋 + 一致性排查 + todo list 同步）→ ③ git-deliver（本地 commit）→ ④ handoff-ready（按 upstream 状态校验交付态）。严格有序、每态附可观察证据。
语法：
/spiry-close [收尾附加指令]示例：
/spiry-close
/spiry-close Commit+push （收尾附加指令）/spiry-close 收尾。收尾保证了认知被完整落盘，下一次开工时 AI 能精确接续。详见 收尾协议。工作模式
/spiry-yehang
进入夜航模式：本回合内常规岔路 AI 全权自决、到语义边界自动收尾不停下问。只放行带消息的简单本地 commit。要一行同开夜航与配速，请用 /spiry-cruise 任务描述。
语法：
/spiry-yehang/spiry-yehang-off
退出夜航、恢复日间交互节奏（commit 恢复逐次弹确认）。
语法：
/spiry-yehang-off/spiry-cruise
双模启动：夜航与配速一行同开。命令后必须跟上本次要配速的任务描述，该内容即本次配速任务；空参或纯数字会被命令级拦下。
语法：
/spiry-cruise <任务描述>示例：
/spiry-cruise 完成登录模块重构/spiry-pacing
启用配速模式（Pacing Mode）：规划期预埋压缩点，到点自动铺路、自动压缩、自动续跑，全程无需人工干预。命令后必须跟上本次要配速的任务描述，配速以该任务的 todo 清单为作用对象。
语法：
/spiry-pacing <任务描述>示例：
/spiry-pacing 完成登录模块重构/spiry-pacing-off
关闭配速模式，上下文管理回归默认行为。
语法：
/spiry-pacing-off详见 夜航与配速。
版本维护
使用提示
- 输入
/可以看到所有可用命令的自动补全。 - 大多数命令不需要手动调用——Spiry 会在合适的场景自动触发。
- 命令只是入口，真正的能力在后台运行。你可以把命令理解为「告诉 AI 现在该做什么」。