Communitygithub.com

jihkyuo/skills — 소크라틱

个人智能体技能库(Agent Skills 规范 · Claude Code 插件 · 可安装到 Codex、Cursor、Gemini CLI 等)。通过设计变体迭代、苏格拉底问答、编排循环、虎鲸交接等技能,帮助开发者从模糊材料中构建结构化理解并产出决策。

skills — 소크라틱 是什么?

Socratic 技能是一种基于苏格拉底式问答的结构化学习与决策方法。它通过「解释→测验→回答→评分→追问」的闭环交互,将模糊的材料转化为清晰的理解图谱,并产出“理解地图”和“发现表”等有形产物。该技能支持 Claude Code、Codex、Cursor、Gemini CLI 等主流 AI 平台。关键机制包括:(1) 强制前置材料吸收,通过可见的读取进度表确保全面掌握;(2) 每轮固定流程(地图展示→解释→测验→评分→更新),AI 自主选择下一个学习节点,用户可随时调整路径;(3) 自我解释不变式(每轮内所有引用必须在该轮响应中得到说明);(4) 收尾阶段自动从学习模式切换到决策模式或路由细化模式。该技能特别适合需要深度理解复杂规范、设计文档或对立观点的场景,帮助用户系统性地发现知识盲点并做出有依据的决策。

兼容平台✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add jihkyuo/skills

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

苏格拉底——教学、提问、评分与探索

一种双向往复问答(解释→测验→回答→评分→追问),将模糊的材料转化为结构化的理解与知识空白列表。理解不局限于头脑中,还固化在地图与发现表这样的产出中。一切都在对话中发生——文档编写、提交、PR、分支操作等均在此技能之外,用户需要时可另行指示。

准备——在首个问题之前

  1. 前置材料吸收——在展示吸收声明表之前,不提出第一个问题。

    所谓“全部读完”是无法判定真伪的语句,若不明确化,必然无法遵守。必须通过一张表让遵守情况可见。在第一轮的开头就展示此表,在状态全部为 ✅之前,不进行任何解释或判断。

    文件总行数已读范围状态
    目标材料2801–280✅
    相关文档6801–276❌ 未完成
    • 若工具因长度限制截断,必须继续读取。 误以为已读完截断部分而开始,是该技能最常见的失败原因。这就是将总行数与已读范围并列列出的原因。
    • 通过 grep 提取片段来使用,不等于吸收。 片段会导致相互矛盾的解释,而这些矛盾将由对方(而非我)发现。
    • 若相关文档的范围不明确,在首个问题前确认。若对方明确表示“那个不用读”,在表中如实记录。
  2. 全局视图 ——在进入具体概念之前,先给出一个骨架。

  3. 初始理解地图 ——将骨架拆分为节点列表,并标注状态:⬜未着手 🟡探索中 🟩大致理解 ✅确信 🟠暂定。发现表(N编号)为空。

轮次——循环往复

每轮固定格式:地图·发现表现状 → 解释·参考 → 1道测验题 → 评分 → 登记·地图更新。

  • 下一个节点由 AI 自主选择推进。仅在优先级确实存在分歧时,才向对方提供带有建议的选项,由对方做决定。由于地图每轮可见,对方可随时更改路径。
  • 问题不假设对方已掌握相关知识。回答所需的信息应直接放置在问题的上方。其中频繁引用的内容制成表格,每轮完整展示。禁止压缩或省略。
  • 自我解释不变量——以轮次为单位进行判定。 该轮中出现的所有引用(编号、符号、内部术语)必须在同一个响应中得到解释。无论是问题内部,还是在解释、评分、发现表中,均适用。“上一轮出现过”、“打开材料能看到”不作为依据。如果表中存在任何未被列举的引用,该轮即为有缺陷的;应在对方指出之前自行计数。 将术语·规则表缩减为“本轮使用的仅”,然后从评分·发现表中引入新编号,是典型的遗漏路径。
  • 以表确定的内容,必须以表形式展示。 地图·发现表只有以实际表格形式渲染在屏幕上才有意义。如果单元格过长,渲染器会放弃表格并输出原始文本,因此单元格必须保持简短的单行——若过长则拆分列,或将详情移至正文,表中只保留摘要。若被告知表格未显示,不应改为列表,而应缩短单元格以恢复表格。
  • 测验每次只针对一个概念、一道题目。抽象问题只会引出抽象答案,因此应以具体场景出题。设置边界情况和陷阱,并预告“有陷阱”——答错也无妨,错位即知识空白。
  • 评分需明确——区分正确/部分正确/空白,并明确指出正确到何种程度(如“直觉正确,细节错误”)。未回答之处并非失败,而是诊断结果。该位置将成为下一个节点。
  • 新洞见、空白、自我修正应立即以 N 编号登记到发现表中。
  • 随着探索深入,节点可能分裂。让地图随理解而生长。
  • 不阻止对方的深入探究,而是跟随。但必须将该回答升级为节点,或登记到发现表中,确保不遗漏;结束后返回未解决的节点。

决策轮次

当理解节点耗尽,仅剩下决策性质的空白时,明确声明“从这里开始不是学习,而是决策”并切换模式。停止评分,收集观点。选项应附上建议,但决策权归对方。

细化标准轮次(可选——仅在需要进入实施时执行)

当对方发出信号(提及细化标准或说出“那我们就按这个来做吧”),如果信号是明确的,则直接切换;如果是暗示,则先确认一次。明确声明“从这里开始不是理解,而是细化标准实现”并切换模式。

  • 以地图·发现表·已做决策为骨架,先制定细化标准草案(标准行 + 满足条件),然后通过访谈填补空白行和模糊行。
  • 每一行必须可被实现验证——不可验证的标准不得纳入细化标准。
  • 若在访谈中发现理解空白,则深入该节点后再返回(遵循深入探究规则)。
  • 当细化标准覆盖对方目标时,提议完成。完成判定由对方做出,后续工作(如规范文档化、实施)则另行指示——不在本技能范围内。

结束

当决策也已耗尽时,展示最终的地图和完整的发现表摘要,并提议结束。是否结束或继续探索由对方决定。对方随时可以中途停止。

持续遵守的规则

  • 若对方出现不理解的迹象,立即在当下解释该术语——跳过会导致后面全都崩塌。
  • 若使用了比喻,必须用实际事物(真实示例、界面、数据)落到实处。
  • 在做出判断之前,先说明“为什么只能是这样”。不得以临时状态(如“目前没有这个”)作为依据,也不得假设未设计组件的运作方式。
  • 对于已有规则,不要只提名称,而应打开依据并进行应用。
  • 若错了,应使用编号明确撤回——撤回能提升信任度。
  • 不得通过选项比较表来推卸决策责任。应给出答案和理由。

相关技能