用途 CocoWisdom 面向使用 CocoPlus 的项目,提供项目质量记忆的状态摘要与维护命令。它帮助开发者查看质量门拒绝历史,以及已收录的经验、拒绝方案和纠错记录。
前置检查 使用前需确认项目内存在 .cocoplus/ 目录。若不存在,应输出“CocoPlus is not initialized. Run $pod init first.”并停止。
主要能力
- 拒绝历史摘要:读取 .cocoplus/wisdom/rejections.jsonl,计算总记录数(排除 retraction 类型)、按质量门(secondeye、sentinel、da_critic)计数、按维度计数、最常触发的质量门、最常被拦截的维度、最近一条记录,以及近 8 个不同 session_id 的拒绝情况。若近 8 个会话无拒绝则趋势为 Improving,否则为 Active。文件不存在或为空时输出无记录提示。
- 命令集:$wisdom reject 记录被拒绝的方案;$wisdom index 构建会话日志词法召回索引,可指定 --harness;$wisdom recall 搜索精选经验与索引;$wisdom learnings 列出经验与拒绝记录,可过滤;$wisdom learn 记录人工精选经验,可注明会话与原因;$wisdom get 按主题加载渐进披露的正面经验。
- 负向记忆:do-not-use.md 中的拒绝方案具有通用性,应先于正面经验加载,不得自动清理,也不得并入正面经验分类文件。
- 纠错路由($wisdom route):读取 .cocoplus/cupper/auto-captured.json 中带 skill_context 的条目,按技能文件分组,将每组分类为 incorrect-behavior、missing-variant 或 agent-misapplication,并生成建议的技能文件修改。分类可能需要调用 Haiku。所有修改必须经开发者明确确认后才会应用,不会自动应用。
- 保留与遗忘:$wisdom keep 将受保护规则写入 must-keep.md,不作为自动整合候选;$wisdom forget 必须在 consolidation-log.md 记录理由,缺少理由会被拒绝。
使用方式 通过 $wisdom 系列命令调用;纠错路由通过 invoke cocowisdom/wisdom-route 触发,支持 --keep、--forget、--candidate 参数。正面经验采用清单优先方式,加载前需阅读 .cocoplus/wisdom/SCHEMA.md 的阶段映射,只加载当前阶段角色映射的主题,其余保持渐进披露。
证据与密度规则 稳定提升默认要求至少 3 个不同且已确认的会话,可在 cocoplus.toml 的 [wisdom].min_evidence_sessions 中配置。整合候选若只增加字数而未减少条目数会被拒绝,除非记录合理例外。
限制与说明 趋势判断需要 8 个不同会话;读取大文件时不可截断,否则计数错误。纠正数量多不构成跳过开发者确认的理由。单一偶发事件不足以提升为稳定记忆。摘要需在仅 1 条记录时也能正确显示。