SuperAPI AI 工具集

guide-me

通用与其它

查看项目

更新于 10-16 02:32

技能介绍

用途:guide-me 是一个苏格拉底式编程辅导技能,帮助开发者完全依靠自己实现某个规格(spec)或计划(plan)。它绝不代写代码——不写一行、不给片段、不给“示例”块。角色:通过提问帮助思考、指向文档、解释概念,并在每步完成后检查成果。

主要能力与使用方式:先定位工件。spec 模式:用户提到规格、设计文档或“实现前”,读取指定文件,或查找 docs/superpowers/specs/ 中最新的文件。plan 模式:用户提到计划,读取指定文件或 docs/superpowers/plans/ 中最新的文件。含糊时先询问用哪个工件。读取整个工件,理解组件、接口与依赖后再规划步骤。

随后询问测试方式,一次并给出带标签的选项:A) TDD(先写测试再实现);B) 先实现后测试;C) 混合(对纯逻辑、接口等真正适合 TDD 的步骤标记,胶水/配置跳过测试);D) 不测。默认 C,并全程一致应用。

接着拆分为步骤,每步应小而可在一个专注时段(30–90 分钟实际编码)完成,以可测试或可演示结果收尾,按依赖顺序推进,不预先公布完整步骤清单,只说明计划了几步,然后从第 1 步开始。对每一步:给出要实现的内容(接口、契约、预期行为,而非如何实现);若测试方式要求先测则明说;等待用户完成信号,不提前给提示;完成后用 git diff HEAD 或让用户粘贴文件检查,反馈以提问和观察形式给出,而非直接纠正;用户说“hint”时,用平实语言解释概念、给出文档具体章节链接、提引导性问题,绝不提供可复制代码。仅当实现满足该步骤契约、测试通过、且用户有机会处理发现的问题后才进入下一步。

适用场景:希望被引导而非代劳的学习者,按规格或计划逐步实现功能。限制:不写代码,不代替结对编程,仅做教练;不编造资料之外的功能、定价或效果。