SuperAPI AI 工具集

socratic-method

设计与创作

查看项目

更新于 10-15 16:46

技能介绍

用途:该技能用于与初级/早期职业工程师协作非平凡工程任务时,采用苏格拉底式提问:对任务要教授的核心概念先提问、不给答案,直到两次真实尝试失败,再按提示阶梯(模糊提示→具体提示→完整小例子→直接讲解)推进;若走完整个阶梯,主题记为 needs revisit 而非 mastered。附带性、边缘问题直接回答,不设门槛。仅对非平凡任务启用;若工程师要求跳过(如正在 on-call)或正处于线上事故中,立即停止,事故中不做苏格拉底提问,留到事后复盘;跳过需在掌握度文件记为 skipped-override。对约前 10 个非平凡任务,无论文件记录如何都从轻处理,但任务涉及多个独立核心概念时,每个仍至少做一次快速检查。使用简单平实的英语。

主要能力:与 AGENTS.md 相同的七个阶段——编码前、设计评审、开发、提交前、评审同伴 PR、复盘调试(绝不在线上事故中)、估算;每阶段结束更新掌握度文件。若其他规划/头脑风暴/设计技能已在提问需求问题,不能算满足本规则,仍需对技术决策继续先问后答。在将技术决策定为结论前,先查掌握度文件中同一概念是否有带具体跟进项的记录;将要实施的内容正是该跟进项时,即使本任务中已做过相关检查也要再查。注意:一般概念检查过(如“这里存在竞态条件”)不等于覆盖更具体的待补缺口(如实际修复所用的数据库机制)。

使用方式:掌握度文件按顺序查找 ~/.junior-growth/mastery.md;不存在则询问一次存放位置并记入自己的记忆;都不存在则以本仓库的 mastery-template.md 创建。为让更新可靠,可把“阶段正常产出”和“掌握度文件更新”合并为同一步(如写 PR 描述时同回合更新);更强保障是配置 Claude Code 的 PostToolUse hook(可选,见 /docs/en/hooks-guide)。一次性设置:在个人 ~/.claude/CLAUDE.md 中加一行 @~/git-practices/socratic-method/AGENTS.md,按需调整克隆路径。若上下文未见 AGENTS.md 指令,可查看本文件旁或询问工程师。

限制:v1(2026-09-18)。具体收费、平台支持范围、效果数据等暂未提供。