用途:在用户想先试探一个想法、验证可行性、比较不同方案或暴露未知风险时使用。Spike 是一次性的,验证完即丢弃。触发语包括“让我试试”“看看 X 行不行”“spike 一下”“在投入 Y 之前”“Z 的快速原型”“这到底可不可能”“比较 A 和 B”。
不适用:答案能从文档或代码读出来时只做调研;属于生产路径时改用 plan 技能;想法已验证则直接实现。若已安装完整 GSD 系统(gsd-spike 作为同级技能出现,通过 npx get-shit-done-cc --hermes 安装),优先用 gsd-spike,它提供持久化的 .planning/spikes/ 状态、跨会话 MANIFEST 跟踪、Given/When/Then 结论格式和提交模式;本技能是无完整系统的轻量独立版。
核心方法:decompose → research → build → verdict,并按发现迭代。
- 拆解:把想法拆成 2-5 个独立可行性问题,每个问题一个 spike,用 Given/When/Then 表格呈现,含风险列。类型分 standard(一种方案回答一个问题)和 comparison(同一问题不同方案,共享编号加 a/b/c 后缀)。问题要具体、有可观察输出;按风险排序,最可能推翻想法的先做。用户已明确要验证什么时可跳过拆解。
- 对齐:多 spike 时展示表格并询问“按此顺序全部构建,还是调整?”,允许用户删减、重排或改写。
- 调研:每个 spike 先写 2-3 句简述,列出候选方案(工具/库、优缺点、维护状态)并说明选择理由;纯逻辑无外部依赖可跳过。可用 web_search、web_extract、terminal 检查已安装版本,或克隆读 README/examples,也可用 Context7 MCP。
- 构建:每个 spike 一个独立目录,如 spikes/001-websocket-streaming/,含 README.md 和代码。优先做成可交互产物:可运行 CLI、最小 HTML 页面、单端点小服务器或带明确断言的单元测试。重深度而非速度,测试边界情况。除非必要,避免复杂包管理、构建工具、Docker、env 文件和配置系统,一切硬编码。并行比较型 spike 可用 delegate_task 分派,各自返回结论后做对比。
- 结论:每个 README.md 以 Verdict: VALIDATED | PARTIAL | INVALIDATED 结尾,并写清有效之处、无效之处、意外发现和对真实构建的建议。比较型 spike 最后做 head-to-head 对比表并给出胜出者。
Frontier 模式:已有 spike 时,可遍历目录寻找集成风险、数据交接、愿景缺口和替代方案,提出 2-4 个 Given/When/Then 候选供用户选择。
输出:在仓库根目录创建 spikes/(或 .planning/spikes/),每个 spike 一个 NNN-描述性名称/ 目录,README.md 记录问题、方法、结果和结论,代码保持一次性。
限制:本技能为轻量独立版,不含持久化状态与 MANIFEST 跟踪;具体安装与运行命令、平台支持等资料未提供。