workflows-brainstorm

workflows-brainstorm

用于在实现前澄清做什么，而不是直接进入编码。

这是 Codex 中的 brainstorm 主入口。它不尝试复刻 Claude Code 的完整运行时，而是用明确状态机保留高价值能力：

• [P] 触发 3 个核心视角的多轮讨论，并模拟 party-mode 的 emoji + 角色名 + 相互质疑体验
• [P+] 触发 8-12 个视角的深度发散和挑战收敛
• [R] 强制历史经验检索；未传 [R] 时，Standard/Deep 场景自动做历史检索
• 每轮都纳入胶水编程：复用机会、胶水代码边界、必须自研的部分
• 每轮后等待用户选择继续、换视角或收敛
• 写出带 P1-P4 优先级和 Reuse / Build Boundary 的 brainstorm 文档

不要调用 Codex CLI。 不要调用 Gemini CLI。

目标

通过协作对话、轻量仓库研究、历史经验检索和方案比较，产出一份可继续规划的 brainstorm 文档：

docs/brainstorms/YYYY-MM-DD-<topic>-brainstorm.md

输入

• 功能想法
• 问题描述
• 改进方向
• 可选参数：
  • [P]：3 个核心视角，适合普通复杂度
  • [P+]：8-12 个视角，适合模糊、高风险或架构性问题
  • [R]：强制检索 docs/solutions/ 历史经验

如果用户没有给出清晰主题，先追问，不要直接写文档。

如果用户传入旧的外部 AI 咨询标记，只说明本 Codex brainstorm 入口不处理外部 AI 咨询，清洗掉该标记后继续主流程。

参数解析

开始时先解析参数，并向用户回显：

• PARTY_MODE = none|quick|deep
• HISTORICAL_RESEARCH = auto|force|skip
• 清洗后的功能描述

规则：

• 包含 [P+] -> PARTY_MODE = deep
• 包含 [P] -> PARTY_MODE = quick
• 包含 [R] -> HISTORICAL_RESEARCH = force
• 未包含 [R] 时，先按 Phase 0 判断范围；Standard/Deep 软件或仓库改动场景使用 HISTORICAL_RESEARCH = auto
• Lightweight 且无历史相关信号时可设为 skip
• 解析后从功能描述中移除所有参数标记
• 如果检测到用户把一长段对话历史、系统标签或工具输出粘进参数里，要先让用户重新给出一句简洁描述

Phase 0: 范围判断

先判断是否真的需要 brainstorm：

• Lightweight：目标清楚、范围小、低风险；可以短讨论后直接写简短文档或建议进入 $workflows-plan
• Standard：正常功能、流程、体验或工具改进；需要完整覆盖矩阵
• Deep：跨模块、架构、工作流、运行时适配、高风险或需求模糊；建议自动提升到 [P+] 级别，即使用户只传 [P]

如果需求已经非常清晰，不要硬拖长讨论；但仍要确认是否需要持久化 brainstorm 文档。

Phase 1: 本地上下文与历史检索

1.1 仓库上下文

先做轻量研究，了解：

• 是否已有相近实现
• 项目里是否已有类似模式
• 是否有现成约束或历史决策
• 本次改动可能影响哪些文档协议或工作流入口

如果 $repo-research-analyst 可用，优先使用它。 如果不可用，直接用本地搜索完成同等最小研究：rg 查主题关键词、相关 skill、相关 docs、相关 tests。

1.2 历史经验检索

[R] 的含义是：强制查历史经验。它不是联网搜索，也不是外部 AI 咨询。

历史检索来源：

• docs/solutions/
• docs/brainstorms/
• docs/plans/

执行规则：

• HISTORICAL_RESEARCH = force：必须检索
• HISTORICAL_RESEARCH = auto：Standard/Deep 场景自动检索
• HISTORICAL_RESEARCH = skip：只在 Lightweight 或明显无历史价值时跳过

如果 $learnings-researcher 可用，自动运行 $learnings-researcher。 如果不可用，用 rg 搜索 docs/solutions/ 和相关文档，提炼 3-5 条历史约束、坑点或可复用经验。