SuperAPI AI 工具集

patterns-promote

编程与开发

查看项目

更新于 10-23 23:06

技能介绍

用途

patterns-promote 用于在 CocoPlus 工作流中,把 CocoCupper 捕获到的单个 finding 提升为 CocoGrove 模式库中的可复用模式,使一次性的问题修复沉淀为面向多项目的权威实践。

主要能力

  • 前置校验:检查当前目录是否存在 .cocoplus/;若不存在则提示运行 $pod init 后终止。
  • 查找 finding:从 .cocoplus/grove/cupper-findings.md 中按 ID 定位目标 finding 并完整展示;找不到时提示用 $cup history 查看可用 finding。
  • 提升评分:按三个维度各 0–3 分评估——Durability(0 一次性修复至 3 架构事实)、Impact(0 仅供参考至 3 防止故障)、Scope(0 单文件至 3 同类型所有 CocoPod)。总分 ≥6 建议提升,4–5 进入观察,≤3 忽略;任一维度为 3 分即为强候选,即使总分偏低也须人工复核后再降级。确认提升前会展示评分摘要与决策结果。
  • 文本蒸馏:写入前必须执行三条强制改写规则——描述式改指令式、冗长改两句以内、条件化/模糊措辞改为明确条件或删除;未通过蒸馏的模式即使评分达标也会被拒绝提升。
  • 交互录入:依次询问是否提升(yes/no)、kebab-case 模式名、所属域(如 sql、data-modeling、testing)和逗号分隔标签。
  • 生成模式文件:以 pat-YYYYMMDD-NNN 为 ID,写入 .cocoplus/grove/patterns/[pattern-name].md,包含 YAML frontmatter(id、name、domain、tags、promoted_from、promoted_at)以及 Summary、Context、Pattern、Anti-Pattern 四个正文小节。
  • 回写来源:把 cupper-findings.md 中该 finding 的 Promoted: false 改为 Promoted: [pattern-id],避免同一 finding 被重复提升。

使用方式

命令形式为 $patterns promote [finding-id],例如 $patterns promote Finding-001;省略 finding-id 时输出用法提示并终止。整个流程为交互式:先展示 finding 与评分,再请求确认及元数据,最后生成文件并输出提升结果与 $patterns view 提示。

适用场景

适用于团队希望把 CocoCupper 在具体项目中发现的修复或经验标准化、长期复用,并纳入 CocoGrove 模式库统一管理的场景;也适合在评审周期内对候选 finding 做量化取舍。

限制

必须已在目标目录初始化 CocoPlus 且存在相应 finding 文件;提升须由开发者明确确认,不能自动提升;模式名、域和标签需人工输入;评分阈值、蒸馏规则与文件格式均由该技能规定,不符合规则的内容会被拒绝写入;评分维度的具体判定依据来自流程定义。