关于 develop-spike-summary
面向工程团队的技能,用于记录限时技术探索的结果。它整理问题、方法、证据、建议、产物和未解事项,帮助团队作出决策。
主要功能
- 01明确探索问题
- 02记录计划与实际耗时
- 03整理方法和发现
- 04区分证据与假设
- 05提出行动建议
- 06追踪产物与未解问题
适用场景
- 01汇报技术探索结果
- 02评估技术或供应商选项
- 03分享概念验证发现
- 04实施前评估可行性
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ product-on-purpose/ pm-skills --skill develop-spike-summary安装后在 Claude Code 中输入/develop-spike-summary确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
HISTORY.mdevals/trigger-fixtures.jsonreferences/EXAMPLE.mdTEMPLATE.md详细介绍
Spike 总结
Spike 总结用于记录限时探索的结果——通过有针对性的调查,在投入实现之前降低不确定性。Spike 回答具体问题,例如“我们能否与此 API 集成?”或“这项技术是否适用于我们的用例?”总结会记录调查结果,帮助团队做出明智的决策,而不必让参与 Spike 的成员反复解释。
适用场景
- 完成限时技术探索后
- 评估技术选型或供应商选项时
- 完成需要为团队决策提供依据的概念验证工作后
- 调查拟议解决方案的可行性时
- 承诺投入工程资源采用新方法之前
不适用场景
- 你要记录的是最终的架构决策本身 -> 使用
develop-adr;Spike 提供依据,ADR 做出决策 - 探索属于用户研究,而非技术或设计可行性调查 -> 使用
discover-interview-synthesis - 你想提出 Spike 指向的解决方案 -> 使用
develop-solution-brief - Spike 尚未开展:此技能用于记录结果;请先设定时间限制并开展探索
说明
当被要求记录 Spike 时,请按以下步骤操作:
-
清晰陈述问题 阐明 Spike 要回答的具体问题。好的 Spike 问题范围明确,并且能在限定时间内得到解答。如果问题在 Spike 过程中发生变化,请同时记录最初版本和最终版本。
-
定义时间限制 记录分配的时间(例如,3 天)和实际耗时。如果 Spike 超出时间限制,请解释原因并注明剩余工作。
-
描述方法 说明尝试了哪些做法、顺序如何以及原因。这有助于后续读者了解方法,并判断是否考虑过其他方案。
-
提供有证据支持的发现 记录学到的内容,并提供具体证据支持,例如代码示例、性能基准、屏幕截图或 API 响应。区分已验证的发现和仍需进一步测试的假设。
-
给出明确建议 直接回答最初的问题:继续、不继续,或满足条件后继续。避免含糊其辞——团队需要可执行的指导。
-
记录产物 链接 Spike 期间创建的代码、原型、图表或文档。这些产物往往具有超出总结本身的持续价值。
-
记录未解决的问题 说明 Spike 未能回答的问题,以及可能需要开展的进一步调查。
输出格式
使用 references/TEMPLATE.md 中的模板组织输出。完整的 Spike 总结应填写模板中的每个部分:概述;背景;方法;发现;建议;产物;未解决的问题;后续事项。
质量检查清单
完成前,请确认:
- 已清晰陈述最初的问题
- 已记录时间限制(分配时间与实际耗时)
- 发现有证据支持,而非仅有观点
- 建议直接回答了问题
- 已链接或附上产物(代码、图表)
- 未解决的问题指出了尚不明确之处
示例
请参阅 references/EXAMPLE.md 中的完整示例。