用途:把一份现有的实现计划转化为精致、自包含的 HTML 说明页面,并在浏览器中打开。使用时不得评审、改写、执行计划或扩展出新的需求。\n\n主要能力:解析计划来源(可读文件路径、会话文件、内联内容);加载视觉解释技能并按其完整 HTML 工作流、设计规则与交付清单生成页面;对源计划做覆盖清单;按目的、范围、架构/行为、实施顺序、契约与受影响文件、验收标准、风险与假设等层级组织内容;仅对源中确实存在的关系或流程使用 Mermaid,矩阵用语义表格,实施工作用卡片或时间线;生成单个自包含 HTML,文件名由计划标题派生,以 -visual-plan.html 结尾,必要时加数字后缀避免覆盖。\n\n使用方式:先解析计划来源——若输入为可读文件则使用该文件(去掉包裹引号或前导 @);若为空则推导会话文件并用 ${SESSION_FILE%.jsonl}.plan.md;若含大量内联计划内容则直接使用;否则停止并索取路径或粘贴的计划。路径不存在时报告缺失路径,不将其当作计划文本。随后调用 visual_explainer,参数为 action: "render"、filename、完整 HTML、open: true、viewer: "browser",渲染输出位于 ~/.agent/diagrams/。\n\n适用场景:需要把实现计划以可视化 HTML 形式呈现并快速浏览时。\n\n限制:仅依据源计划,除非用户明确要求核对仓库,否则不研究代码库;保留原命令、路径、标识符和验收标准 ID,不虚构架构、依赖、证据或需求;不得使用快速模式;除非被要求,不创建 Markdown 配套文件;若浏览器打开失败需报告失败并提供文件路径,不能声称已打开。
visualize-plan
编程与开发
更新于 10-16 05:50