SuperAPI AI 工具集

karpathy-guidelines

编程与开发

查看项目

更新于 10-15 16:48

技能介绍

用途:这是一套面向 LLM 辅助编程的行为护栏,适用于 Claude Code 项目中的代码生成、编辑、审查、重构与修 bug 等非平凡任务。其取向偏保守,宁可谨慎也不追求速度。

主要能力(四条原则):

  1. 先思考再写码:实现前说明假设,若假设关键且不确定就提问;若请求有多种合理解释,列出而非默默选一个;若有更简单方案,说明取舍;确实不清楚时停下来,具体指出不清楚之处再问。
  2. 简单优先:只写解决既定问题所需的最少代码,不加未要求的功能,只有一个调用点时不引入抽象,不凭猜测加配置项或扩展点,不为不可能发生的路径加错误处理;若初稿 200 行而 50 行够用,先重写。
  3. 外科手术式改动:只碰任务需要的部分,不顺手重构相邻代码、注释或格式,不重构能正常工作的代码,遵循周围代码风格;发现无关死代码或 bug 应在回复中指出而非静默删除或修复;自己改动产生的孤立导入、变量、辅助函数要清理,但既有死代码除非明确要求否则不动。判断标准是每一行改动都能追溯到用户请求。
  4. 目标驱动执行:把任务转成可验证目标并迭代至通过。例如“加校验”先写失败测试再让其通过;“修 bug”先写复现测试;“重构 X”先确认现有测试通过,重构后再确认仍通过。多步任务内联写出计划与每步验证方式。

使用方式:在 ClaudeForge 中,斜杠命令 /enhance-claude-md 会向生成或增强的 CLAUDE.md 注入 ## Behavioral Guidelines 段落,概述这四条原则并链接回本技能;claude-md-guardian 代理在自动维护更新中保留该段落;skill/generator.py 与 skill/template_selector.py 无条件插入该段落,这些原则并非可选。

适用场景:任何需要 LLM 写、改、审、重构代码的项目,尤其希望控制改动范围与复杂度的团队。

限制:资料未提供具体安装命令、收费与价格信息;效果指标为定性描述(diff 变小、因过度复杂导致的返工减少、澄清问题出现在实现之前)。