SuperAPI AI 工具集

pull-search

通用与其它

查看项目

更新于 10-23 23:07

技能介绍

用途

pull-search 是 CocoPull 会话归档的搜索技能,目标是在 CocoPlus 项目的历史会话记录中查找相关的过往会话,便于回顾此前的构建、评审等工作内容。

前置检查

执行任何操作前,技能要求确认 .cocoplus/ 目录存在。如果不存在,输出“CocoPlus is not initialized. Run $pod init first.”并停止。

主要能力

重建索引

当开发者调用 $pull index rebuild 时,技能调用 cocopull/session-indexer --rebuild 重建索引,并报告已索引的会话记录数量,随后停止。

会话搜索

搜索命令为 $pull search "<query>",查询字符串为必填项,需放在引号中。支持两个可选过滤参数:

  • --since <date>:按日期过滤,格式为 YYYY-MM-DD,时间戳大于等于该日期;
  • --feature <name>:按功能名过滤,例如 cocoharvest、safety-gate。

两个过滤条件之间为 AND 逻辑。

若未提供查询字符串,技能会询问用户想搜索什么,并给出示例。

使用方式

技能读取 .cocoplus/index/sessions.jsonl 索引文件。若文件缺失或为空,会提示未找到会话归档,说明会话在结束时自动索引,并建议在新项目中完成若干会话后运行 $pull index rebuild。

搜索对以下字段做不区分大小写的子串匹配:summary(摘要)、features_used(使用的功能数组值)、archetype(原型)。命中后按时间戳降序排列。

输出格式

结果以表格形式列出会话 ID、日期、原型、时长和功能,并附上首个命中会话的摘要片段。若无匹配,提示没有会话符合条件,建议使用更宽泛的搜索词或更宽的日期范围。

验收标准

索引重建需调用 cocopull/session-indexer --rebuild 并报告数量;搜索需在摘要、功能和原型上命中;--since 与 --feature 过滤需正确按 AND 逻辑生效;结果需展示会话 ID、日期、原型、时长、功能和摘要片段。

限制

技能依赖 .cocoplus/index/sessions.jsonl 索引文件,仅对已建立索引的会话生效;搜索为子串匹配,不支持复杂查询语法;其他功能细节暂未提供。