返回资讯中心
外部精选
软件工程
#开发者实时流

Fiu 推出沙箱代码练习,帮助开发者理解 AI 生成的代码

来源标题:Fiu – A nose for code you didn't write, via sandboxed code workouts

Fiu 将仓库中的真实代码转化为小型验证练习(Workouts),让开发者亲手解题以偿还“理解债”。练习支持编辑器内修复代码(Drill、Kata)或在终端做思维模型验证(Prediction、What-if 等)两条路径。Drill 和 Kata 会把代码与单元测试复制到 .fiu/attempts/ 下的独立目录,每次保存自动重跑测试,原始 Workout 保持不变。

Hacker News 最新srosignoli2026/11/18 · 今天22 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

Fiu 源自意大利语 fiuto,意为“对某事的嗅觉”:一种对你从未亲手敲过的代码的嗅觉,一种读懂并非出自你手的代码的本领。 AI agent 正在编写越来越多我们名下的代码。Fiu 让你保持对它们的熟悉。它把你仓库中的真实代码转化为一个个小型、经过验证的练习(Workout),由你自己动手解答,一次一个 Workout,逐步偿还理解欠下的债。 Workout 支持两条路径:在编辑器中动手修复代码(Drill、Kata),或者直接在终端中验证心智模型、无需打开 IDE(Prediction、What-if、Rule check、Diagnosis)。 对于 Drill 和 Kata,fiu train 会把代码和单元测试复制到一个全新的 .fiu/attempts/<id>/<n>/ 目录中,并打印出路径。你阅读 README.md、查看单元测试,在你惯用的编辑器里修改代码,而 fiu train 会在每次保存时重新运行测试。如果没有设置 $VISUAL,就直接在你的编辑器中打开打印出的 .fiu/attempts/... 文件。如果设置了 $VISUAL,Fiu 会以分离方式启动它,以便 fiu train 继续占用你的终端:请使用 GUI 编辑器(VISUAL="code"),或为终端编辑器加上终端模拟器前缀(VISUAL="kitty vim" 或 VISUAL="gnome-terminal -- vim")。.fiu/workouts/ 中的原始 Workout 保持不动,以便你日后重做或与团队分享。 每个 Workout 的 README 都以“Around this code”开头:说明该文件夹和文件是做什么的(对于 Prediction,只说明文件夹)、谁在使用这段代码、这段代码使用了什么,以及什么会随它一起变化。它绝不描述你正在处理的代码本身(可在 .fiu/config.json 中用 "context": false 将两者都关闭)。每个 Workout 结束后,会有一份 Debrief,展示代码所在的位置、它的用途、它属于哪些业务流、它可能执行的规则、谁调用它、它的张力(影响范围、变动频率、隐藏耦合),以及接下来该练习哪些邻近部分。 每个答案都通过在 OS 沙箱内运行代码来评判,绝不由模型断言。Verified Gate 只有在测试证明了真实行为、并且每个干扰性 Variant 都能被单独识别时,才会接受一个 Workout。如果 Drill 中有 bug 的代码行与你实际的源文件逐字一致,Fiu 还会在你完成 Attempt 后提示:这个 bug 可能已经真实存在了。 在 Fiu 中,Atlas(fiu atlas 和 fiu map)是你代码库的入口。它描述每个文件夹、文件和关键符号的用途。与此同时,Fiu 直接从 import 和 git 历史中计算 Links(Uses、Used by、Changes with)。 像 Understand-Anything(UA)这样的工具提供了一种被动学习代码库的方式。它们生成一个静态知识图谱供你阅读,包含摘要、架构分层、业务流和领域规则。被动阅读是有益的起点,但它既不检验你的心智模型,也不证明文档中的规则与代码相符。Fiu 则通过经过验证的 Workout 提供主动学习。 Fiu 内置的 Atlas 在信息深度和 token 消耗上都比 Understand-Anything 轻量得多,因此两者不能直接比较。Fiu 可以依靠自己的 Atlas 独立工作(fiu atlas build)。这个内置 Atlas 以极低的 token 成本,提供给你定位方向、挑选 Workout 所需的一切。 不过,如果你的团队已经因为其他原因在使用 Understand-Anything(.understand-anything/ 或 .ua/),把两个工具结合起来,是统一两种策略的最佳配置。你既能从 Understand-Anything 获得广泛的被动定位,又能从 Fiu 获得经过沙箱验证的主动练习。Fiu 无需任何 flag 即可复用已有的图谱("understandAnything": false 可将其关闭): Fiu 中的每个 Workout 都由一个代码文件和一个测试文件组成,只使用该语言的标准库和内置测试运行器。当 Fiu 提取一段代码时,它会把框架、第三方库、数据库和队列替换为小型的内联 fake 或参数。这服务于两个目标: 开箱即用,Fiu 内置了四种语言的 Language Profile: 将 Fiu 扩展到其他语言——例如 Rust、Ruby、Java 或 C#——无需对核心引擎做任何改动。Language Profile 是纯配置数据。你可以在 .fiu/config.json 的 "profiles" 下声明一门新语言(或在 src/languages/builtin.ts 中贡献一个内置 profile)。每个 profile 需指定 extensions、codeFilename、testFilename、静态的 supportFiles、preflightCmd、testCmd(输出 tap 或 junit-xml)、可选的 declarationPattern 正则,以及沙箱 cacheDirs。

From a clone of this repository

npm install && npm run build && npm link

In the repository you want to practise on

fiu init # create .fiu/ and check the sandbox fiu atlas build # map what each folder, file, and key symbol does fiu drill src/queue.ts # generate a Drill and open it in the runner fiu train # practise any pending Workout, Series, or Track 改用 Claude Code 而非 API key: fiu agent install claude # install the MCP server, subagent skill, and /fiu-* commands 向 Claude Code 请求一个 Workout(或运行 /fiu-drill src/queue.ts 和 /fiu-atlas)。Claude 会把生成任务委托给一个低成本的 subagent,从而让你主编码会话的上下文窗口保持干净。 fiu atlas / fiu atlas <file> / fiu atlas search "<goal>":浏览代码库 Atlas,查看某个文件使用了什么、谁在使用它、什么会随它变化,或找出某个目标背后的文件。 fiu explore <dir> / fiu explore --about "<goal>" / fiu explore --flow "<name>" / fiu track:围绕一个模块、一个目标或来自 Understand-Anything 领域图谱的业务流,构建或继续一个多步骤的 Track。 fiu quick [--while "<cmd>"]:立即解答一个 Workout,或在 agent 运行、长时间构建或流水线完成期间进行。 fiu map:查看理解覆盖率,定位尚未练习的热点。fiu map --flows:按业务流查看同样内容,并在仓库有 Understand-Anything 领域图谱时,显示代码是依据哪些业务规则被检查的。 fiu stats:跟踪你的 Prediction 准确率、信心校准情况和 Blind Spot。 fiu share [--atlas] / fiu fetch:在 fiu/workouts 分支上与团队分享经过验证的 Workout 和 Atlas,无需触碰 main。

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →