跳到主要内容

别再翻了,直接把它玩成任务

一键三连
一键三连

· 阅读约 4 分钟

学一个新的 CLI 工具,你大概第三天就会把它扔进“哦对还有这么个东西”那个叫不回名字的文件夹。

我反正这样的。翻一遍 README,敲两条 --help,觉得“嗯懂了”,然后三周后连它当初解决什么问题都想不起来。文档不是读不懂,是读了就没有然后了——没有反馈回环,没有系统检查,学了个寂寞,只剩收藏夹里那一堆“以后要学”。

所以当我在 dev.to 上看到 claude-quest 的教学思路——别让你读文档,让你玩游戏——我第一反应是:为啥所有 CLI 教学都该长这样。

玩 claude-quest 的方式很直接。它是跑在真实 Claude Code 会话里的文本角色扮演游戏,把学 CLI 变成一场“跟着任务完成改动”的冒险。它给你一个目标,你得像真实工作一样去编辑文件、建配置、写 hooks、看会话里的输出,然后系统真的检查你留下的痕迹——文件、配置、hooks、工具调用,都看。隔天你忘了项目背景?不用怕,重来一遍的都是你亲手干过的事。

核心:它不是游戏,是一种防遗忘机制。

安装方式就是 Claude Code 会话里加一个插件命令:

/plugin marketplace add susheem-k/claude-quest

然后一条命令装好加启动:

/plugin install claude-quest

装完直接说一句话开玩:

let's play claude quest

没了。不用注册新账号,不用切出终端,不用翻独立 App 的手册,直接在你每天都在用的地方开始。第一次加插件一分钟——对,就一分钟,回到标题开头那个“三天后忘光”的问题,这个花式翻转过来了个说法。

我玩的一场任务大概是这个形状:任务目录里有目标描述、提示,和一个 check.js——没错,就是那种会检查你有没有真下功夫的 check.js。你写完配置,运行检查脚本,它会检查你实际留下的文件、配置和 hooks,以及你在会话里调用的真正痕迹。⚡这一下,就这——它不看“你以为你懂了什么”,它看你实际做了什么

任务还分了级。Artifact 层检查你写出的文件;Invocation 层验证会话里的真实调用结果;Mastery 层会跑测试来修概念问题——不是“这个函数长啥样”,是“这个 bug 为啥会出现”;最高的 Judgment 层用评判模型给你符合度的东西打分。设计很接近真实工具的反馈环——你不行,它不让过。

进度存在 ~/.claude-quest/ 里,所以换项目玩的时候不用从头开始。

最妙的是任务格式——就是含目标、提示和 check.js 的目录,任何人都能加,不用动引擎。不是“这个功能的文档死活找不到”,是“任务就在那儿放着,给我跑”。这就是把“该学的清单”变成“该通关的地图”,一个是被动翻看的索引,一个是主动撞上去的边界。

可能有朋友要问了:一个配置文件查这么严,玩家的自由度怎么办?我对这点的想法是——在入门阶段,自由度恰恰是低一点才好。它逼着你先看见惯例的存在,之后你想飞哪里飞哪里。游戏本来就是用规则圈出边界,让技术那层“默认值好习惯”打进肌肉记忆。

至于“在评判层会不会专门写符合评判模型的空话”——评论里有人问作者这个问题:“检查文件系统而非聊天内容,能真正展现工具失败的方式,但 Judgment 层会不会让人养成专写给评判提示看的写作习惯?”老实说这问题问得比作者预设的还细。他的回应是“培养品味”这事暂没考虑,当前重点是让用户把技能描述改到和实际用途更匹配——这回答我短暂接受,但心里记了一笔:等他将来真的做“口味”那层的时候,别把游戏变成“教你怎么讨好裁判”,那会毁掉这个工具诚实的内核。

这工具的 alpha 阶段还有明确的不完整:任务内容目前只覆盖 Claude Code 功能的一部分。但不要被“alpha”吓退,完整的游戏循环已经能玩——够你敲开第一关。它有超出“教学工具”的野心:把未知从“令人生畏的空白”变成“有名字的宝箱”。

学一个新东西,不该是囤完就忘——是在一局一局里被“要求”过的熟练。装这一下两分钟,玩两关半小时,换来的是那个旧 CLI 下次不再让你心里一沉。这台账,怎么都划算。

你有觉得“学过就忘”的指令式新工具吗?去试试把它做成 check.js 包裹的任务,看看记忆是不是一直留着味。