用途
cup-history 用于展示最近的 CocoCupper 分析发现。CocoCupper 是 CocoPlus 中的分析组件,其发现记录保存在 .cocoplus/grove/cupper-findings.md 中。该技能帮助开发者快速回顾近期分析结果,并查看自动捕获的修正记录。
主要能力
- 读取并展示最近 N 条 CocoCupper 发现,N 默认为 5。
- 以摘要表格输出每条发现,包含 ID、Title、Type、Severity、Date、Promoted 六列。
- 在表格下方展示最近一条发现的完整文本。
- 读取 .cocoplus/cupper/auto-captured.json(若存在),展示自动捕获的修正记录,并对每条记录进行路由分类:incorrect-behavior(修正反转或否定了刚执行的操作)、missing-variant(修正要求一个不存在的选项或模式)、agent-misapplication(修正表明某个技能或角色在错误上下文中被调用)。
- 输出页脚,显示发现总数与自动捕获修正数量,并提示使用 $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 存在时展示。
- 关于收费、价格、平台支持等具体信息暂未提供。