SuperAPI AI 工具集

karpathy-coder

编程与开发

查看项目

更新于 10-15 16:47

技能介绍

karpathy-coder 用于在编写、审查或提交代码时强制遵循 Karpathy 的四条编码原则,源自其对 LLM 编程陷阱的观察。四条原则:一是编码前思考,显式说明假设,不确定就问,存在多种解释时全部列出而非默默选择,有更简单方案要提出,不清晰就停下命名困惑;二是简单优先,只写解决问题的最少代码,不加未要求的功能、单次使用代码的抽象、未要求的灵活性与配置,200 行能写成 50 行就重写;三是外科手术式改动,只碰必须碰的,不改动相邻代码、注释和格式,不重构没坏的东西,匹配既有风格,发现无关死代码只提及不删除,只清理自己改动造成的未用导入与变量;四是目标驱动执行,把“加验证”转为“先写无效输入测试再让其通过”,多步任务列出计划与验证点。

配套内容包括:斜杠命令 /karpathy-check 对暂存改动做完整四原则审查;scripts/ 下四个仅用标准库的 Python 工具(complexity_checker.py 检测过度工程、diff_surgeon.py 检测无关 diff 噪音、assumption_linter.py 检测计划中的隐藏假设、goal_verifier.py 检测薄弱成功标准);子代理 karpathy-reviewer 对 diff 运行全部四原则,可由 /karpathy-check 或提交前手动调用;hooks/karpathy-gate.sh 对暂存文件运行 complexity_checker.py 和 diff_surgeon.py,发现违规时非阻塞警告,可通过 .claude/settings.json 或 Husky 接入。参考资料含原则原文、10 多个跨 Python/TypeScript/shell 的反模式前后对比,以及钩子与 CI 集成方式。

适用场景:改动超过 20 行的非平凡实现、不完全理解的代码、需求不清的多步任务、会被人工审查的代码。琐碎任务(错别字、显而易见的一行改动)可自行判断放宽。跨工具使用时,Claude Code 通过插件安装并自动加载 CLAUDE.md,其他工具需把原则复制进其模式文件(Codex CLI、Cursor、Antigravity/OpenCode/Gemini CLI 使用 AGENTS.md 或 .cursorrules)。相关技能包括 self-eval、code-reviewer、llm-wiki。具体安装命令与详细价格、平台支持等事实资料暂未提供。