CocoObserver 是 CocoPlus 体系中的只读观测技能，官方定位为"eyes-only"，用于观察 CocoPlus 技能而不修改它们，为 CocoBrew 的改进与简化提供信号。
用途 运行 CocoObserver 技能的观测循环，围绕 CocoBrew 的改进与简化收集信号。它读取技能文件、hooks、文档和校验输出，从中识别：改进机会、简化机会、适用于多个技能的跨领域原则，以及开源/内部边界风险。它从不编辑文件；CocoBrew 只在操作者批准拟议目标后才执行更改。
主要检测信号
- 技能发现：当同一技能类别匹配三个或以上会话信号时，追加发现记录，而不立即给出建议；CocoPilot 之后可选择一个发现来呈现。
- 收敛检测：当同一方法被反复重试且收益递减时，输出"发散"建议，并建议切换到 Snowflake 视角（FinOps、SRE/值班、数据治理或数据消费者）。
- 脚本优先缺口：如果确定性的子任务通过提示词叙述来处理，建议将其迁移到 scripts/ 目录。
- 引用加载缺口：如果深层领域知识直接嵌入 SKILL.md，建议迁移到 references/ 并按需加载。
- 市场就绪度：对可分发的 CocoPods 检查显式权限、评估、失败行为、安装时执行和网络使用理由。
输出
- .cocoplus/skills/observations.jsonl：仅追加的观测记录，包含文件、信号类型、证据和建议。
- .cocoplus/skills/cross-cutting-principles.md：提议的清单条目，未来创建或修改技能时必须查阅。
- .cocoplus/session/discoveries.jsonl：技能匹配与收敛信号，供 CocoPilot 使用。
退出标准 每条观测都引用实际读取的文件；简化信号作为一等发现对待；确定性工作建议以脚本形式完成而非 token 生成；收敛发现建议隔离式发散而非同一框架下的再次重试；公开技能不会获得私有实现细节。
反合理化说明 资料列出两类常见捷径及失败原因：其一，因为文件存在就认为技能完整——技能契约必须描述可观察行为和验证方式，而不只是命令名称；其二，因为命令小就跳过产物与安全检查——小命令仍会改变状态或引导执行，应保留同样的关卡。具体运行命令、安装方式、收费与平台支持情况暂未提供。