用途
insights 用于收集来自 UI/UX 审查、文档调研、外部参考等来源的改进建议，经用户确认后转化为开发需求。它不适合直接加功能（应使用 /feature）或修 Bug（应使用 /bugfix），普通资料研究也不使用此流程。
主要能力
- 识别洞察来源：UI/UX 审查、文档调研、外部参考、内部反馈。
- 收集并结构化建议列表，分类整理、评估影响范围、建议优先级。
- 通过 AskUserQuestion 进行交互式确认，支持单条确认、批量确认、调整优先级。
- 将确认的建议转化为需求，生成功能点（F-XXX）和验收标准（AC-XXX），追加到 01-requirements.md。
- 按类别分流建议：决策类进入 02-system-design.md 的 ADR 记录，经验类沉淀到 docs/devdocs/patterns/，需求类进入 01-requirements.md，一次性观察丢弃。
- 维护洞察变更日志 docs/devdocs/05-insights.md，记录 INS 编号、来源、确认时间和转化目标。
- 支持 --url 从 URL 提取建议、--file 从文件提取、--realign 规范升级回扫。
使用方式
最常见用法：/insights（描述改进来源和建议）。
命令选项：
- /insights：标准模式，交互式收集和确认。
- /insights --url <url>：从 URL 提取建议。
- /insights --file <path>：从文件提取（如审查报告）。
- /insights --realign：规范升级回扫，对 05-insights.md 按当前 ins.v1 扫描结构差距，补齐模板缺字段，不新增 INS。
确认建议并转化为需求后，根据改进复杂度选择路径：无架构变更（如 UI 微调、配置修改、小功能）走 /dev-tasks 直接拆分任务；有架构变更（如新接口、数据模型变更、新模块、第三方服务集成）走 /system-design。
适用场景
- 用户完成 UI/UX 审查，有优化建议。
- 用户调研了文档/方案，发现可借鉴点。
- 用户发现外部参考（竞品、最佳实践）可借鉴。
- 用户有改进想法需要转化为需求。
限制
- 建议必须经过用户确认才能转化为需求。
- 拒绝的建议必须记录原因。
- 批量确认前必须展示完整列表。
- 转化后的需求必须可追溯到原始建议。
- 必须生成可验证的验收标准。
- 优化类需求必须标记 [优化] 标签。
- 外部参考必须提供来源链接。
- 四类分流中只有「需求」进 01-requirements.md；分流用 AskUserQuestion 问一次，不自行判定。
- 05-insights.md 降级为变更日志，仅记录 INS 编号、来源、确认时间和转化目标，不重复需求内容。
- 语言规则：支持中英文提问，统一中文回复，使用中文生成文档。
输出文件
- docs/devdocs/01-requirements.md：需求追加（唯一源）。
- docs/devdocs/05-insights.md：洞察变更日志，需包含 frontmatter（generated_by: insights, spec_version: ins.v1, generated_at）。
Skill 协作
- UI/UX 审查来源：/ui-orchestrator。
- 需求转化：/requirements。
- 设计变更：/system-design。
- 测试补充：/test-cases。
- 简单改进：/dev-tasks。
- 复杂改进：/system-design。
- Bug 类建议：/bugfix。
- 需求更新：/sync。