用途
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 索引文件,仅对已建立索引的会话生效;搜索为子串匹配,不支持复杂查询语法;其他功能细节暂未提供。