SuperAPI AI 工具集

collaborative_discovery

写作与研究

查看项目

更新于 10-16 03:51

技能介绍

用途

Collaborative discovery 是一个多模型发现访谈与头脑风暴技能,用于将模糊、存在歧义的产品想法转化为清晰的问题框架。它适用于产品方向不明确、功能探索、场景发现、权衡取舍探索等情形。其目标是在编写 PRD、任务计划或开始实现之前,先把问题定义清楚。它被设计为一种对话循环,而不是一次性规划器。

主要能力

该技能使用一组命名角色进行多模型协作,角色包括 synthesis_anchor(综合锚点)、adversarial_anchor(对抗锚点)、broad_context(广泛上下文)、feasibility(可行性)、user_advocate(用户代言人)。角色到具体模型的映射可在 assets/routing.toml 中编辑。

工作按配置的面板阶段顺序推进:intake(接收)、divergence(发散)、user_interview(用户访谈)、cross_critique(交叉批判)、convergence(收敛)。每个阶段都必须包含综合锚点和对抗锚点,并且该阶段列出的每个角色都必须产出真实回应后,阶段才算完成。即使某个专业角色与当前想法不相关,它仍需参与并说明为何没有实质关切。

具体步骤包括:精确捕获用户想法并改写成中性的问题陈述;识别歧义类别、用户、待办任务、约束、已知非目标以及可能缺失的决策;按顺序运行各面板阶段;只向用户询问会实质改变方向的问题,并按产品风险、用户工作流、数据、权限、用户界面、交付约束分组;重复访谈循环,直到剩余歧义被明确且可接受;运行交叉批判轮次,每个角色批判最强的选项而非最弱的选项;产出保留各选项的收敛发现简报,不抹去少数观点,将每个未解决点标记为 decision needed、assumption accepted 或 deferred。

使用方式

共享脚手架(输入、路由与可配置性、本地面板运行器与标志、原生响应助手、面板状态分类法、完成门)位于 ../_shared/collaborative-panel-runner.md,在运行任何面板阶段前需先阅读该文件。撰写阶段产物前需阅读 references/output_contract.md(审计字段、状态分类法、转录处理)。feasibility 角色在判断实现风险时可查阅 references/engineering_rules.md。

默认在 .codex_workflow/discovery 下创建以下文件(除非用户指定其他路径):discovery_brief.md、option_map.md、open_questions.md、decision_log.md、panel_summary.json。该列表也镜像在 assets/routing.toml 的 required_outputs 中,由 scripts/validate_artifacts.py 消费。

质量要求

最终简报必须能直接作为 specification 技能的输入,用户无需重复提供上下文。它必须包含:问题、目标用户、价值主张、约束、非目标、场景、关键权衡、已接受的假设、被拒绝的选项、风险以及建议的下一步。

限制

该技能不编写生产代码,也不创建实现任务。如果出现实现细节,只能作为可行性说明保留。

该技能的官方介绍、收费与价格信息、适用平台等未在资料中提供。