用途：didyouknow-v2 是一个通用清晰度构建工具，可分析规格、计划、任务、子任务或代码等任意上下文，通过自然对话逐条呈现关键“Did you know?”洞察，帮助人与 AI 建立对现有内容的共同理解。默认模式关注风险、陷阱、隐藏假设和非显而易见的含义；增强模式（--enhance）则针对现有功能提出范围内的改进想法，不涉及无关或超范围内容。
主要能力：启动时解析参数决定分析对象（spec/plan/tasks/subtask/code），未指定时自动在 docs/plans/ 中查找最近文档；读取主文档及关联文档，如分析 plan 时同时读 spec，分析 tasks 时读 plan 和 spec；若存在 docs/domains/registry.md 或 domain-map.md，会进行领域感知分析。默认模式固定输出 5 条洞察；增强模式默认为 5 条，可用数字自定义数量。每条洞察按“#N: 标题、Did you know…、This matters because…、Recommendation…、What do you think?”格式呈现。
使用方式：命令支持如下形式：/didyouknow --spec <path>、/didyouknow --plan <path>、/didyouknow --tasks <path>、/didyouknow --subtask <path>、/didyouknow --code <path>、/didyouknow（自动检测最近上下文）、/didyouknow --enhance、/didyouknow --enhance 3、/didyouknow --enhance --spec <path>。
关键限制：每条消息只能呈现一条洞察，之后必须停止并等待人类回复，禁止一次输出多条。首次呈现每条洞察仅 3-5 行，不前置深度分析、选项矩阵或示例，仅在人类要求时展开。决策后立即更新相关文档，不推迟到末尾。增强模式必须严格限定在当前功能范围内，不得建议无关或超范围功能。领域洞察并非强制，当领域无问题时可不进入前 5 条。其余集成信息暂未提供。