patterns-view 是 CocoPlus 生态中面向 CocoGrove 模式库的查看技能,用途是列出模式库中的模式清单。
使用前,技能会先验证当前目录是否存在 .cocoplus/。如果不存在,输出“CocoPlus not initialized in this directory. Run $pod init to begin.”并停止。
主要能力:列出 .cocoplus/grove/patterns/ 下所有 .md 文件;读取每个文件的 YAML frontmatter,提取 name、domain、tags、summary;输出 # CocoGrove Pattern Library 表格,列为 Pattern、Domain、Tags、Summary,每行对应一个模式;底部显示模式总数,并提示可在提示词中通过 .cocoplus/grove/patterns/[name].md 引用模式名。若目录为空,输出“No patterns in CocoGrove yet. Use $patterns promote [finding-id] to promote a CocoCupper finding.”并停止。
使用方式:命令形式为 $patterns view [tag],其中 [tag] 为可选标签过滤。若提供标签,仅包含 tags 中含该值的模式。技能还列出两条反合理化说明:仅按文件名列出而不读取 YAML frontmatter 无法得到 domain 与 tags;忽略标签过滤会失去该命令对大型模式库的主要价值。退出标准为:为每个匹配的模式文件输出含 Pattern、Domain、Tags、Summary 列的表格;若提供标签过滤则仅显示 tags 包含该值的模式;输出底部显示模式总数。
适用场景:需要浏览模式库、按标签筛选模式、获取模式文件引用路径时使用。限制:要求目录已初始化;仅处理 .md 文件与 YAML frontmatter;标签过滤为精确包含匹配。