Spike 是一个面向“先验证、再动手”的轻量技能,用于在正式开发前把小想法拆成可执行、可丢弃的实验,快速回答“到底行不行”。
用途 当用户想试探一个想法、验证可行性、比较不同方案,或暴露那些仅靠查阅资料无法回答的未知时使用。常见触发语包括“让我试试这个”“我想看看 X 行不行”“先做一个 spike”“在我投入 Y 之前”“快速原型”“这到底可实现吗”“A 和 B 对比”。
主要能力 核心循环为:分解 → 调研 → 构建 → 结论,并根据发现不断迭代。
- 分解:把想法拆成 2-5 个独立的可行性问题,每个问题对应一个 spike,用 Given/When/Then 表述,并按风险排序——最可能推翻想法的问题先做。支持标准型(单一方案回答一个问题)与对比型(同一问题、不同方案,编号加 a/b/c 后缀)。
- 对齐:多 spike 时先列出表格,让用户决定是否按此顺序构建、删减或重排。
- 调研:为每个 spike 写 2-3 句简介,列出候选方案及其优劣与维护状态,再选定一个并说明理由;纯逻辑、无外部依赖时可跳过。
- 构建:每个 spike 一个独立目录(如 spikes/001-xxx/),偏向可交互的产出,首选可运行 CLI、最小 HTML 页面、单端点小服务或带明确断言的单元测试;强调深度优于速度,不只跑一次正常路径,要测边界情况。避免复杂包管理、构建工具、Docker、环境配置,直接硬编码。并行对比型 spike 可用 delegate_task 并行委派。
- 结论:每个 README 以结论收尾,写明哪些成功、哪些失败、意外发现以及对正式构建的建议;VALIDATED 表示有证据地回答了核心问题,PARTIAL 表示在特定约束下可行,INVALIDATED 表示不可行及原因(这同样是一个成功的 spike)。对比型 spike 最后做逐项对照并给出胜出方。 此外还有“前沿模式”:当已有若干 spike 时,可从中找出集成风险、数据交接、未验证的能力缺口或替代方案,提出 2-4 个后续候选。
使用方式 在仓库根目录创建 spikes/(若使用 GSD 约定则为 .planning/spikes/),每个 spike 一个 NNN-描述性名称/ 目录,内含 README.md 与代码。典型流程为创建目录、写 README、写代码、运行观察并迭代。若用户已安装完整 GSD 系统,且存在 gsd-spike 兄弟技能,则优先使用 gsd-spike(具备持久化 spike 状态、跨会话 MANIFEST 跟踪、Given/When/Then 结论格式及与 GSD 集成的提交模式);本技能是不想要完整系统的用户的轻量独立版本。
适用场景 新方案可行性验证、技术选型对比、原型快速试错、识别项目早期高风险未知。
限制 不应在以下情况使用:答案可从文档或阅读代码得知(直接调研即可)、工作属于生产路径(应使用计划流程)、想法已经验证过(直接实现)。代码必须保持可丢弃——需要花两天“清理上生产”的 spike 就是失败的 spike。该技能改编自 GSD 项目的 /gsd-spike 工作流(MIT © 2025 Lex Christopherson)。