SuperAPI AI 工具集

cocolean

编程与开发

查看项目

更新于 10-23 23:07

技能介绍

CocoLean 是 CocoPlus 项目中的一项技能,定位为“最小可行 Cortex 表面纪律”。它的核心目标是在开发者编写任何新的 Cortex AI 函数、流水线阶段或子代理之前,先通过一个结构化的决策阶梯来评估是否真的需要 AI 推理,从而避免不必要的复杂性和抽象。

用途 CocoLean 用于在构建阶段之前进行决策把关。它要求开发者从最便宜、最简单的方案开始逐层检查,直到找到第一个可行的“是”为止。这有助于减少过度工程,确保只有在确实需要 AI 推理时才引入 Cortex 功能。

主要能力 该技能提供三种强度模式:

  • lite 模式:仅激活决策阶梯。
  • full 模式:激活全部三种 CocoLean 模式(决策阶梯、审查、债务管理)。
  • ultra 模式:在 full 模式基础上增加强制执行,例如当跳过第一层决策时要求提供明确理由。

技能通过 $lean、$lean lite、$lean full、$lean ultra 等命令调用。调用后,它会先验证 .cocoplus/ 目录是否存在,若不存在则提示先运行 $pod init。随后,它会将模式字符串写入 .cocoplus/modes/lean.mode 文件,并展示六层决策阶梯。

决策阶梯包含以下六层:

  1. 能否用确定性规则、SQL 表达式、查找表或阈值完成,而无需 AI 推理?
  2. Snowflake 原生内置功能是否已能处理?(如 FLATTEN、MATCH_RECOGNIZE、窗口函数、条件表达式、SEARCH、OBJECT_CONSTRUCT 等)
  3. 项目中是否已有 UDF、存储过程或 Cortex 函数可以解决?
  4. 单次 AI_COMPLETE 调用配合精心限定的提示是否足够?
  5. 最小可行函数能否在十行以内写完?
  6. 完整的 Cortex 函数或多阶段流水线是否合理?

根据开发者选择的层级,技能会给出相应回应:对于第 1-3 层,建议更便宜的替代方案,不继续构建;第 4 层建议先构建提示并在至少 10 个标注样本上评估;第 5 层建议先写最小版本并评估;第 6 层在 lite 或 full 模式下允许继续构建,但在 ultra 模式下,如果第 1 层被质疑,则要求提供明确理由。

使用方式 开发者通过 $lean 系列命令调用该技能。技能会解析调用命令,确定模式,写入模式文件,并展示决策阶梯。开发者需要回答“这个任务落在哪一层?”,然后技能根据回答给出下一步指导。

适用场景 CocoLean 适用于使用 Snowflake Cortex 进行 AI 功能开发的团队,特别是在需要控制复杂性和避免过度工程的场景中。它适合在编写新函数、流水线或子代理之前使用,帮助团队做出更明智的构建决策。

限制 该技能要求 .cocoplus/ 目录已初始化,否则无法使用。它不适用于某些不可简化的例外项,如信任边界实现、数据丢失防护机制、安全控制、合规要求、防止静默数据损坏的错误处理,以及开发者明确要求的能力。这些例外项始终豁免于决策阶梯。此外,ultra 模式的强制执行需要开发者主动设置并遵守。