diary-search 是 snowflake-labs/cocoplus 提供的一个技能,目标是为 CocoDiary 日记提供检索能力。
用途 该技能用于搜索 CocoDiary 的日记条目。它支持按文本、标签、决策以及被引用的工件进行检索,帮助用户快速定位与查询相关的日记内容。
主要能力
- 提供命令 $diary search "<query>" [--since <date>],其中 <query> 为搜索关键词,--since <date> 为可选的时间过滤参数。
- 返回排序后的匹配结果,并附带来源路径。
- 提供足够的上下文以便交接,同时避免输出整篇日记条目。
使用方式 通过命令 $diary search "<query>" [--since <date>] 调用。技能契约要求描述可观察的行为和验证方式,而不仅仅是命令名称。
适用场景 适用于需要在 CocoDiary 中按文本、标签、决策或引用工件查找日记条目的场景,尤其适合需要快速获取匹配结果及来源路径、并用于后续交接的情况。
限制与约束
- 技能契约必须描述可观察的行为和验证,不能仅因文件存在就视为完成。
- 即使是小命令,也不能跳过工件和安全检查,因为小命令仍可能改变状态或引导执行,需保留相同的门禁。
- 退出标准包括:命令行为与所属功能契约一致;描述必需的读取、写入和用户可见输出;保留安全、治理和工件约束;缺失状态时产生清晰且非破坏性的结果。
其他信息 官方文本暂未提供。