用途
discuss 是 cocoplus 生命周期中的规划前技能,在 $plan 运行之前运行一次结构化对话,捕获实现决策并写入 lifecycle/discuss.md,避免规划智能体在开发者未察觉的情况下自行填补空白。该技能本身为可选,不运行不会阻断 $plan。
前置条件
- .cocoplus/ 目录已初始化(否则提示先运行 $pod init)
- .cocoplus/lifecycle/spec.md 已存在(否则提示先运行 $spec)
参数
- 无参数:标准决策向导
- --red-team:标准向导加对抗性质疑会话。该会话在标准向导以 PASS 分数(≥9)通过后触发,加载 .cortex/skills/cocodiscuss/discuss-red-team/SKILL.md,对 discuss.md 中每个决策进行非阻断的对抗性挑战,仅作参考,不阻断 $plan。
主要能力与使用方式
阶段一:读取 spec 并判定上下文
检查 .cocoplus/ 与 spec.md 是否存在;分析 spec.md 判断主要工作类型:AI 函数构建(涉及 AI_COMPLETE、AI_CLASSIFY、AI_EXTRACT 或类似 Cortex 函数)、Cortex Search(搜索服务配置或检索)、语义模型(分析工程师语义建模)、数据管道(ETL、转换或数据移动)。若存在 .cocoplus/context/approved-models.md、quality-thresholds.md、warehouse-policy.md,则读取以预填组织标准答案。
阶段二:结构化决策向导
按工作类型适配问题集,每个问题若 CocoContext 有确定答案则显示标准答案并请开发者确认(回车接受或输入覆盖),开放问题则等待开发者回答。AI 函数构建的标准问题:模型选择、评估方法与样本量(分类建议至少 50 个,抽取建议 100+)、准确率阈值、仓库分配、生产安全治理检查、显式范围边界。Cortex Search 构建将模型问题替换为嵌入模型,将准确率阈值替换为可接受的延迟阈值(如 <200ms)。语义模型构建将前三问替换为事实表、维度和主要指标,保留仓库、安全、范围三问。
阶段三:写入 discuss.md
将答案写入 .cocoplus/lifecycle/discuss.md,包含 discuss_date、discuss_phase: pre-plan、status: complete 元数据及模型、评估数据、准确率阈值、仓库、生产安全要求、范围边界各节,并创建 git 提交。
阶段四:CocoSpec 评分门
先运行 Cocobrew spec 校验器检查 spec.md 与 discuss.md,按 JSON 输出应用模糊用语扣分(最多 3 分);若技能契约缺失则警告并使用评分器回退。随后调用 CocoSpec 评分器(后台 Haiku 子智能体,只读),对合并文档在价值、范围、验收、边界、风险五个维度各 0–2 分、满分 10 分评分,写入 lifecycle/spec-score.md。
门控结果:
- 9 分及以上 PASS,输出完成信息并提示可运行 $plan;随后运行 alignment-check,若存在冲突则按字段、值和来源文件逐项呈现并阻止子智能体启动;若带 --red-team 则在通过后运行对抗会话,仅输出摘要,不阻断。若范围不超过 3 个文件且无 EHRB 指标,会提供 Quick Mode 选项,需开发者明确确认后写入 quick_mode: true 并跳过 $plan 直接进入 $build。
- 7–8 分 CONCERNS,需针对指定维度修改后重新运行 $discuss。
- 6 分及以下 FAIL,列出低于 2 分的维度并给出具名假设(UNCERTAIN/ASSUMPTION),要求先补足缺口。
错误与边界情况
spec.md 不存在时提示先运行 $spec;开发者中途退出时保存部分 discuss.md 并标记 status: incomplete,且不对不完整文件运行评分门;评分器失败时在输出中说明,除确定性对齐冲突外不阻断;无法写入 discuss.md 时输出文件系统错误。
适用场景
适用于在 cocoplus 生命周期中承接 $spec 与 $plan 之间、需要明确固定实现决策并做规范质量评分的场景,涵盖 AI 函数、Cortex Search、语义模型和数据管道等类型。该技能明确禁止的行为包括:未运行时不阻断 $plan、未经确认自动启用 Quick Mode、在 CocoContext 已提供确定答案时仍强制回答全部问题、对不完整文件运行评分器。
限制
关于该技能的具体运行环境、依赖安装方式、可用模型清单及收费信息,资料未提供。