SuperAPI AI 工具集

learn

编程与开发

查看项目

更新于 11-11 16:16

技能介绍

用途 learn 是 Todoist CLI 项目中的一条工作技能,用于从错误中学习:把一次纠正或反复出现的错误,转化为能有效阻止它再次发生的最强结构,并证明该结构确实能捕获这个错误。它适用于需要将口头提醒沉淀为可验证机制的开发流程。

主要能力与流程 该技能规定了一个五步流程。

第一步:命名错误。把错误写成一条可检验的描述,例如“a list command prints the id before the name”,而不是“小心列表输出”。完成标准是:原则上脚本能够检测出它。

第二步:选择能承载它的最强结构。按以下顺序取第一个可行的方案:编译器会拒绝的类型;.oxlintrc.json 中的 lint 规则;扫描代码或命令树的测试(例如 src/lib/root-options.test.ts,用于检查 cli-core 的 argv 扫描与 commander 是否一致);.agents/scripts/ 中的脚本检查(verify、hook);用于脚本无法做出的判断的 .agents/checks/ 评审检查;只有在以上都无法承载时,才在 AGENTS.md 或技能中写一行说明。如果某条规则已经写下来却仍被违反,则直接跳到第 1 至 4 项,完成标准是能说明为什么更强的方案不适用。

第三步:证明它能捕获错误。故意犯下该错误,新结构必须对它失败;移除错误后必须通过;运行 npm run verify。完成标准是两种情况都已亲眼看到。

第四步:删除被取代的内容。移除 AGENTS.md 或技能中因新检查而变得多余的说明行,并更新 docs/agents.md 中的规则表,记录规则、由什么承载以及确定程度。

第五步:独立提交。为这个新结构单独开一个小型 pull request,标题使用 chore: 或 test:,以免触发发布。完成标准是其 diff 只包含这一条规则。

使用方式 该技能以流程说明的形式给出,按步骤执行即可,涉及的命令为 npm run verify,涉及的文件包括 .oxlintrc.json、src/lib/root-options.test.ts、.agents/scripts/、.agents/checks/、AGENTS.md、docs/agents.md。

适用场景 适用于软件仓库中需要把纠正意见固化为类型、lint、测试或脚本检查的场合,尤其是希望避免同类错误重复发生的开发团队。

限制 资料仅给出流程描述,未说明该技能的具体安装方式、调用命令、适用平台或与 AI 工具的具体集成方式,这些信息暂未提供。