📦 Karpathy

v1.0.0

基于 Andrej Karpathy 观察的编码指南。用于编写、审查或重构代码时,避免过度复杂化、进行精准修改、表面化假设,并定义可验证的成功标准。

0· 11·0 当前·0 累计
下载技能包
最后更新
2026/4/21
0
安全扫描
VirusTotal
无害
查看报告
OpenClaw
安全
high confidence
这是一个仅提供指令的编码规范技能,其请求的资源与指令均与其声明目的保持一致。
评估建议
此技能是一套简洁的编码与审查指南,内部逻辑一致。安装前,请决定是否允许自主代理 (a) 写入项目文件(如 references/learnings.md)以及 (b) 触发其他技能(如 'self-improving-agent')。若不希望这些行为,务必通过代理策略或提示词阻止自动写文件或跨技能调用。除此之外,该技能安全且与其声明目标相符。
详细分析 ▾
用途与能力
名称/描述与内容相符:该技能是一份用于编写/审查代码的散文式指南。它不会索取与此目的无关的凭据、二进制文件或配置路径。
指令范围
SKILL.md 仅包含编码、审查与验证的行为准则。其中提到可选项:触发“self-improving-agent”进行任务后反思,并更新仓库文件“references/learnings.md”。这些属于开发者工作流范畴,但属于代理可执行的外部操作,因此用户需确认是否允许代理写入项目文件或调用其他技能。
安装机制
无安装规范、无代码文件——此技能不会向磁盘写入任何二进制文件或下载内容。
凭证需求
该技能无需环境变量、凭据或配置文件路径。任何内容均未显得与指导文档不符。
持久化与权限
始终为 false,允许模型调用(平台默认)。该 skill 不请求常驻权限,也不进行 agent 级变更。
安全有层次,运行前请审查代码。

运行时依赖

无特殊依赖

版本

latestv1.0.02026/4/21

初始版本 - 受 Andrej Karpathy 启发的编程规范

无害

安装命令

点击复制
官方npx clawhub@latest install karpathy-guidelines
镜像加速npx clawhub@latest install karpathy-guidelines --registry https://cn.longxiaskill.com

技能文档

源自 Andrej Karpathy 的观察,用于减少 LLM 编码常见错误的行为指南。

权衡: 这些指南偏向谨慎而非速度。对于简单任务,使用判断力。

1. 编码前思考 (Think Before Coding)

不要假设。不要隐藏困惑。表面化权衡。 在实现之前:
  • 明确陈述你的假设。如果不确定,请问。
  • 如果存在多种解释,呈现它们——不要静默选择。
  • 如果存在更简单的方法,说出来。在合理的情况下 push back。
  • 如果某事不清楚,停下来。说出困惑所在。请澄清。

2. 简单优先 (Simplicity First)

解决问题所需的最小代码。没有投机性代码。
  • 不要添加超出要求的特性。
  • 不要为单一用途代码创建抽象。
  • 不要添加未被要求的“灵活性”或“可配置性”。
  • 不要为不可能的场景添加错误处理。
  • 如果你能写 50 行但写了 200 行,重写。

问自己:“高级工程师会说这过度复杂吗?”如果是的,简化。

3. 精准修改 (Surgical Changes)

只触碰必须触碰的。只清理你自己的烂摊子。 编辑现有代码时:
  • 不要“改进”相邻代码、注释或格式。
  • 不要重构没有坏的部分。
  • 匹配现有风格,即使你会有所不同。
  • 如果你注意到无关的死代码,提出来——不要删除。

当你的更改造成孤立内容时:

  • 删除因你的更改而未使用的导入/变量/函数。
  • 除非被要求,否则不要删除预先存在的死代码。

验证标准:每一行更改都应该可以直接追溯到用户的请求。

4. 目标驱动执行 (Goal-Driven Execution)

定义成功标准。循环验证直到达成。 将任务转化为可验证的目标:
  • “添加验证” → “为无效输入编写测试,然后让它们通过”
  • “修复 bug” → “编写一个复现它的测试,然后让测试通过”
  • “重构 X” → “确保之前和之后测试都通过”

对于多步骤任务,简述计划: ``

  • [步骤] → 验证: [检查]
  • [步骤] → 验证: [检查]
  • [步骤] → 验证: [检查]
`

强有力的成功标准让你能够独立循环。弱标准(“让它工作”)需要持续澄清。

激活时机

在以下情况下自动激活:
  • 编写新代码时
  • 审查或重构现有代码时
  • 面对复杂决策时
  • 用户要求“检查代码质量”或“审查”时

与自我改进 Agent 的协作

当完成编码任务后,可以触发 self-improving-agent 进行反思:
  • 决策是否合理?
  • 是否有更简单的方案?
  • 学到了什么?

更新 references/learnings.md` 记录经验教训。

--- 最小化代码,最大化效果。

数据来源ClawHub ↗ · 中文优化:龙虾技能库