SuperAPI AI 工具集

karpathy-agentic-guidelines-full

智能体与模型

查看项目

更新于 10-16 05:42

技能介绍

用途:这是一份严格的、面向工作流的智能体编码指导,基于“用英文编程、让智能体执行大动作”的现实,强调获得智能体耐力与循环能力收益的同时,控制假设错误、过度复杂化、谄媚、无关编辑、死代码和隐蔽的概念错误。核心原则是:让智能体负责生成与迭代,人类保留对意图、真值、审查和发布决策的权威。

适用时机:任务足够大、智能体能循环推进有用;模型可能默默做出错误假设;成功标准比实现路径更容易定义;希望改动后代码库仍可理解;需要委派或运行多个会话并有稳定控制面。不适用:任务琐碎、直接做更快;纯探索且尚无有效验证面;主要问题是缺少产品方向而非执行质量。

主要能力与要点:

  1. 按结果而非按键编程:优先给成功标准、不变量、边界和明确非目标,不要过度指定路径。
  2. 让假设变昂贵:要求智能体暴露关键假设、命名不清晰输入、指出冲突证据,并在请求形态风险更高时提出反对。
  3. 保持人类审查面:保留 IDE、diff 或文件审查界面,直接检查改动文件,确认每行改动都能追溯到请求,关注概念错误而非仅编译测试通过。
  4. 轻量规划胜于盲目推进:多步工作用简短计划,每步显式验证,任务切片,必要时新开上下文窗口或会话。

决策模式:选择能保持清晰与验证的最轻执行模式,包括直接执行、声明式计划、任务切片计划、受监督委派,不要默认最大仪式感或最大自主权。默认优先于菜单:给出默认方案并解释原因,替代方案只作为逃生通道;若任务提供精确输出契约、必需标题或固定模式,必须原样重现。

限制与约束:默认采用最简单可行构造,避免膨胀的抽象、API、间接层、回退路径和辅助层;把无关编辑视为回归,不允许无关重构、注释与风格扰动、删除正交代码或既有死代码(除非被要求);用测试和工具作为循环锚点,如失败测试、可复现 bug、浏览器或运行时检查、显式输出契约、diff 约束;对探索或优化工作冻结夹具、缩小可编辑面,固定评估器与度量;迭代前先建立基线,避免凭感觉优化;采用保留或丢弃循环,基于指标、正确性、复杂度和附带风险决策。

自主权控制:使用有界自主权,任务限定范围、明确权限边界、可见验证、清晰升级点;不让任何会话成为隐藏的规划权威、真值来源、回退通道或发布决策者。权限划分:智能体可生成代码、运行有界检查、朝已声明成功标准迭代、暴露权衡与阻塞;监督人类或控制者保留意图等更高权威。