Karpathy 编程准则
通过明确假设、保持简单和验证目标,减少代码代理的误解与过度改动。
内容是低权限的编码行为建议,不请求工具、凭据、数据访问或外部副作用;但未定义适用时的用户确认、回滚、敏感数据处理或数据流边界,且发布者未验证,因此未满分。
SKILL.md 的四项原则彼此一致、无依赖且可直接阅读使用;但没有测试、执行示例、异常输入处理或失败反馈机制,静态评估按上限限制扣分。
明确面向编写、审查和重构代码,并覆盖澄清、简化、局部修改和验证目标;但触发条件、非适用范围和环境兼容性不够具体,SKILL.md 也未提供中文指导,因此扣分。
名称、描述和正文基本一致,含 MIT 许可证、分层章节和示例计划;但缺少版本、变更记录、维护责任人、更新路径及更完整的安装和故障排查说明,因此扣分。
原则和示例可直接指导减少过度设计、无关改动和未验证实现,核心价值合理;但没有代表性输出、用户结果或对比验证,且仍需模型自行解释和执行,因此按静态上限给分。
README 提供了可审计的原则说明、引用和预期改进指标,但主要是作者陈述,没有测试套件、CI 或独立复现证据;静态评估最多给予有限分数。
- 这是行为指导而非可执行测试或质量门禁;不要把其成功指标视为已验证结果。
- 安装说明依赖 GitHub、Claude Code、Cursor 和 curl 等外部环境,未在本次静态审查中验证可达性或兼容性。
- 发布者身份未被 FollowSkills 企业注册表验证,来源和维护连续性仍需人工确认。
这个 Skill 能做什么,适合哪些场景?
这是一个面向 Claude Code 的单文件行为指南,源自 Andrej Karpathy 对大语言模型编程问题的观察。它围绕先思考、优先简单、外科式修改和目标驱动执行四项原则组织。指南要求代理显式说明假设、避免无关重构,并用测试或其他可验证标准确认结果。README 还说明项目包含 Cursor 规则。
它向 Claude Code 提供关于代码任务的行为约束:在实现前说明假设和歧义,优先采用解决问题所需的最少代码,只修改与请求直接相关的内容,并将任务转化为带验证步骤的目标。安装方式包括将 CLAUDE.md 下载或追加到项目中,或通过 Claude Code 插件命令安装;README 还提供了 Cursor 规则说明。
- 希望减少代码代理擅自猜测需求的团队,可将指南加入项目级 CLAUDE.md。
- 经常遇到过度工程化和无关重构的开发者,可用它约束非必要抽象与旁支修改。
- 修复需要回归验证的缺陷时,可要求代理先编写复现测试,再实现修复。
- 使用 Cursor 的开发者,可参考仓库提供的 karpathy-guidelines.mdc 规则。
- 维护已有代码库的团队,可用外科式修改原则限制改动范围。
这个 Skill 有哪些优点和局限?
- 明确覆盖需求误解、过度设计、无关改动和缺乏验证四类常见问题。
- 强调只修改与用户请求直接相关的代码,适合已有代码库。
- 提供测试优先和可验证成功标准,便于检查任务是否完成。
- 支持项目级 CLAUDE.md,并说明了 Claude Code 插件和 Cursor 使用方式。
- 内容是行为指南,不是功能型工具;不会自动提供具体代码能力或测试框架。
- README 标注的仓库地址与安装命令中的 GitHub 用户名不一致,安装流程需要核对。
- 未提供 SKILL.md、技能路径或测试套件,无法确认标准 Agent Skills 打包细节。
- 指南明确偏向谨慎而非速度,简单任务仍需使用者自行判断是否适用。
如何安装这个 Skill?
README 提供两种方式。插件方式:在 Claude Code 中执行 /plugin marketplace add forrestchang/andrej-karpathy-skills,然后执行 /plugin install andrej-karpathy-skills@karpathy-skills。项目级方式:新项目执行 curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md;已有项目先执行 echo "" >> CLAUDE.md,再执行 curl https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md >> CLAUDE.md。注意:给定仓库地址是 multica-ai/andrej-karpathy-skills,而 README 命令使用 forrestchang,实际适用性未由所给材料确认。
如何使用这个 Skill?
将指南作为项目级 CLAUDE.md 或 Claude Code 插件配置后,直接提出编码任务,并要求代理说明假设、列出简短计划和验证标准。例如:先写一个能复现无效输入问题的测试,再修复实现并运行测试。具体触发语法未提供。
这个 Skill 与同类方案有什么区别?
README 明确提到 Claude Code 插件、项目级 CLAUDE.md 和 Cursor 规则三种使用方式,但未提供与其他独立技能或产品的功能对比。