核心能力

Spiry 的核心能力覆盖从接入到收尾的全生命周期。这些能力大部分时候自动触发——AI 会根据当前任务判断该不该调；你也可以用对应的斜杠命令手动触发。

能力总览

需求梳理

当你有一个模糊的想法或需求时，Spiry 会帮你把它收敛成结构化的需求文档（PRD）。

Spiry 会：

1. 理解你的萌芽需求
2. 产出一份结构化 PRD 草稿（含目标、用户故事、功能清单、边界条件等）
3. 列出还需要你回答的问题清单——这些是把需求问清楚的关键

你可以多轮迭代：回答 Spiry 的问题，它会据此精化 PRD，直到需求收敛。

用法示例：

/spiry-requirement 我想做一个团队日程投票工具

方案设计

当需求明确后，Spiry 会帮你产出一份结构完整的初版技术方案。

方案包含四层结构：

• 决策层——方向性决策（为什么这么做、否了什么备选）
• 契约层——接口契约（类型签名、数据结构）
• 约束层——实现约束（性能要求、兼容性、技术选型）
• 验收层——验收标准（怎么验证做对了）

方案还会附带一份维度覆盖自证表，确保关键维度（安全性、性能、可维护性等）都有考虑。

用法示例：

/spiry-design 给购物车设计一套满减规则

测试设计

需求明确、方案成形之后、写代码之前，Spiry 可以帮你把「要测什么」想清楚——产出一份成体系的测试设计。

设计包含六个维度：

• 测试策略——测什么、不测什么、优先级怎么排
• 覆盖思路——等价类怎么划、边界值怎么选，依据是什么
• 用例清单——正常 / 异常 / 边界三类用例，条条要素齐全
• 预期结果——每条用例的预期行为，错误码语义不串用
• 追溯矩阵——需求 ↔ 用例双向可追溯，无遗漏、无孤儿
• 覆盖自证表——逐维自证在场，收口有凭据

与需求梳理、方案设计一样，测试设计支持多轮迭代：你回答追问，它据此精化设计，直到收敛。它还能直接吃上游产物——把定稿的 PRD 或技术方案作为输入，对齐覆盖、推断失败模式。

用法示例（一句话描述，或直接给承载需求的文件）：

/spiry-testdesign 购物车满减金额的计算逻辑
/spiry-testdesign docs/需求-购物车满减.md

质量审查

Spiry 可以对五种对象做结构化质检：

审查结果按严重度分级（block / warn / info），每条发现都包含问题位置、问题描述和建议修法。

用法示例（给出要审的对象，类型按对象性质自动选）：

/spiry-review src/payment/          （代码审查）
/spiry-review docs/技术方案.md      （方案自审）

存量考古

如果你有一个已经存在的项目，想接入 Spiry，用考古能力可以快速建立认知基线。

Spiry 会：

1. 机械采集——读取 git 历史、技术栈、目录结构、README（只读、不修改）
2. 加工——把采集到的素材加工成记忆宫殿草稿（热屋站位 + 冷屋决策推测）
3. 追问——列出它无法从素材中推断的信息，以成组追问清单的形式问你

多轮迭代：你回答 Spiry 的追问，它据此精化草稿，直到认知收敛。

用法示例：

/spiry-intake            （考古当前目录）
/spiry-intake apps/web   （指定源码根目录）

骨架部署

为新项目部署 Spiry 治理骨架。部署内容：

• 根 AGENTS.md（含标准区 + 空项目区）
• .spiry/ 记忆宫殿三屋骨架
• 增补件容器（配对各判据束的项目特化）

部署是非破坏性的——如果你已有 AGENTS.md，Spiry 会保留你的原文、只补 Spiry 标准入口。

用法示例：

/spiry-init

标准件升级

当 Spiry 框架更新后，用升级能力把项目的标准件刷新到最新版。

• 只刷新标准区（AGENTS.md + 增补件标准区）
• 项目区一字不动（你的定制内容不受影响）
• 记忆宫殿三屋绝不触碰（热屋/冷屋/导航图不覆盖）