clarify

用途

clarify 用于完善已存在的功能规格文件 spec.md。当 spec.md 中存在歧义——如角色描述模糊、验收场景不可测试、边界情况表述笼统、功能需求缺少可衡量指标等——该技能通过针对性的澄清对话逐段消除歧义。

主要能力

• 读取并解析当前 spec.md 内容，按文档模板识别有内容的段落。
• 逐段扫描歧义，覆盖主用户故事、验收场景、边界情况、功能需求、UX 需求、关键实体、技术上下文等模板段落。
• 每段生成编号问题（最多 5 个），问题设计为可用多选或简短值回答，并一次性呈现该段全部问题。
• 收到回答后使用顺序思考方法分析段落一致性与完整性，再展示修改前后对比，等待用户确认。
• 以原子方式将澄清结果写回 spec.md，保留格式与结构。
• 全部段落处理后进行跨段一致性校验，并输出最终报告。

使用方式

输入为功能路径（如 ai-docs/features/cv-upload）；若为空，则询问用户要澄清哪个功能。技能会定位 [feature-path]/spec.md，若文件不存在则提示先运行 /feature。处理前需先读取 doc-templates 技能中的 references/spec-template.md。

适用场景

适用于已经写好 spec.md、但其中仍存在需要与用户确认才能明确的需求细节时。

限制

• 绝不猜测或使用默认值，遇到歧义必须询问并等待用户实际回答。
• 只在现有模板段落内修改，不新增段落或类别，不删除内容而不替换。
• 每段最多 5 个澄清问题。
• 需依赖 doc-templates 模板与 sequential-thinking MCP 工具。