mcpField
C
cortex-skills-loop

cortex-skills-loop

github.com/nickcrewAgent 工作流6261 次安装17 周前更新
代码仓库

关于 cortex-skills-loop

cortex-skills-loop 为使用 cortex CLI 的 Agent 提供技能推荐、反馈和评分流程。它依据上下文变化触发推荐,并将互动写入 SQLite 学习数据库以改进后续建议。

主要功能

  1. 01上下文变化时推荐技能
  2. 02按置信度整理推荐
  3. 03记录推荐反馈与评论
  4. 04为技能贡献评分
  5. 05支持多种推荐策略

适用场景

  1. 01工作转向新领域时查找技能
  2. 02完成任务后评价技能效果
  3. 03推荐不合适时提交反馈

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/nickcrew/claude-cortex --skill cortex-skills-loop

安装后在 Claude Code 中输入/cortex-skills-loop确认已加载。

详细介绍

Cortex Skills Loop

概述

cortex CLI 包含一个 AI 驱动的推荐引擎,可从使用模式中学习。本技能定义了参与该学习循环的工作流:在上下文发生变化时获取推荐,对推荐质量提供反馈,并在使用技能后为其评分。每次互动都会改进后续推荐。

何时参与

触发推荐的信号

出现以下任一不匹配信号时,运行 cortex skills recommend:

  • 文件模式变化 — git diff 或工作集包含当前已激活技能未覆盖的文件类型(例如,出现 .tf Terraform 文件,但未激活基础设施技能;或者触及 **/auth/** 路径,却未加载安全技能)
  • Agent 激活状态变化 — 激活了一个新 Agent,而它可能有尚未加载的互补技能(推荐器会在内部将 Agent 映射到技能集)
  • 明确的领域切换 — 用户将重点切换到其他领域(“现在来处理数据库迁移”),而当前技能集面向的是其他领域
  • 感到技能不足 — 任务需要某项当前未激活技能覆盖的领域知识,或者某项已激活技能对当前工作毫无帮助
触发评分/反馈的信号
  • 任务完成 — 刚刚成功完成的工作中曾激活某项技能
  • 采纳推荐 — 最近采纳或忽略了一项推荐
  • 负面体验 — 某项技能主动误导了用户,或提供了无用的指导
何时不参与

不要在每次会话开始时都运行推荐,也不要在当前技能集显然适用的常规任务中运行推荐。只有选择性地根据明确信号使用,该循环才能发挥价值。

工作流

1. 推荐 — 显示相关技能

检测到上下文变化时,运行:

cortex skills recommend

此命令会分析当前 git 状态、已激活的 Agent 和历史模式,并按置信度等级推荐技能:

  • 高置信度(>=0.8): 自动激活候选项 — 可考虑立即激活
  • 中置信度(0.6-0.8): 值得与用户一起审核
  • 低置信度(<0.6): 仅供参考

在根据推荐采取行动之前,可先检查当前已激活的技能:

cortex status

完整选项详情:cortex skills recommend --help

2. 反馈 — 提升推荐质量

采纳或忽略推荐后,记录其是否有用:

cortex skills feedback <skill-name> helpful --comment "Caught auth vulnerability early"
cortex skills feedback <skill-name> not-helpful --comment "Not relevant to this API work"

在提供上下文的情况下给出正面反馈,可以教会推荐器在未来会话中将当前项目上下文与该技能关联起来。尽可能始终提供 --comment,以丰富学习信号。

完整选项详情:cortex skills feedback --help

3. 评分 — 记录技能效果

任务完成后,如果工作期间激活过某项技能,请为其贡献评分:

cortex skills rate <skill-name> --stars <1-5> --review "Description of experience"

可使用其他标志丰富信号:

  • --helpful / --not-helpful — 二元有用性指标
  • --succeeded / --failed — 该技能支持的任务是否成功

评分会反馈给推荐引擎。高评分技能会在未来推荐中优先显示;低评分技能则会降低优先级。

添加评分前,查看现有评分:cortex skills ratings <skill-name>

查看表现最佳的技能:cortex skills top-rated

完整选项详情:cortex skills rate --help

完成闭环

推荐-反馈-评分的循环是累积式的。每次交互都会更新由 SQLite 驱动的 学习数据库,改进四种推荐策略:

  1. 语义相似度 — 嵌入成功会话的上下文,供后续匹配使用
  2. 基于规则 — 将文件模式与技能建议进行匹配
  3. 基于 Agent — 将活跃 Agent 映射到互补技能
  4. 基于模式 — 优先推荐历史成功率高的技能

当多种策略指向同一技能时,其置信度会提高。持续提供反馈和评分,才能让这种趋同随时间发生。

快速参考

操作命令
获取推荐cortex skills recommend
查看当前状态cortex status
提供正面反馈cortex skills feedback <skill> helpful --comment "..."
提供负面反馈cortex skills feedback <skill> not-helpful --comment "..."
为技能评分(1-5 星)cortex skills rate <skill> --stars N --review "..."
查看技能评分cortex skills ratings <skill>
查看评分最高的技能cortex skills top-rated
查看使用分析cortex skills analytics

评论

支持 Markdown