用途:/visual-answer 把一个具体的代码或产品问题,转成已发布的 Agent-Native Plan 产物,适合需要可视化、可检查答案的问题,而非聊天段落,例如 API 契约、schema/数据模型、UI 状态、组件行为、架构流程和代码证据。
适用问题:用户问“这个的 API 规格是什么”“这个 UI 长什么样”“x 的 schema 模型是什么”“画出这条代码路径的流程”“展示这个组件/API/数据模型当前形态”等。历史类问题(改了什么、发了什么)应先用 search-pr-recaps 搜索已合并 PR 摘要,再用 show-visual-plan 把命中项拉进对话;需要完整 bundle/MDX 去编辑时才用 get-visual-plan。
工作流:先检查真实来源(宿主 agent 的仓库工具、Plan 本地 bridge,或 GitHub/源码链接),不要臆造端点、schema 字段、UI 状态、文件名或行为。编写前调用 get-plan-blocks 使用实时注册表而非记忆;若问有哪些组件可用,调用 list-plan-components。选择证据块:API 形状用 openapi-spec 加 api-endpoint,仅比较历史变更时才用 before/after;UI 外观用 wireframe 或 columns before/after;schema/数据模型用 data-model,可选 diagram;代码证据用 file-tree、tabs、annotated-code,必要时加 diff。用 Plan visual-answer 动作发布,包含用户问题、已知的 repoPath/sourceUrl、简明标题/brief 和 mdx 下的 MDX 源码。
在 Agent-Native 聊天中发布后的答案会自动内联渲染,块出现在对话里;添加一行证据摘要加深度链接,不要把原始 MDX 或块源码当文本粘贴。在无法渲染块的终端或外部 MCP 宿主,返回 URL。
终端交接:在终端或编码 agent shell 中运行时,写 visual-answer-source.json,再由以下命令发布:agent-native plan visual-answer publish --question "What is the billing API shape?" --source visual-answer-source.json --repo owner/repo。可用 --source-url 传 GitHub 文件/PR/commit/issue URL,--prev-plan-id 刷新已有答案,--visibility private 仅所有者可见。命令会写出 visual-answer-url.txt。
限制与禁止:不要用 visual-answer 做普通实现计划(用 visual-plan),不要用于 PR diff 摘要(用 visual-recap),不要跳过代码检查仅凭名称推断,不要发布截图、密钥、疑似凭据值或超出用户可视化要求的私有源码片段。相关技能:visual-plan、visual-recap、delegate-to-agent、context-awareness。