SuperAPI AI 工具集

plan-viz

编程与开发

查看项目

更新于 10-16 02:03

技能介绍

Plan Visualization(plan-viz)用于在实施前将计划变更渲染为结构化的 ASCII 可视化,并配合风险分析、执行顺序与影响指标。其核心原则是:把判断编码进可视化,而不是装饰。

用途与触发场景 它适用于评审计划、对比变更前后的架构、评估风险,或分析执行顺序等场景。典型命令形式包括:

/ork:plan-viz # 从当前分支自动检测 /ork:plan-viz billing module redesign # 描述计划 /ork:plan-viz #234 # 从 GitHub issue 拉取

参数解析规则:若参数以“#”开头,视为 GitHub issue 编号;否则视为计划描述。

工作流程

  1. 检测或澄清计划上下文:先运行 scripts/detect-plan-context.sh 自动检测,输出分支名、issue 编号(如有)、提交数量与文件变更摘要。若无法明确,则通过 AskUserQuestion 让用户选择来源:当前分支变更、文字描述计划、GitHub issue,或仅快速显示文件 diff。
  2. 采集数据:运行 scripts/analyze-impact.sh 获取精确计数(新增/修改/删除文件、行数、受影响的测试文件、依赖变更);并可用 Explore 子代理理解受影响目录的架构。
  3. 渲染 Tier 1 头部(始终显示):包含计划名称、阶段数、文件数、增删行数、风险等级、置信度、可逆到最后安全阶段、分支信息,以及可展开的分区索引。
  4. 询问要展开哪些部分:全部、变更+执行、风险+决策,或仅影响。
  5. 渲染所请求的分区。
  6. 提供后续操作:写入 designs/ 目录、从执行阶段生成 GitHub issue、深入钻取,或完成。

核心分区 [1] 变更清单:按 [A]/[M]/[D] 展示文件树及每个文件的增删行数。 [2] 执行泳道:以 === 表示活跃、--- 表示阻塞、| 表示依赖。 [3] 风险仪表盘:可逆性时间线与 3 个 pre-mortem。 [4] 决策日志:ADR-lite 格式,包含背景/决策/备选方案/权衡。 [5] 影响摘要:以表格展示新增/修改/删除/NET,以及测试、API、依赖。

深入钻取(Tier 3,按需) [6] 影响半径(Blast Radius):直接→传递→测试影响的同心环。 [7] 跨层一致性:前端/后端端点对齐与缺口检测。 [8] 迁移检查清单:带时间估算的顺序/并行运行手册。

关键原则 渐进式披露:Tier 1 头部始终显示,其他分区按请求展开。 判断优先于装饰:每个分区回答评审者的一个具体问题。 精确优于估算:用脚本获取文件/行数。 诚实面对不确定性:给出置信度、pre-mortem、权衡成本。 可执行输出:写入文件、生成 issue、深入钻取。 反注水:不做通用过渡、不造假精度、不放无用分区。

规则与参考 分区渲染规则为 HIGH 影响,覆盖 5 个核心分区的渲染约定;ASCII 图通过 ascii-visualizer 技能实现。参考文件按需加载,包括 visualization-tiers.md、change-manifest-patterns.md、execution-swimlane-patterns.md、risk-dashboard-patterns.md、decision-log-patterns.md、blast-radius-patterns.md、deep-dives.md。资源模板包括 plan-report.md、impact-dashboard.md、tier1-header.md。

相关技能 ork:implement(执行计划变更)、ork:explore(理解当前架构)、ork:assess(评估复杂度与风险)。

限制 以上内容均来自所提供的技能说明;具体安装方式、收费与价格、支持平台、实际渲染效果等信息暂未提供。