mcpField
D
develop-spike-summary

develop-spike-summary

github.com/product-on-purpose开发769731 次安装4 天前更新
代码仓库

关于 develop-spike-summary

面向工程团队的技能,用于记录限时技术探索的结果。它整理问题、方法、证据、建议、产物和未解事项,帮助团队作出决策。

主要功能

  1. 01明确探索问题
  2. 02记录计划与实际耗时
  3. 03整理方法和发现
  4. 04区分证据与假设
  5. 05提出行动建议
  6. 06追踪产物与未解问题

适用场景

  1. 01汇报技术探索结果
  2. 02评估技术或供应商选项
  3. 03分享概念验证发现
  4. 04实施前评估可行性

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/product-on-purpose/pm-skills --skill develop-spike-summary

安装后在 Claude Code 中输入/develop-spike-summary确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

HISTORY.md
evals/
trigger-fixtures.json
references/
EXAMPLE.md
TEMPLATE.md

详细介绍

Spike 总结

Spike 总结用于记录限时探索的结果——通过有针对性的调查,在投入实现之前降低不确定性。Spike 回答具体问题,例如“我们能否与此 API 集成?”或“这项技术是否适用于我们的用例?”总结会记录调查结果,帮助团队做出明智的决策,而不必让参与 Spike 的成员反复解释。

适用场景

  • 完成限时技术探索后
  • 评估技术选型或供应商选项时
  • 完成需要为团队决策提供依据的概念验证工作后
  • 调查拟议解决方案的可行性时
  • 承诺投入工程资源采用新方法之前

不适用场景

  • 你要记录的是最终的架构决策本身 -> 使用 develop-adr;Spike 提供依据,ADR 做出决策
  • 探索属于用户研究,而非技术或设计可行性调查 -> 使用 discover-interview-synthesis
  • 你想提出 Spike 指向的解决方案 -> 使用 develop-solution-brief
  • Spike 尚未开展:此技能用于记录结果;请先设定时间限制并开展探索

说明

当被要求记录 Spike 时,请按以下步骤操作:

  1. 清晰陈述问题 阐明 Spike 要回答的具体问题。好的 Spike 问题范围明确,并且能在限定时间内得到解答。如果问题在 Spike 过程中发生变化,请同时记录最初版本和最终版本。

  2. 定义时间限制 记录分配的时间(例如,3 天)和实际耗时。如果 Spike 超出时间限制,请解释原因并注明剩余工作。

  3. 描述方法 说明尝试了哪些做法、顺序如何以及原因。这有助于后续读者了解方法,并判断是否考虑过其他方案。

  4. 提供有证据支持的发现 记录学到的内容,并提供具体证据支持,例如代码示例、性能基准、屏幕截图或 API 响应。区分已验证的发现和仍需进一步测试的假设。

  5. 给出明确建议 直接回答最初的问题:继续、不继续,或满足条件后继续。避免含糊其辞——团队需要可执行的指导。

  6. 记录产物 链接 Spike 期间创建的代码、原型、图表或文档。这些产物往往具有超出总结本身的持续价值。

  7. 记录未解决的问题 说明 Spike 未能回答的问题,以及可能需要开展的进一步调查。

输出格式

使用 references/TEMPLATE.md 中的模板组织输出。完整的 Spike 总结应填写模板中的每个部分:概述;背景;方法;发现;建议;产物;未解决的问题;后续事项。

质量检查清单

完成前,请确认:

  • 已清晰陈述最初的问题
  • 已记录时间限制(分配时间与实际耗时)
  • 发现有证据支持,而非仅有观点
  • 建议直接回答了问题
  • 已链接或附上产物(代码、图表)
  • 未解决的问题指出了尚不明确之处

示例

请参阅 references/EXAMPLE.md 中的完整示例。

评论

支持 Markdown