SuperAPI AI 工具集

cup-history

编程与开发

查看项目

更新于 10-23 23:07

技能介绍

用途

cup-history 用于展示最近的 CocoCupper 分析发现。CocoCupper 是 CocoPlus 中的分析组件,其发现记录保存在 .cocoplus/grove/cupper-findings.md 中。该技能帮助开发者快速回顾近期分析结果,并查看自动捕获的修正记录。

主要能力

  1. 读取并展示最近 N 条 CocoCupper 发现,N 默认为 5。
  2. 以摘要表格输出每条发现,包含 ID、Title、Type、Severity、Date、Promoted 六列。
  3. 在表格下方展示最近一条发现的完整文本。
  4. 读取 .cocoplus/cupper/auto-captured.json(若存在),展示自动捕获的修正记录,并对每条记录进行路由分类:incorrect-behavior(修正反转或否定了刚执行的操作)、missing-variant(修正要求一个不存在的选项或模式)、agent-misapplication(修正表明某个技能或角色在错误上下文中被调用)。
  5. 输出页脚,显示发现总数与自动捕获修正数量,并提示使用 $patterns promote [finding-id] 将发现提升到模式库,使用 $wisdom route 将自动捕获的修正路由到技能编辑。

使用方式

命令格式:$cup history [n],其中 n 默认为 5。

执行前会验证 .cocoplus/ 是否存在。若不存在,输出 "CocoPlus not initialized in this directory. Run $pod init to begin." 并停止。

若 .cocoplus/grove/cupper-findings.md 不存在或为空,输出 "No CocoCupper findings yet. Run $cup to trigger an analysis." 并停止。

每条发现以 ## Finding 开头,技能提取最后 N 条。

自动捕获修正的检测通过 UserPromptSubmit 钩子在每次开发者提示时静默请求,向 .cocoplus/v2-runtime-requests.jsonl 追加 cococupper/cupper-capture 请求(Tier 1,无 LLM,耗时小于 50ms)。V2 原生捕获路径将匹配项追加到 .cocoplus/cupper/auto-captured.json。

适用场景

适用于已初始化 CocoPlus 的项目,开发者需要回顾近期 CocoCupper 分析发现、查看自动捕获的修正记录,或准备将发现提升到模式库、将修正路由到技能编辑时。

限制

  • 必须已初始化 CocoPlus(.cocoplus/ 存在),否则无法使用。
  • 若发现文件不存在或为空,则无内容可展示。
  • N 参数限制用于防止在长期项目中输出过多内容。
  • 自动捕获修正仅在 auto-captured.json 存在时展示。
  • 关于收费、价格、平台支持等具体信息暂未提供。