关于 cortex-skills-loop
cortex-skills-loop 为使用 cortex CLI 的 Agent 提供技能推荐、反馈和评分流程。它依据上下文变化触发推荐,并将互动写入 SQLite 学习数据库以改进后续建议。
主要功能
- 01上下文变化时推荐技能
- 02按置信度整理推荐
- 03记录推荐反馈与评论
- 04为技能贡献评分
- 05支持多种推荐策略
适用场景
- 01工作转向新领域时查找技能
- 02完成任务后评价技能效果
- 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或工作集包含当前已激活技能未覆盖的文件类型(例如,出现.tfTerraform 文件,但未激活基础设施技能;或者触及**/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 驱动的 学习数据库,改进四种推荐策略:
- 语义相似度 — 嵌入成功会话的上下文,供后续匹配使用
- 基于规则 — 将文件模式与技能建议进行匹配
- 基于 Agent — 将活跃 Agent 映射到互补技能
- 基于模式 — 优先推荐历史成功率高的技能
当多种策略指向同一技能时,其置信度会提高。持续提供反馈和评分,才能让这种趋同随时间发生。
快速参考
| 操作 | 命令 |
|---|---|
| 获取推荐 | 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 |