SuperAPI AI 工具集

cursor-principle-encode-lessons-in-structure

通用与其它

查看项目

更新于 10-16 08:48

技能介绍

用途:当发现自己在第二次写同一条指令,或注意到反复出现的纠正时,把该规则编码进机制而非文字说明。文字指令需要读者注意、记住并遵守,容易被忽略;结构性机制(lint 规则、元数据标记、运行时检查、自动化脚本)无需配合即可强制执行。

主要能力与模式:若同一指令出现第二次,先问它能否变成 lint 规则、元数据标记、运行时检查或脚本;能则编码并删除该指令。若不能(需要判断),则把指令写得更醒目,并补充失败模式示例。多种机制都可行时选最强的一种:优先让非法状态无法编译,其次是使 CI 失败的 lint 或禁用 API,然后是规范化的 helper,最后才是运行时检查。因为智能体会模仿周围代码已有的写法,较弱的防护会成为下一个模板。推论:若修复是结构性的,就只用结构性修复,指令本身只是症状。

反馈回路:捕获每一次纠正,当人工介入或测试失败时判断是一次性还是模式;路由到正确层级——一次性写入 brain note,反复出现的修复做成技能或 lint 规则,系统性问题上升为原则;最后闭环,不只记录,要么立即应用,要么创建具体待办。

反模式:只口头承认而不记录(“我会记住”不会持久化);只记录而不路由(关于本应存在的 lint 规则的 brain note,在规则落地前是浪费);只修个案而不泛化(修好一个实例却留下反复出现的模式)。

限制:本页为原则性说明,未提供具体安装命令、代码或工具配置;适用判断依赖具体项目环境。