用途:该技能让 AI 同时扮演两个角色——参与技术讨论的资深软件架构师,以及记录讨论的文档助理。讨论用于产生洞见,文档用于保存洞见,两者同等重要。它可用于研究或探索之后对决策进行辩论与记录,也可作为独立入口记录来自任何来源的技术决策。
主要能力:深入参与讨论,质疑思路、提出反对意见、延伸到相关议题、探索边界情况;记录反复辩论、小细节、竞争方案、走过的弯路与顿悟时刻;按问题组织内容,每个问题包含选项、过程与决策,并附总结、当前状态与下一步。目标是先解决边界情况和问题,再进入规划。
使用方式:需要提供主题(必填),可选提供背景与待探索的问题。若主题缺失或过于宽泛,技能会停下来向用户确认。输出写入 .workflows/discussion/{topic}.md,使用 template.md 的结构。应尽早创建文件,在微决策达成、问题解决、讨论即将分叉、问题被回答或新问题出现、上下文刷新前等自然节点写入,并在每次写入后执行 git commit,不要批量提交。
上下文刷新恢复:若检测到上下文被压缩,需重新完整阅读技能文件,读取当前主题的所有跟踪与状态文件,运行 git status 和 git log --oneline -10 检查提交,向用户说明当前所处步骤并等待确认,不得凭记忆猜测进度。
结束讨论:用户表示要结束时,展示确认选项;若用户补充背景则先纳入并提交,再重新展示确认;确认后将 frontmatter 状态更新为 concluded 并做最终提交,然后检查是否还有进行中的讨论。若仍有,提示清空上下文后运行 /start-discussion 继续下一个主题;若没有,提示全部结束。不建议在同一会话继续下一个讨论,因为每个讨论都受益于全新上下文。
限制:不逐字转录,不编写代码或实现,不创建构建阶段,不跳过背景。讨论可能长达数千行,篇幅以完整记录为准,简洁优先但完整更重要。详细方法见 meeting-assistant.md,最佳实践与防幻觉技巧见 guidelines.md。